使用教程
sing-box 使用教程(2026):Windows、macOS、安卓、iOS 下载安装与订阅导入
sing-box 使用教程:它和 Clash 有什么不同、各平台分别用哪个客户端、怎样添加远程配置(订阅)并启动、如何切换节点和设置自动更新,以及配置格式不对、启动报错、版本不兼容等常见问题的处理办法。
sing-box 使用教程:先说结论
sing-box 是一个较新的开源代理内核,官方为安卓、iOS、macOS 提供了图形客户端,三端的界面和逻辑几乎一样:新建一个远程配置(填入 sing-box 订阅地址)→ 在首页选中它并启动 → 在分组页面切换节点。它用起来不难,前提只有一个——机场要提供 sing-box 格式的订阅。它不认 Clash 订阅,也不认通用订阅,这是新手最常踩的坑。机场不支持的话,用 Clash Verge Rev 之类的客户端更省事。
sing-box 是什么,和 Clash 有什么不同
代理客户端通常分两层:负责实际收发流量的「内核」,和给人操作的「图形界面」。sing-box 首先是一个内核,和 Clash 系的 mihomo、v2rayN 常用的 Xray 是同一类东西。它的官方图形客户端只是在内核外面包了一层很薄的界面:管理配置文件、启动停止、切换节点、看日志。
| 对比项 | sing-box | Clash 系(mihomo) |
|---|---|---|
| 配置格式 | JSON | YAML |
| 订阅是否通用 | 只认 sing-box 格式 | 只认 Clash 格式 |
| 策略组 | 有,对应手动选择和自动测速等出站类型 | 有,种类更多 |
| 规则分流 | 支持,使用规则集 | 支持,使用规则与规则集 |
| 机场支持程度 | 部分机场提供 | 几乎都提供 |
| 图形客户端 | 官方客户端功能精简 | 第三方客户端丰富 |
| 配置写法的稳定性 | 版本间变动较多,旧配置可能需要更新 | 相对稳定 |
选 sing-box 的常见理由是:想用它支持得更好的某些新协议;手机上想要一个免费、开源、没有多余功能的客户端;或者单纯喜欢它的配置方式。常见协议的通俗介绍见 代理协议入门。对普通用户而言,两种内核在日常体验上的差异远小于机场线路本身的差异。
各平台用哪个客户端
| 平台 | 客户端 | 获取方式 | 说明 |
|---|---|---|---|
| 安卓 | 官方安卓客户端(常称 SFA) | 官方 GitHub Releases 页面,或官方文档列出的应用商店 | 免费 |
| iPhone、iPad | 官方 iOS 客户端(常称 SFI) | 非国区 App Store,名称与上架情况以官方文档为准 | 免费,需要外区 Apple ID |
| macOS | 官方 macOS 客户端(常称 SFM) | 官方文档给出的渠道 | 界面与 iOS 版一致 |
| Windows | 以 sing-box 为内核的第三方图形客户端 | 各项目的官方发布页 | 官方主要提供命令行程序 |
获取时的注意事项:
- 安卓安装包选
arm64-v8a版本,拿不准选通用包。安装方法和未知来源授权见 安卓机场使用教程。 - 苹果设备需要非国区 Apple ID,注意事项和安全提醒见 iPhone 机场使用教程。应用商店里名字相近的应用不少,以官方文档指向的那个为准。
- Windows 上,v2rayN 可以把内核切换为 sing-box,并用它实现 TUN 模式,是比较省心的选择;其他第三方图形客户端各有各的界面,按其官方说明使用。
添加配置并启动(安卓、iOS、macOS 通用)
官方客户端把订阅叫作「配置文件」(Profile),分为本地和远程两种。机场订阅属于远程配置。
第一步:拿到 sing-box 订阅地址
登录机场后台,在订阅页面找到标注为 sing-box 的订阅链接或一键导入按钮。如果后台没有 sing-box 相关的选项,说明这家机场没有直接支持,不要把别的格式的链接填进来。订阅格式的区别见 订阅链接是什么。
第二步:新建远程配置
- 打开客户端,进入配置文件页面,点击新建。
- 名称随意填写,例如机场的名字。
- 类型选择「远程」。
- 在地址栏粘贴 sing-box 订阅链接。
- 打开自动更新,更新间隔按默认或设为一天左右。
- 点击创建,客户端会立即下载一次配置。
如果机场后台提供了一键导入按钮,点击后会直接唤起客户端并自动填好这些内容,确认即可。
第三步:启动
- 回到首页(仪表盘),在配置列表里选中刚才创建的配置。
- 点击启动按钮。第一次启动时,系统会请求添加 VPN 配置的权限,同意并完成验证。
- 启动成功后,首页会显示运行状态、内存占用、连接数和实时流量等信息,状态栏出现 VPN 图标。
macOS 版首次启动还会要求安装系统扩展或授权网络扩展,按系统提示在设置里允许。Mac 上遇到应用被拦截无法打开的处理方法,见 macOS 机场使用教程。
切换节点与出站模式
启动之后,客户端里会多出一个分组页面,里面列出配置中定义的各个策略组:
- 手动选择组:展开后点选想用的节点,立即生效。
- 自动测速组:内核按延迟自动挑选,你只能查看当前选中了谁,可以点测速按钮手动触发一次测试。
分组页面只在服务运行时才有内容,没启动时是空的,这是正常的。组的名字和数量完全由机场的配置决定,常见结构是一个总的手动选择组,加上若干按地区或用途划分的组。节点怎么挑、自动测速和手动选择怎么取舍,见 怎么选节点和切换节点。
如果机场的配置里定义了多种出站模式(例如规则与全局),首页会出现模式切换的选项;没有定义就不会显示。日常保持规则分流即可。手机端的 sing-box 接管的是整机流量,相当于电脑上的 TUN 模式,概念解释见 系统代理与 TUN 模式。
安卓版在设置里提供分应用代理功能,可以指定只有某些应用走代理,或让某些应用绕过。修改后需要停止并重新启动服务才会生效。
更新配置与客户端
更新配置
在配置文件页面,点开某个配置可以手动更新,也可以修改自动更新间隔。需要注意:配置更新之后,正在运行的服务不一定立刻使用新内容,稳妥的做法是更新后停止再启动一次。节点大面积失效时,先手动更新配置。
更新客户端
sing-box 的配置写法随版本演进变化较多:新版本内核可能废弃旧字段,旧版本内核又不认识新字段。因此会出现「客户端升级后原来的配置报错」或「机场更新模板后旧客户端报错」两种情况。原则是客户端和机场订阅都保持较新的状态,并优先使用正式版而非测试版。
多个配置
可以同时保存多家机场的配置,在首页切换选中项后重新启动即可。备用机场的思路见 备用机场场景。
常见问题与处理
| 现象 | 常见原因 | 处理办法 |
|---|---|---|
| 启动时提示配置解析失败 | 填入的不是 sing-box 格式的订阅 | 回后台复制 sing-box 专用订阅 |
| 启动时提示某字段已废弃或不被支持 | 配置写法与内核版本不匹配 | 更新配置和客户端;仍报错则反馈给机场 |
| 创建远程配置时下载失败 | 订阅地址在当前网络下不可达 | 换网络重试,或查看机场是否有备用订阅地址,见 订阅更新失败 |
| 已启动但打不开网页 | 选中的节点不可用,或与系统的私人 DNS 设置冲突 | 在分组页面换节点;把系统的私人 DNS 设为自动,原理见 DNS 设置 |
| 分组页面是空的 | 服务没有启动,或配置里没有定义策略组 | 先启动;没有策略组的配置只能使用固定出口 |
| 用一会儿就断开(安卓) | 被系统省电策略清理 | 把电池策略设为不受限制并锁定后台 |
| 与其他代理应用无法同时使用 | 系统同一时间只允许一个 VPN 类应用生效 | 只保留一个处于连接状态 |
遇到报错时,日志页面是最有用的信息来源:错误信息通常会直接写明是哪一行、哪个字段有问题。向机场客服求助时把这段文字发过去(注意不要带上订阅链接),比只说「打不开」有效得多。其他连接问题按 机场连不上怎么办排查。
什么情况下不建议用 sing-box
- 机场没有提供 sing-box 订阅:自己转换配置要么依赖第三方转换服务(有订阅泄露风险),要么需要读懂配置文档,对新手不划算。
- 希望在图形界面里改规则、看每条连接的详情:官方客户端功能刻意保持精简,这类需求用 Clash Verge Rev、Stash 等更合适。
- 不想关心版本兼容:sing-box 迭代较快,偶尔需要跟着升级。
反过来,如果你选的机场把 sing-box 列为主要支持的客户端之一,那就放心用,体验与其他客户端并无本质差别。各家机场支持的客户端以其官方标注为准,可以在 机场推荐清单和对应评测页里查看。使用时请遵守所在地法律法规与各服务的用户协议。
所属专题:v2rayN 使用教程。同专题还有:v2rayNG 使用教程、NekoBox 使用教程、Hiddify 使用教程、Linux 用机场教程。
常见问题
sing-box 怎么用?
sing-box 是一个较新的开源代理内核,官方为安卓、iOS、macOS 提供了图形客户端,三端的界面和逻辑几乎一样:新建一个远程配置(填入 sing-box 订阅地址)→ 在首页选中它并启动 → 在分组页面切换节点。它用起来不难,前提只有一个——机场要提供 sing-box 格式的订阅。
sing-box 和 Clash 有什么区别?
两者都是代理内核,功能定位相近,都支持规则分流和策略组,但配置格式完全不同:Clash 系使用 YAML 配置,sing-box 使用自己的 JSON 配置,互不通用。sing-box 较新,协议支持广;Clash 系生态更成熟,机场支持更普遍。
sing-box 可以直接导入 Clash 订阅吗?
不可以。sing-box 官方客户端只读取 sing-box 格式的配置,把 Clash 订阅或通用订阅地址填进去会在启动时报配置解析错误。需要使用机场后台提供的 sing-box 专用订阅;机场没有提供时,更省事的做法是改用 Clash 系客户端。
sing-box 有 Windows 图形客户端吗?
官方为安卓、iOS 和 macOS 提供图形客户端,Windows 上官方主要提供命令行程序。想用图形界面,可以选以 sing-box 为内核的第三方客户端,例如 v2rayN 支持切换到该内核,见 v2rayN 教程。
sing-box 启动时报错怎么办?
绝大多数启动报错来自配置文件:要么格式不是 sing-box 的,要么配置的写法与客户端内核版本不匹配。先更新一次配置,再把客户端升级到最新正式版;仍然报错就把错误信息里提到的字段反馈给机场,由机场更新订阅模板。
新手适合用 sing-box 吗?
如果机场后台明确提供 sing-box 订阅和一键导入,新手也能顺利使用,日常操作并不复杂。但如果机场不直接支持,需要自己转换或手写配置,门槛就比较高了,这种情况建议先用 Clash 系客户端或 Shadowrocket。