sing-box 使用教程:全平台安装、订阅导入与新协议支持
sing-box 是近几年增长最快的代理内核,新协议几乎都先在它上面落地:AnyTLS、Hysteria2、TUIC、VLESS Reality、ShadowTLS。它有各平台官方客户端,也有 Hiddify 这样的图形封装,还是 Apple TV 上少数可用的免费客户端。对大多数用户来说,Clash 系客户端仍然够用,只有机场明确提供 sing-box 订阅、或订阅里包含 Clash 不支持的新协议、或要在 tvOS 上用时,才需要换到 sing-box。
什么时候需要 sing-box
- 机场用户中心有「sing-box 订阅」按钮。
- 节点协议是 AnyTLS、TUIC 或 ShadowTLS。
- iPhone 想用免费客户端且不介意配置偏技术。
- 需要 Windows、macOS、Android、iOS、tvOS 统一一套配置。
- 软路由内存小,想要比 OpenClash 更省资源的方案。
本站收录的 17 家机场品牌资料里协议多为 VLESS 或未注明,Clash 系客户端都能处理。协议科普见 机场协议区别 和 AnyTLS 是什么。
各平台安装
| 平台 | 获取方式 | 说明 |
|---|---|---|
| iOS / iPadOS / tvOS | App Store 搜索 sing-box | 美区可下载,免费,需非国区账号 |
| Android | GitHub SagerNet/sing-box Releases 的 APK,或 Google Play | 选 arm64-v8a |
| Windows / macOS / Linux | GitHub Releases 的命令行二进制 | 没有官方图形界面,桌面用 Hiddify |
| 全平台图形界面 | Hiddify:GitHub hiddify/hiddify-app | 封装 sing-box,适合不碰配置的人 |
非国区账号注册见 美区 Apple ID 教程。
三种订阅格式在 sing-box 里的差异
| 订阅格式 | 官方客户端 | Hiddify |
|---|---|---|
| sing-box 订阅(JSON) | 直接导入 | 直接导入 |
| Clash 订阅(YAML) | 不能,需 订阅转换 | 自动转换 |
| 通用订阅(Base64) | 不能,需转换 | 自动转换 |
这是 Hiddify 最大的便利:它内置转换,什么格式都能吃。格式区别见 订阅链接说明。
导入订阅:分步骤
官方客户端(iOS / Android):
- 打开 sing-box → 底部「Profiles」→ 右上角「+」。
- 类型选「Remote」,Name 填机场名,URL 粘贴 sing-box 订阅链接,Auto Update 打开并设间隔。
- 点「Create」。预期:Profiles 列表出现该项,右侧显示最近更新时间。
- 回到「Dashboard」,确认 Profile 已选中,打开顶部开关,首次允许 VPN 配置。预期:状态变为 Started,「Groups」里能看到策略组和节点。
- 打开浏览器验证。
Hiddify:
- 首页「+」→「从剪贴板添加」(提前复制任意格式的订阅链接)。
- 预期:首页出现一张配置卡片,显示流量和到期。
- 点中间的大按钮连接。预期:按钮变色,显示延迟。
- 「代理」页选节点。
没有订阅先看 机场推荐排行榜。
设置项逐项说明
官方客户端「Settings」:
- Profile Auto Update:订阅更新间隔,建议 24 小时。
- Always On / On Demand:按需连接,有网络请求时自动启动。
- Include All Networks:让所有网络接口的流量都走 sing-box,开了 TUN 后一般打开。
- Exclude APNs:排除苹果推送流量,避免推送延迟。
- Log Level:排障时调 debug。
Hiddify「设置」:
- 服务模式:VPN(整机)、系统代理(仅浏览器等)、TUN。手机用 VPN,桌面用系统代理或 TUN。
- 路由规则:「绕过中国」默认打开,国内直连。
- DNS:远程 DNS 默认 Cloudflare,可以改。
- 分应用代理(Android):选择哪些 App 走代理。
- 自动测速选节点:开启后用 url-test 组。
配置文件结构(命令行用户)
sing-box 用 JSON,核心四段:
inbounds:本地入口,桌面常用mixed(HTTP + SOCKS 混合)或tun。outbounds:节点列表和策略组(selector、urltest)。route:分流规则,配合rule_set远程规则集实现国内直连。dns:建议国内域名走国内 DNS,其余走 DoH。
运行:sing-box run -c config.json。检查配置:sing-box check -c config.json。订阅提供的 JSON 一般已经包含完整四段,直接用即可;需要改规则时只动 route.rules。
与 Clash 的取舍
| 对比 | sing-box | Clash(mihomo) |
|---|---|---|
| 新协议支持 | 最快 | 稍慢,但主流都有 |
| 配置格式 | JSON,偏技术 | YAML,机场订阅直接给 |
| 图形客户端 | 官方简洁,Hiddify 友好 | Clash Verge / Meta / Mi 成熟 |
| 规则生态 | rule_set | 规则集丰富,教程多 |
| 内存占用 | 更低 | 略高 |
| tvOS | 有 | 无 |
新手仍然建议 Clash 系,见 翻墙工具汇总。
常见报错表
| 症状 | 原因 | 处理 |
|---|---|---|
| 导入提示 parse config 失败 | 粘贴了 Clash 或通用订阅 | 换 sing-box 订阅或用 Hiddify |
| 启动报 rule_set 下载失败 | 规则集托管在 GitHub,首次需网络 | 先用可用节点开代理再启动,或改本地规则集 |
| Hysteria2 节点连不上 | 网络限制 UDP | 换 TCP 协议节点;见 Hysteria2 是什么 |
| 开关打开但没流量 | 未选中 Profile 或策略组选了不可用节点 | Dashboard 检查 Profile,Groups 换节点 |
| 网页打不开但延迟正常 | DNS | 改 DNS 为 DoH |
| tvOS 输入不了 URL | 遥控器 | 用 iPhone 键盘或 iCloud 同步配置 |
| 版本不支持某协议 | App 旧 | 更新 App |
常见问题
机场只给 Clash 订阅,sing-box 能用吗?
Hiddify 可以自动转换;官方客户端需要先转换。
iOS 的 sing-box 和 Clash Mi 选哪个?
有 sing-box 订阅选 sing-box;只有 Clash 订阅选 Clash Mi。两者都免费,都需要非国区账号。
Apple TV 能用吗?
可以,tvOS 版在 App Store。配置方法见 Apple TV 教程。
怎么判断是客户端问题还是机场问题?
同一订阅换一个客户端试;都不行就是机场,按 排查步骤 处理。
软路由能用 sing-box 吗?
可以,OpenWrt 有 sing-box 包和 luci 插件,内存占用比 OpenClash 低。见 软路由教程。
多设备配置怎么同步?
iOS / macOS / tvOS 官方客户端支持 iCloud 同步 Profile;Android 和桌面各自导入。设备数限制见 多设备共用说明。
sing-box 晚上特别慢?
线路问题,见 晚高峰慢怎么办。
选好客户端后,到 机场品牌库 按协议筛选机场。