sing-box 教程

sing-box 是开源的通用代理平台，支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC 等主流协议，官方提供全平台图形客户端和命令行程序。关键结论是：官方客户端只认 sing-box 自己的 JSON 配置，机场提供 sing-box 配置链接时直接导入即可；只有 Clash 或通用订阅的话，换用其他客户端更省事。

先理解：sing-box 用的是“配置”，不是传统订阅

这是新手最容易卡住的地方。sing-box 官方客户端导入的是完整的 JSON 配置文件（本地文件或远程 URL），不是 Clash 的 YAML，也不是 Base64 节点列表。

你手上的链接	能否直接导入 sing-box 官方客户端	建议
sing-box 订阅 / sing-box 配置链接	可以，作为远程配置导入	按本文操作
Clash / mihomo 订阅	不行	改用 Clash Verge Rev 使用教程 或安卓的 Clash Meta for Android 使用教程
通用 Base64 订阅	不行	改用 v2rayN 使用教程，它可以调用 sing-box 内核

导入后报“配置解析失败”，大概率是链接格式不对，参见 订阅格式错误 / 导入后没有节点怎么解决。

不确定该用哪个客户端，可以先看 机场客户端大全 按平台和订阅格式对照。

官方客户端与平台

本文参考 sing-box v1.14.3（2026 年 10 月）。官方文档列出的图形客户端如下（括号里是社区常用简称）：

平台	官方客户端	获取方式	系统要求
Android	sing-box for Android（SFA）	Google Play、F-Droid、GitHub Releases	Android 5.0+
iOS / tvOS	sing-box for Apple platforms（SFI / SFT）	App Store	iOS 15.0+，tvOS 17.0+
macOS	sing-box for Apple platforms（SFM）	App Store、Homebrew（brew install sfm）、GitHub Releases	macOS 13.0+
Windows / Linux	sing-box for Desktop	GitHub Releases	Windows 10+；Linux x64/arm64/armv7l

• Apple 平台客户端需要非中国大陆区的 Apple 账号才能下载。
• TestFlight 测试版名额仅向赞助者开放。
• 官方文档提醒：一些号称基于 sing-box 的第三方项目代码质量差且带广告，请以官方列表为准。

安装前准备

1. 在机场用户中心确认是否提供“sing-box”格式的订阅或配置链接，没有就先按上表换客户端。
2. 确认系统版本满足上表要求，老旧设备装不上最新版时不要去找来源不明的旧安装包。
3. 退出其他代理或加速器 App。手机同一时间只能运行一个 VPN，电脑上多个 TUN 也会抢路由。

官方下载入口

• GitHub 仓库：github.com/SagerNet/sing-box（Releases 中包含命令行程序和部分图形客户端安装包）
• 官方文档：sing-box.sagernet.org，客户端列表在文档的 Clients 页面

图形客户端：导入远程配置

各平台界面略有差异，流程一致：

1. 打开客户端，进入配置文件（Profiles）管理页面。
2. 新建配置，类型选择远程（Remote），粘贴 sing-box 配置链接，可设置自动更新间隔。
3. 也可以选择本地文件，导入自己编写的 JSON。
4. 选中该配置，回到首页点击启动。Android 和 iOS 首次启动会请求 VPN 权限，必须允许。
5. 如果配置中包含 selector 类型的出站，可在客户端的分组页面手动切换节点并测试延迟。

远程配置里的节点、规则、DNS 全部由配置文件决定，客户端没有“规则 / 全局”这样的快捷开关，除非配置提供了对应分组。想改分流方式，需要修改配置或请机场提供其他版本。

TUN 与系统代理

sing-box 的流量接管方式由配置中的 inbound（入站）决定：

• tun 入站：创建虚拟网卡接管整机流量。移动端客户端本质上就是通过系统 VPN 接口实现；桌面端需要管理员或 root 权限。
• mixed 入站（HTTP + SOCKS）：只开放本地端口，配合系统代理使用。部分配置会通过 set_system_proxy 选项自动设置系统代理。

TUN 原理见 TUN 模式详解。sing-box 对 DNS 的控制非常细，解析异常时优先检查配置中的 dns 部分；用了 fake-ip 后遇到个别应用异常，可参考 fake-ip 模式引发的兼容问题怎么排查与修复。

命令行用法（进阶）

适合 Linux 服务器、软路由或喜欢命令行的用户：

1. 从 GitHub Releases 下载对应系统和架构的压缩包，解压得到 sing-box 可执行文件（部分发行版也可用包管理器安装）。
2. 准备好配置文件 config.json。
3. 先检查配置，再运行：

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

使用 TUN 入站需要 root 权限；只用 mixed 入站时可以普通用户运行。长期使用建议配置为 systemd 服务。

sing-box 大版本之间常有配置字段的废弃与变更。升级后 check 报错时，对照官方文档的迁移说明修改配置，不要盲目删字段。

连接验证

1. 启动后访问海外网站，确认能打开。
2. 在客户端的日志页面（命令行模式看终端输出）查看连接记录，确认请求经过预期的出站。
3. 访问国内网站，确认分流规则生效、速度正常。
4. 用 DNS 泄露检测网站检查解析结果，方法见 代理环境下 DNS 泄露怎么检测与彻底防护。

常见问题

机场只给了 Clash 订阅，能用 sing-box 吗

官方客户端不能直接导入。可以向机场索取 sing-box 格式，或者换用 Clash 系客户端。不建议把订阅交给来路不明的在线转换网站，订阅链接等同于账号凭证。

远程配置导入失败怎么办

链接需要能直接访问。订阅域名被干扰时，可以先用本地配置连上，再更新远程配置，参见 机场订阅更新失败怎么解决。

升级客户端后配置无法启动

多为配置字段与新版本不兼容。远程配置联系机场更新模板；自己写的配置按官方迁移说明修改。

Hysteria2、TUIC 节点不通

这类基于 UDP/QUIC 的协议可能被所在网络限速或封锁 UDP，换 TCP 类节点对比即可判断，原理见 什么是 Hysteria2 协议 和 什么是 TUIC 协议。

官方客户端和第三方“sing-box 客户端”有什么区别

官方客户端由 sing-box 项目维护，更新最及时，但只认 JSON 配置。不少第三方客户端把 sing-box 当作内核，再加上订阅转换、图形化分组等功能，用起来更像普通机场客户端。选择第三方客户端时，务必确认它是开源且仍在维护的项目，不要安装来源不明、带广告的“魔改版”。

能连接但部分网站打不开

先在日志里看该网站命中了哪个出站，再判断是规则问题还是节点问题，参见 节点延迟正常但打不开网页怎么办。

机场订阅链接怎么导入 sing-box？

sing-box 官方客户端导入的是 sing-box 格式的远程配置（JSON），需要机场提供 sing-box 订阅或使用转换后的配置链接；在客户端的配置文件中新建远程配置并填入链接即可。

配置备份

sing-box 的所有设置都在 JSON 配置里：远程配置只需保存链接；自己编写的配置建议放到私有 Git 仓库或云盘并记录版本，升级前先留一份能用的旧配置。参考 配置备份与迁移教程。