GATE登机口

使用教程

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-boxClash 系(mihomo)
配置格式JSONYAML
订阅是否通用只认 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 相关的选项,说明这家机场没有直接支持,不要把别的格式的链接填进来。订阅格式的区别见 订阅链接是什么。

第二步:新建远程配置

  1. 打开客户端,进入配置文件页面,点击新建。
  2. 名称随意填写,例如机场的名字。
  3. 类型选择「远程」。
  4. 在地址栏粘贴 sing-box 订阅链接。
  5. 打开自动更新,更新间隔按默认或设为一天左右。
  6. 点击创建,客户端会立即下载一次配置。

如果机场后台提供了一键导入按钮,点击后会直接唤起客户端并自动填好这些内容,确认即可。

第三步:启动

  1. 回到首页(仪表盘),在配置列表里选中刚才创建的配置。
  2. 点击启动按钮。第一次启动时,系统会请求添加 VPN 配置的权限,同意并完成验证。
  3. 启动成功后,首页会显示运行状态、内存占用、连接数和实时流量等信息,状态栏出现 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。

本站主推:星岛梦 2020 年开业的老牌机场,12 个地区、套餐形式多。主打「超量 150G」¥25/月 / 150GB,年付小包 ¥96(折合 ¥8/月),资料分 9.5(第 1),优惠码 nmw888(新人注册 9 折)。

去星岛梦官网星岛梦完整评测