跳到正文
🧭 新手教程

sing-box 使用教程:全平台通用通用核心安装、订阅导入与 JSON 配置全指南

详细的 sing-box 使用教程。手把手指导在 Windows、macOS、Android 及 iOS 上安装 sing-box 客户端并导入节点配置与规则分流。

作者 阿 KING ·最后更新 ·评测方法
📑 本页目录(13)
  1. 准备工作:官方安装包获取与运行环境梳理
  2. 客户端安装、订阅导入与连接三步流程
  3. 进阶 JSON 路由规则解析与调优
  4. 常见疑问解答与排障指南(FAQ)
  5. sing-box 使用教程常见问题
  6. 相关阅读

准备工作:官方安装包获取与运行环境梳理

本节说明获取官方开源 sing-box 客户端的正规途径与各端版本要求。

sing-box 正在迅速成长为跨平台通用代理生态的底层行业标杆。在下载时请务必认准 SagerNet 官方开源仓库,坚决抵制任何第三方加料安装包:

操作系统平台 推荐获取渠道 核心架构与版本特性
iOS / iPadOS 外区 App Store 搜索直接免费下载 完全免费,原生集成系统 Network Extension
Android 手机 Google Play 商店或 GitHub 官方 APK 原生 Material You 现代设计,支持独立分应用代理
Windows 电脑 官方 GitHub Releases 编译安装包 支持一键开启独立系统级 TUN 虚拟网卡
macOS 苹果电脑 官方 Release DMG 安装包 原生适配 Apple Silicon M 系列与 Intel 处理器

从官方 GitHub Releases 或本站 下载页 获取软件。在配置前,建议先在 梯子推荐 首页挑选支持现代化协议的高规格专线服务商。

客户端安装、订阅导入与连接三步流程

本节分步演示如何快速完成 sing-box 客户端的安装、订阅拉取及建立首次加密连接。

sing-box 官方图形客户端目前已高度完善,操作非常直观:

第 1 步:安装并打开应用

  1. 在对应平台完成官方软件的安装并启动;
  2. 软件主界面极其干净精炼,顶部展示运行状态与核心开关;
  3. 初次运行时软件会自动初始化默认环境。

第 2 步:导入服务商订阅配置

  1. 在服务商用户中心复制你的专属订阅链接(支持专用 sing-box 订阅或通用聚合链接,详情可参考 订阅链接导入教程);
  2. 进入客户端的 Profiles(配置) 页面;
  3. 点击右上角的 +(添加 / New Profile) 按钮;
  4. 选择“Remote / URL 模式”,在 URL 栏粘贴刚复制的订阅地址,填入名称并点击 Create 保存;
  5. 软件会自动向远端拉取 JSON 节点配置文件并缓存在本地。

第 3 步:节点挑选与启动服务

  1. 回到主界面,在 Dashboard 中点击展开节点分组列表;
  2. 点击测速按钮,批量检测各个节点的响应延迟;
  3. 手动点选延迟适中的低倍率专线节点(如香港或日本 1.0x 节点);
  4. 点击主界面的 Start(启动) 大开关;
  5. 系统弹出 VPN 权限授权窗口时点击“允许”,开关变为绿色高亮即代表网络已正式连通!
核心控制项 推荐设定值 关键技术收益
工作模式 Rule (规则模式) 智能识别国内外流量,国内直连不减速,境外走代理
TUN 模式 保持默认开启 系统级虚拟网卡无感全接管,彻底解决软件绕行问题
自动更新 建议开启 每天定时同步最新节点列表,防止服务器维护断连
DNS 劫持 保持默认开启 本地加密闭环解析,杜绝 DNS 泄露与运营商劫持

若需比较各品牌针对 sing-box 现代内核的适配表现,可前往 梯子对比 页面深入查阅。

进阶 JSON 路由规则解析与调优

本节为进阶玩家解析 sing-box 底层路由规则的工作机制与优化方案。

sing-box 的核心分流由 JSON 配置文件中的 route.rules 驱动,逻辑极其清晰高效:

规则匹配类型 典型 JSON 结构示例 技术效果与业务映射
国内直连规则 {"geosite": ["cn"], "outbound": "direct"} 所有国内知名互联网域名一律走本地直连,不绕道
私有 IP 直连 {"geoip": ["private"], "outbound": "direct"} 局域网内网 IP(如路由器管理页)强制直连,不报错
特定业务分流 {"geosite": ["openai"], "outbound": "ai-nodes"} 将 ChatGPT 请求精准分流至指定的新加坡或美国节点
兜底拦截规则 {"geosite": ["category-ads-all"], "outbound": "block"} 本地直接拦截常见广告与恶意追踪脚本,净化网络

常见疑问解答与排障指南(FAQ)

本节针对使用 sing-box 过程中最常遇到的 4 个疑难问题进行专业解答。

1. 软件报错提示“parse config error: unknown field”怎么解决?

这代表导入的配置文件中存在当前 sing-box 版本不识别的废弃字段或语法错误。通常是因为客户端版本过旧,未能跟上最新的协议规范。请前往官方 GitHub 将 sing-box 升级至最新稳定版重新导入即可解决。

2. 为什么部分旧机场的节点导入后全部报错?

部分极其老旧的技术小作坊依然采用过时的 Shadowsocks-R 或不规范的私有混淆协议,而 sing-box 遵循现代严格的密码学标准,不支持任何已被攻破的不安全老旧协议。建议选用合规标准协议的专线机场。

3. sing-box 在手机端日常挂机耗电量大吗?

sing-box 采用了极致优化的 Go 内存管理模型和零内存拷贝技术,在日常后台挂机且仅进行文字通讯时,后台 CPU 占用率趋近于 0%,是目前全网公认最省电、最冷静的移动端代理内核之一。

4. 换了新设备如何快速迁移?

只需在新设备上重新下载 sing-box 并粘贴原有的订阅链接即可恢复全部节点。如果需要挑选高带宽、全天候稳定的优质线路,可在 便宜梯子推荐 挑选兼具稳定与性价比的优秀品牌。

sing-box 使用教程常见问题

下面的问题默认全部展开,方便直接查看答案。

Qsing-box 相比传统 Clash 和 Xray 有什么技术优势?
sing-box 是下一代开源通用代理通用平台,最大的特点是**性能极其强悍、内存占用极低、底层协议支持最纯粹**;它由 Go 语言精心重构,对 VLESS-Reality、Hysteria2、TUIC 等新协议的实现效率远高于传统老旧客户端。
QiOS 用户怎么下载正版 sing-box 客户端?
sing-box 官方正版应用已上架外区 App Store(包括美区、日区等)。iOS 用户按照 [美区 Apple ID 注册教程](/jiaocheng/meiqu-apple-id-zhuce/) 登录外区账号,直接在 App Store 免费搜索“sing-box”即可下载使用,完全免费。
Q为什么说普通新手更建议使用封装好的图形客户端?
原生的 sing-box 采用纯 JSON 语法编写配置,结构极其严密但手动修改门槛较高;对于新手而言,使用基于 sing-box 封装的友好图形界面(如 Hiddify、Karing 或自带图形面板的官方 GUI)上手体验会顺畅得多。
Q连接后无法上网怎么排查?
首先检查 JSON 配置中的规则路由是否包含了 direct 与 bypass 规则;其次在系统网络连接中确认 sing-box 虚拟网卡是否成功获得 IP;若依然报错,可参考 [梯子连不上怎么办](/jiaocheng/tizi-lian-bu-shang/) 检查日志。

还在犹豫?新手直接选 sogo云

IPLC 专线,全节点 1x 倍率,晚高峰不降速,AI 与流媒体全解锁。支持支付宝、微信、USDT 付款。