客户端教程栏目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 使用教程。

结论先说

平台客户端从哪里获取补充说明
AndroidSFAGitHub Releases 或 Google PlayAndroid 上很值得优先考虑的选择
iOS / iPadOSSFI中国大陆以外地区的 App Store免费,要用海外 Apple ID
macOSSFMApp Store 或 GitHub Releases默认以 TUN 方式运行
WindowsSFWGitHub 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 订阅,一般有三条路:

  1. 机场本身就提供:现在越来越多机场在用户中心里直接给 sing-box 格式的链接,这条路最稳。
  2. 在订阅链接后面加参数:有些机场的订阅服务允许在链接末尾加参数指定输出格式,参数怎么写以机场文档为准。
  3. 用订阅转换:拿转换服务把 Clash 或通用订阅转成 sing-box 配置。要知道转换服务能看到你的全部节点,能自己搭就自己搭,不然挑可信的。

导入方法:进配置页面,新建一份配置,类型选远程,贴上链接,设好自动更新间隔后保存。客户端拉取成功后,去分组页面选节点,再点启动就行。订阅链接的一般知识见 什么是订阅链接。

JSON 配置大概长什么样

就算不自己动手写,知道它的结构也能帮你排查问题。一份 sing-box 配置主要分这么几块:

部分管什么相当于 Clash 里的
inbounds本机怎么接住流量:TUN、混合端口等Clash 的端口和 TUN 设置
outbounds流量能发去哪:各个节点、直连、拦截Clash 的节点和策略组
route规则:什么流量交给哪个 outboundClash 的 rules
dnsDNS 服务器和解析规则Clash 的 dns 段
experimentalClash 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 才能下载。

搜索文章、品牌、AI 工具、客户端与问题

提示:直接输入 Claude、Codex、IEPL、订阅失败 等关键词。也可以打开 搜索页。