sing-box 教程入门:与 Clash 的区别、订阅格式要求和图形客户端
sing-box 是什么
sing-box 自称「通用代理平台」,用 Go 语言编写,可以运行在 Windows、macOS、Linux、Android 和 iOS 上。它做的事和其他代理内核一样:在本机接收流量,按规则决定直连还是转发到某个节点,再用对应的协议把流量发出去。
需要分清两层东西:
- 内核: 一个没有界面的程序,读取一份配置文件后在后台工作。sing-box、mihomo、Xray 都属于这一层;
- 图形客户端: 给内核套上界面,负责下载订阅、切换节点、开关代理。你平时点来点去的是这一层。
所以「用 sing-box」通常不是指对着命令行敲命令,而是用一个以 sing-box 为内核的图形客户端。
sing-box 和 Clash 系的区别
| 对比项 | sing-box | Clash 系(mihomo 内核) |
|---|---|---|
| 配置格式 | JSON | YAML |
| 节点的叫法 | 出站(outbounds) | 代理(proxies) |
| 节点分组 | selector(手动选)、urltest(自动测速选) | select、url-test、fallback、load-balance |
| 规则写法 | route 段里的规则对象,可引用规则集 | rules 列表,一行一条 |
| 订阅机制 | 客户端拉取一份完整的远程配置 | 完整配置,另支持节点集合(proxy-providers) |
| 机场支持度 | 部分机场提供 | 绝大多数机场提供 |
几点说明:
- 两者覆盖的协议大体重合。 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC 这些主流协议两边都支持,协议本身的差别见机场协议对比。个别较新的协议哪边先支持、从哪个版本开始支持并不固定,以各自的官方文档为准;
- 配置思路不同。 Clash 的配置更像一张清单,容易读也容易手改;sing-box 的配置层级更细,入站、出站、路由、DNS 各占一段,写起来更啰嗦,但每一段的行为都交代得很明确;
- 格式变动。 sing-box 的配置字段随版本演进有过调整,旧字段会被标记为弃用并在之后移除。这意味着一份老配置放到新内核上可能直接报错,这是新手最常遇到的坑。
哪个更快、更省电,没有一个对所有人都成立的答案,本站也没有做过测试,不下结论。实际体验里,节点线路的影响远大于内核。
一份 sing-box 配置长什么样
不需要会写,但认得几个段落的名字,出问题时看报错会容易很多:
| 段落 | 作用 |
|---|---|
| log | 日志级别 |
| dns | 域名怎么解析、哪些域名用哪个 DNS 服务器 |
| inbounds | 入站:流量从哪里进来,例如本地混合代理端口、TUN 虚拟网卡 |
| outbounds | 出站:所有节点,以及直连、节点分组 |
| route | 路由规则:什么流量交给哪个出站 |
如果客户端提示配置解析失败,报错里一般会带上出错的段落和字段名。常见原因有两个:配置是为另一个版本的内核生成的;或者拿到的根本不是 sing-box 配置,而是 Clash 的 YAML 或一串节点链接。
图形客户端有哪些
- 官方客户端: sing-box 项目自己提供 Android 和苹果平台(iOS、macOS)的图形客户端,界面简洁,核心功能是添加远程配置、启动、在分组里切换节点。Android 版从官方 GitHub 发布页获取,苹果平台版本的获取方式以官方文档的说明为准;
- 第三方客户端: 一些开源客户端以 sing-box 作为内核,或者把它作为可选内核之一,例如 v2rayN 就可以在设置里切换到 sing-box 内核。这类客户端通常自带订阅解析,对订阅格式的要求比官方客户端宽松。
两类客户端的差别在于谁来生成配置。官方客户端基本是「你给什么配置就跑什么配置」;第三方客户端往往会读取节点列表,再用自己的模板拼出一份完整配置,所以即便机场没有 sing-box 格式,也可能照常使用。
sing-box 订阅的格式要求
这是最容易卡住的地方。在官方客户端里,所谓订阅其实是「远程配置」:一个网址,返回一份完整、可直接运行的 sing-box JSON。把 Clash 订阅链接或者 V2Ray 节点订阅链接填进去是不行的,内核读不懂。
实际操作有三条路:
- 用机场提供的 sing-box 订阅。 在用户中心的订阅区域找有没有标注 sing-box 的链接或「导入到 sing-box」按钮。有的话直接用,这是最省心的;
- 用自带订阅解析的第三方客户端。 它读通用格式的节点订阅,内部转成 sing-box 配置,不需要你处理格式;
- 自行转换。 用订阅转换工具把节点订阅转成 sing-box 配置。
走第三条路要想清楚一个风险:订阅链接等同于账号凭证,把它交给来路不明的在线转换网站,就等于把节点交给了对方。能在本机运行的转换工具优先;机场自己提供了转换服务的,用机场的。另外,转换模板生成的规则和 DNS 设置质量参差不齐,用起来分流不对劲时,问题多半出在模板而不是节点。
导入订阅的通用概念和更新方法,可以参考订阅导入与更新教程。
导入之后的基本用法
以官方客户端为例,流程和其他客户端差不多:
- 在配置页新建一份配置,类型选远程,粘贴 sing-box 订阅链接,按需设置自动更新间隔;
- 选中这份配置,回到主页点启动。手机上第一次启动会请求添加 VPN 配置的权限;
- 启动后进入分组页,在机场预设的分组里手动选节点,或者保持自动测速分组;
- 需要时在日志页查看连接和报错信息。
手机端的官方客户端默认用 TUN 方式接管流量,相当于全设备生效;桌面端是用系统代理还是 TUN,取决于配置里写的入站类型。两种方式的差别见系统代理与 TUN 模式。
适合谁,不适合谁
适合用 sing-box 的人:
- 机场明确提供 sing-box 订阅,并且推荐使用;
- 机场用了较新的协议,而你手头的客户端内核还不支持;
- 愿意读文档、想精确控制 DNS 和路由行为的进阶用户。
不太适合的人:
- 第一次用机场、只想尽快连上的新手,Clash 系客户端的教程和现成配置都多得多,可以从 Clash Verge Rev 教程开始;
- 机场只给 Clash 订阅,又不想碰订阅转换的人。
各平台怎么获取
sing-box 本身开源免费。不同平台上的形态不太一样:
| 平台 | 常见的使用方式 |
|---|---|
| Android | 官方图形客户端,从官方 GitHub 发布页下载 apk;也可以用以 sing-box 为内核的第三方客户端,如 NekoBox、Hiddify |
| iPhone、iPad | 官方图形客户端,获取方式以官方文档的说明为准 |
| macOS | 官方图形客户端,或第三方客户端 |
| Windows、Linux | 官方提供的主要是命令行内核,普通用户一般通过第三方图形客户端使用,例如把 v2rayN 的内核切换为 sing-box,或使用 Hiddify |
和其他代理工具一样,只从官方渠道下载。搜索结果里自称 sing-box 官网、中文版的下载站,来源无法核实,辨别方法见怎么辨别仿冒的代理客户端。
配置里常被提到的几个概念
读 sing-box 的教程或报错信息时,下面几个词出现得很多,知道它们指什么就够了。
规则集。 把大量域名或 IP 规则打包成独立的文件,路由规则里只写「匹配这个规则集的流量交给某个出站」。规则集可以放在本地,也可以是一个远程地址,由内核定期更新。它取代了早期版本里内置的地理数据库写法,所以老教程里的一些路由字段在新版本上已经不能用了,这也是前面说的「格式变动」的主要来源之一。
Clash API。 sing-box 可以在配置里开启一个兼容 Clash 的控制接口。打开之后,原本给 Clash 用的网页控制面板也能连上 sing-box,用来查看连接、切换节点分组。图形客户端里的分组页,背后用的往往就是这个接口。
缓存文件。 配置里可以开启缓存,让内核记住你在各个分组里上次选中的节点。没有开启时,每次重启都会回到分组的默认节点。机场提供的配置一般已经带上了这一项。
入站里的 TUN。 在 sing-box 里,TUN 不是一个单独的开关,而是入站的一种类型。配置里写了 TUN 入站,启动后就会创建虚拟网卡接管流量;图形客户端里的 TUN 开关,实际是在替你增删这一段配置。
遇到问题先对照这张表
| 现象 | 可能的原因 | 处理 |
|---|---|---|
| 导入后提示配置解析失败 | 拿到的不是 sing-box 配置;或配置与内核版本不匹配 | 确认链接是 sing-box 格式;更新客户端,或更新订阅取得新配置 |
| 能启动,但所有网站都打不开 | 当前分组选中的节点不可用;套餐到期或流量用完 | 在分组页换节点;到机场用户中心查看套餐状态 |
| 电脑上 TUN 启动失败 | 没有管理员权限;与其他 VPN 或代理软件的虚拟网卡冲突 | 以管理员权限运行;先退出其他代理软件,详见TUN 模式开启失败 |
| 国内网站变慢 | 配置里缺少国内直连的规则,或规则集没有下载成功 | 查看日志里规则集是否加载失败;换用机场提供的配置 |
| 域名解析报错 | 配置里的 DNS 服务器在当前网络下访问不了 | 查看日志里的 DNS 报错;DNS 的思路见Clash DNS 设置,写法不同,道理相通 |
| 更新订阅失败 | 当前网络访问不了机场的订阅域名 | 在已连接的状态下再更新,或换一个网络 |
排查时先看日志。sing-box 的报错信息比较直接,通常会写明是哪一段配置、哪个出站或哪个规则集出了问题,把报错原文对照上面几类原因,大多能定位到方向。
常见问题
sing-box 能直接导入 Clash 订阅吗?
内核本身不能,两种配置格式不通用。可行的办法是换用机场提供的 sing-box 专用订阅,或者使用自带订阅解析功能的第三方客户端,再或者先做订阅转换。直接把 Clash 链接填进官方客户端的远程配置里,结果一定是解析失败。
sing-box 比 Clash 更快吗?
没有可靠的通用结论。同一个节点、同一种协议下,两种内核的转发效率差别很难在日常使用中感知到,速度主要取决于机场的线路和当时的拥堵程度。本站没有做过对比测试,所以不会给出谁快多少的数字。
更新客户端后配置报错怎么办?
多半是内核版本升级后,配置里用到的旧字段被移除了。先更新一次订阅,机场一般会跟进调整配置;如果配置是自己转换的,换一个与当前内核版本匹配的转换模板重新生成。实在急用,可以暂时退回上一个能正常运行的客户端版本。
新手有必要从 Clash 换到 sing-box 吗?
没有必要为了换而换。现在用着没问题就继续用,客户端只是工具。遇到机场只支持 sing-box、或某个协议在现有客户端里用不了的具体情况,再换也来得及。
iPhone 上能用 sing-box 吗?
能。sing-box 项目提供了苹果平台的官方图形客户端,获取方式以官方文档的说明为准。使用前提和其他平台一样:需要一份 sing-box 格式的远程配置。机场只提供 Clash 或通用节点订阅时,在 iPhone 上直接用 Shadowrocket、Stash 这类客户端更省事,可选项见iOS 客户端对比。
sing-box 是免费的吗?
是。sing-box 内核和它的官方客户端都是开源免费的,需要花钱的只有机场套餐。遇到收费售卖 sing-box 客户端或「高级版」的网站,基本可以判定不是官方渠道。
sing-box 能用网页控制面板吗?
能。在配置里开启兼容 Clash 的控制接口后,常见的网页控制面板可以连接到 sing-box,用来查看连接和切换分组。这主要用于路由器、服务器等没有图形界面的场景;手机和电脑上的图形客户端已经自带这些功能,不需要另外配置。
各平台有哪些客户端、分别用什么内核,机场客户端怎么选里有一张完整的表;还没有机场的话,可以先看首页对比表。
本文中的套餐与价格整理自公开资料,核对日期为 2026年11月14日,未经本站实测,购买前请以官网为准。整理方法见这里。
接着读
安卓机场客户端对比:Clash Meta、v2rayNG、NekoBox、FlClash、Hiddify
安卓机场客户端对比:从内核、订阅格式、分应用代理和上手难度比较 Clash Meta for Android、v2rayNG、NekoBox、FlClash、Hiddify,说明安卓 Clash 客户端的安全下载渠道和新手建议。
Clash for Windows 停更后用什么替代:迁移步骤详解
Clash for Windows 停更说明:2023 年底已停止维护并删除原仓库,旧版不支持新协议、没有安全更新。本文对比 Clash for Windows 替代客户端,给出迁移到 Clash Verge Rev 的步骤。
Clash 规则分流与代理组入门:分流规则类型、四种代理组和指定节点的方法
Clash 规则与分流规则入门:解释规则模式如何从上到下匹配、DOMAIN-SUFFIX、GEOIP、MATCH 等规则类型,select、url-test 等四种代理组的区别,以及怎么给某个网站指定节点。
Clash Meta for Android 教程:安卓 Clash 导入订阅
Clash Meta for Android 教程新手版:讲清安卓 Clash 客户端的下载安装、新建配置导入机场订阅、启动与选节点、访问控制(分应用代理)、订阅自动更新,以及后台被杀、启动后没网等常见问题的处理办法。