客户端教程栏目sing-box 教程
sing-box 新手入门:各平台怎么装、配置文件怎么写
想上手 sing-box 却看不懂配置文件?这一页先讲各平台客户端怎么装,再拆解入站、出站、路由几个基础配置块的写法,最后给出导入机场订阅和验证是否生效的步骤。
用 sing-box 最省事的路子,是装它的官方客户端(Android 叫 SFA、iOS 叫 SFI、macOS 叫 SFM、Windows 叫 SFW),在配置页面新建一份远程配置,把机场给的 sing-box 格式订阅贴进去,更新一下、挑好节点、点启动。整个过程不用自己写 JSON;不过知道 inbounds、outbounds、route 这三块各管什么,出问题时会好查很多。
目录
sing-box 是新一代的通用代理内核,Hysteria2、TUIC、AnyTLS、ShadowTLS 这些新协议它往往最先支持,而且官方自己就做了全平台客户端:Android 的 SFA、iOS 的 SFI、macOS 的 SFM、Windows 的 SFW。和 Clash 系客户端最大的不同在于,它的配置是 JSON 格式,Clash 订阅它直接读不了。对一般用户来说,装好官方客户端、新建远程配置、贴上机场给的 sing-box 订阅,就能用,一行 JSON 都不必写。
这篇讲清楚各平台客户端去哪下、订阅怎么导、JSON 配置大概长什么样,以及常见问题。如果你只在 Windows 或 macOS 桌面上用,并且更喜欢在图形界面里改规则,也可以对照看看 Clash Verge Rev 使用教程。
结论先说
| 平台 | 客户端 | 从哪里获取 | 补充说明 |
|---|---|---|---|
| Android | SFA | GitHub Releases 或 Google Play | Android 上很值得优先考虑的选择 |
| iOS / iPadOS | SFI | 中国大陆以外地区的 App Store | 免费,要用海外 Apple ID |
| macOS | SFM | App Store 或 GitHub Releases | 默认以 TUN 方式运行 |
| Windows | SFW | GitHub Releases | 默认以 TUN 方式运行 |
| Linux | 命令行内核 | 包管理器或 GitHub Releases | 没有官方图形界面 |
官方客户端
四个平台的官方客户端长得几乎一样,用法也一致:配置页面里管理好几份配置,仪表盘上看连接和流量,分组页面里挑节点。下载渠道方面,Android 和桌面端优先去 GitHub Releases,iOS 只能走 App Store。
Linux 没有官方的图形客户端,通常直接跑 sing-box 内核,指定一份配置文件:
sing-box run -c config.json
Linux 桌面用户想要图形界面的话,可以找其他基于 sing-box 内核的第三方客户端。
订阅:远程配置和 sing-box 格式的订阅
sing-box 客户端里说的“订阅”,其实是远程配置:客户端每隔一段时间去一个网址拉一份完整的 JSON 配置下来。所以机场得给你 sing-box 格式的订阅,Clash 格式或通用 Base64 格式都不行。
拿到 sing-box 订阅,一般有三条路:
- 机场本身就提供:现在越来越多机场在用户中心里直接给 sing-box 格式的链接,这条路最稳。
- 在订阅链接后面加参数:有些机场的订阅服务允许在链接末尾加参数指定输出格式,参数怎么写以机场文档为准。
- 用订阅转换:拿转换服务把 Clash 或通用订阅转成 sing-box 配置。要知道转换服务能看到你的全部节点,能自己搭就自己搭,不然挑可信的。
导入方法:进配置页面,新建一份配置,类型选远程,贴上链接,设好自动更新间隔后保存。客户端拉取成功后,去分组页面选节点,再点启动就行。订阅链接的一般知识见 什么是订阅链接。
JSON 配置大概长什么样
就算不自己动手写,知道它的结构也能帮你排查问题。一份 sing-box 配置主要分这么几块:
| 部分 | 管什么 | 相当于 Clash 里的 |
|---|---|---|
| inbounds | 本机怎么接住流量:TUN、混合端口等 | Clash 的端口和 TUN 设置 |
| outbounds | 流量能发去哪:各个节点、直连、拦截 | Clash 的节点和策略组 |
| route | 规则:什么流量交给哪个 outbound | Clash 的 rules |
| dns | DNS 服务器和解析规则 | Clash 的 dns 段 |
| experimental | Clash API、缓存之类的扩展功能 | 没有完全对应的 |
下面是一个最简化的结构示意,具体字段以官方文档为准:
{
"inbounds": [{ "type": "tun", "tag": "tun-in" }],
"outbounds": [
{ "type": "selector", "tag": "proxy", "outbounds": ["node-jp", "node-us"] },
{ "type": "direct", "tag": "direct" }
],
"route": {
"rules": [{ "rule_set": "geosite-cn", "outbound": "direct" }],
"final": "proxy"
}
}
弄懂这个结构以后,机场配置里的分组、规则和 DNS 设置就不再是一团看不懂的东西。sing-box 的字段随版本变得比较快,改配置之前,先确认客户端版本和你参考的文档版本一致。
问答
配置解析失败:配置里用了当前客户端版本还不认识的字段。把客户端升级到最新;如果反过来,机场的配置是照老版本写的,就会报某些字段已被移除,这时让机场更新它的模板。
启动后没网:先去分组页面确认选中的节点能用;再看看是不是还有别的 VPN 或 TUN 类软件同时开着;桌面端要确认已经给了系统扩展或管理员权限。通用的排查思路见 客户端开启后无法上网。
导入 Clash 订阅没反应:sing-box 读不了 Clash 格式,要么换 sing-box 订阅,要么先转换。
iOS 上下载不了 SFI:需要一个非中国大陆区的 Apple ID,办法和下 Shadowrocket 一样。
规则没起作用:远程配置里的 rule_set 要联网下载,第一次启动时如果节点不通,规则集就下不下来。先用一个能用的节点启动一次,规则集缓存好之后就正常了。
小结
- 四个平台的官方客户端分别叫 SFA、SFI、SFM、SFW,用法一样;Linux 用命令行内核。
- 所谓订阅就是一份远程 JSON 配置,机场要给 sing-box 格式,或者你自己转换。
- 配置由 inbounds、outbounds、route、dns 几块组成,看懂结构排查起来更快。
- 解析失败先对版本,没网先查节点和权限。
- 想在图形界面里改规则选 Clash Verge Rev,想要新协议、全平台一份配置选 sing-box。
问答
SFA、SFI、SFM、SFW 各指哪个版本?
这是 sing-box 官方客户端在四个平台上的名字:SFA 是 Android 版,SFI 是 iOS 版,SFM 是 macOS 版,SFW 是 Windows 版。四个的界面和配置方式基本一样,都直接加载 sing-box 的 JSON 配置。
机场只提供 Clash 订阅,sing-box 能用上吗?
直接用不了,sing-box 只认自己的 JSON 格式。可以请机场提供 sing-box 订阅,或者用订阅转换把 Clash 订阅转过来。转出来的配置好不好用,取决于转换服务套的规则模板。
配置刷新后报解析失败,怎么处理?
多半是配置的 JSON 和客户端版本对不上,比如用了只有新版本才有的字段,或者某些旧字段已经被删掉。先把客户端升到最新,还不行就看看机场的配置是照哪个 sing-box 版本写的。
iOS 版的 SFI 收费吗?
SFI 在 App Store 上是免费的,不过同样得用非中国大陆区的 Apple ID 才能下载。