Sing-box教程：跨平台内核与客户端的选择与配置思路

客户端分类：通用内核难度：高级发布 2026-10-05约 12 分钟读完

Sing-box教程很容易写成配置文件大全，机场牛换个写法：先讲它是什么、该不该用，再讲配置的思路。结论先放这：sing-box 不是“又一个 Clash”，它是一个通用代理平台（内核），官方客户端覆盖 iOS、安卓和 macOS，配置是 JSON 文件，门槛比 Clash 系客户端高一档。想先跑通的新手，建议先用现成的 Mihomo 系客户端；已经有 sing-box 格式订阅，或者就想自己掌控分流，再往这边走。

sing-box 是什么：内核、配置和客户端三层

很多人对 sing-box 的第一反应是“它是个软件”。更准确的说法是三层东西叠在一起：

它支持的协议覆盖面很广，常见的 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC、WireGuard 都在，较新的版本还陆续加入了 ShadowTLS、AnyTLS 等，具体以你所用版本的官方文档为准。项目的源码和更新说明在 sing-box 官方仓库。

它既能当客户端，也能当服务端。机场牛这里只讲客户端侧，自建服务端的取舍，看 机场和自建节点。

官方 Sing-box客户端：SFI、SFA、SFM 分别在哪

官方为不同平台各做了一个客户端，名字用的是缩写，常被并称为 SFI SFA，再加上 macOS 的 SFM：

Windows 和 Linux 上，据官方文档的说明，主要提供命令行版本，图形界面多由第三方项目提供。渠道会随项目调整，机场牛不写具体的上架情况，请以官方仓库和文档为准；下载只走官方渠道，不碰网盘、群文件和“修改版”。

配置文件长什么样：先看懂五个大块

一份配置通常是一个 JSON 对象，最顶层有这几块，下面是结构示意，不能直接运行：

{
  "log": {},
  "dns": {},
  "inbounds": [],
  "outbounds": [],
  "route": {}
}

桌面端用命令行版本时，有两条命令值得记住，一条检查配置，一条运行：

sing-box check -c config.json
sing-box run -c config.json

先 check 再 run，是省时间的好习惯，报错信息通常会指出是哪个字段有问题。

有一个坑要提前说：字段的写法和结构随版本调整过，比如早期靠地理数据库做分流，后来改为规则集的方式，DNS 相关的写法也有变化。所以旧教程里的整份配置，放到新版本上可能报错或提示弃用，以你所用版本的官方文档为准。也不要整份复制来路不明的配置，里面的出口信息、规则和 DNS 设置，你未必看得懂，出了问题更难查。

机场订阅怎么用在 sing-box 上

配置是 JSON，而多数机场给的是通用格式或 Clash 格式，所以“订阅怎么进来”是 sing-box 上手的第一道坎。常见的三条路：

官方客户端的远程配置通常可以设置自动更新，具体选项以界面为准，间隔怎么定见 订阅更新频率。订阅链接等同于账号凭证，处理泄露的办法见 机场订阅链接安全。

协议和内核版本也要对得上，节点用的协议内核不认，表现就是节点被跳过或连不通。各协议的设计思路和客户端支持，见 VLESS、Trojan、Hysteria2 的区别，较新的协议可以看术语页 AnyTLS是什么。

sing-box 和 Clash 系怎么选：别按名气，按订阅格式和需求

决策路径：

1. 想先用起来：从 Clash Verge下载 那一篇开始，或者看另一款客户端 Mihomo Party，把订阅、规则模式、系统代理走通；
2. 手机上想用官方客户端：看上表中的 SFI 和 SFA，先确认订阅格式；
3. 手里的订阅本来就是 sing-box 格式：直接用它，不必为了统一而转成 Clash；
4. 想自己掌控 DNS 与分流：sing-box 的配置自由度高，但备好耐心，别指望一次配成。

这篇 Sing-box教程 的适用人群：谁适合直接上，谁先别碰

适合直接上的人：

• 能读懂 JSON，愿意对着官方文档查字段；
• 订阅格式匹配，或者愿意承担转换的麻烦；
• 需要多个平台用同一套内核和配置思路；
• 排错时会看日志，而不是只会重装。

先别碰的人：

• 刚接触机场，连节点、订阅、规则模式还分不清，请先看 机场节点是什么；
• 只想“点个导入就能用”，没有折腾的打算；
• 机场只给 Clash 格式，又不愿意转换。

这不是门槛歧视，是体力分配：把精力花在对的地方，比硬上难度高的工具更实在。

从 Clash 概念翻译到 sing-box：同一件事在两边怎么叫

如果你已经用过 Clash 系客户端，入门的捷径不是从头读文档，而是先做一张“翻译表”，把熟悉的概念对到 sing-box 里。下表只是帮你建立直觉，两边的设计并不一一对应，具体字段以所用版本的官方文档为准。

用这张表要记住两点：它帮你找到对应的位置，不帮你搬运配置。Clash 的 YAML 和 sing-box 的 JSON，结构差别很大，把 Clash 配置逐行“翻译”成 JSON，很容易漏掉语义。稳妥的做法是先理解概念，再用官方文档的写法重新组织。想回头巩固 Clash 一侧的规则与策略组概念，看 分流规则；TUN 的基本概念，见术语页 TUN模式。

第一次跑 sing-box 之前的自查清单：十一条逐项勾

sing-box 的坑，多数出在“一上来就写太多”。下面这份清单的思路是：每一步都留退路，每一步都能验证。

• 程序来自官方仓库或官方文档指向的渠道，仓库名称核对过；
• 弄清了自己用的版本，查文档时对照同一版本，而不是搜到哪篇看哪篇；
• 确认了订阅的格式：能不能直接作为远程配置，还是需要转换；
• 先写一份最小配置：一个入口、一个出口、一条兜底路由，跑通了再加别的；
• 每次修改之后先用 check 命令校验，通过了再 run；
• 日志级别调到能看见报错信息，出问题先看日志，再动配置；
• 改配置之前把旧文件复制一份，文件名带上日期，随时能回退；
• 订阅链接、节点密码这类敏感信息，不写进公开仓库，也不贴在求助帖里，求助前先替换成占位符；
• 需要虚拟网卡的场景，已确认系统权限和客户端提示，并且知道怎么关掉；
• 没有同时开着另一个代理客户端，避免两边抢系统代理或虚拟网卡；
• 想放弃的时候，知道怎么还原：关闭系统代理、停止进程、撤销虚拟网卡。

sing-box 上手的五个常见误区：为什么不对，该怎么做

误区一：网上搜到的配置，整份复制就能用。

• 为什么不对：配置里装着出口信息、DNS 和路由，字段写法随版本不同而不同，来路不明的配置还可能把流量引向你看不懂的地方；
• 正确做法：先读懂配置的五个大块，再借别人的片段，每借一段就用 check 命令校验一次。

误区二：sing-box 比 Clash 系“更先进”，所以应该换。

• 为什么不对：两者是并行的体系，各有取舍。“先进”没有统一的标准，换工具的成本却是实打实的；
• 正确做法：按订阅格式和需求选。订阅本来就是 Clash 格式，就先用 Mihomo 系客户端，有了明确的理由再考虑迁移。

误区三：协议支持越多越好，所以必须追最新版本。

• 为什么不对：节点用不到的协议，内核再新也没有意义；新版本还可能调整字段写法，让旧配置报错或提示弃用；
• 正确做法：先看节点实际用的协议，核对所用版本是否支持，升级之前把配置备份好。协议之间的差别见 VLESS、Trojan、Hysteria2 的区别。

误区四：官方客户端在每个平台都有图形界面。

• 为什么不对：据官方文档的说明，官方客户端主要覆盖 iOS、安卓和 macOS，Windows 与 Linux 以命令行内核为主，图形界面多由第三方提供，情况也可能随项目更新而变；
• 正确做法：以官方仓库和文档为准。用第三方图形界面时，先核对仓库来源和最近的更新记录。

误区五：订阅转换只是点一下的小事，随便找个在线工具就行。

• 为什么不对：订阅链接等同于账号凭证，交给第三方转换，就是把凭证交了出去；转换的结果还可能漏掉部分节点，或者把策略组弄乱；
• 正确做法：先问机场有没有现成的 sing-box 格式订阅，实在要转换，先读 订阅转换 里的风险说明，转换后核对节点是否齐全、分流是否符合预期。

今天就能做的三件事

1. 先确认你手里订阅的格式，再决定是走 sing-box 还是 Mihomo 系；
2. 要试 sing-box，就先在一台设备上跑一份最小的配置，用 check 命令校验通过，再逐步加 DNS 和分流；
3. 想对比不同机场的资料、再决定买哪家，去 机场推荐排行榜 和 机场对比 看。写这篇 Sing-box教程 的目的，是让你选工具之前心里有数，不是让每个人都去写 JSON。

软件功能、字段写法和上架情况会随版本变化，一切以项目官方文档为准。使用代理服务请遵守所在地法律法规，机场牛不提供法律意见。

延伸阅读

• Mihomo Party 怎么用：Mihomo 内核客户端的特点与选择
• Clash Verge下载：官方渠道、安装包怎么选与常见问题
• VLESS、Trojan、Hysteria2 区别：机场协议怎么选
• 安卓机场教程：安卓手机用机场选哪个客户端
• Clash for Windows 停更了用什么？三个接班客户端怎么选