跨平台内核

sing-box 跨平台客户端教程

新一代通用代理内核,单个二进制即可覆盖服务端与客户端。配置文件是纯文本 JSON,可以纳入版本管理,适合愿意花十分钟理解结构的人。

本篇要点
  • sing-box 是内核不是界面,必须先选一个图形客户端再谈配置。
  • 配置分三段:出站(节点)、路由(谁走代理)、DNS,缺一段就连不通。
  • 订阅用 JSON 格式,和 Clash 的 YAML 不能直接互换。
通用内核JSON 配置内存占用低

sing-box 的图形客户端叫 SFI(sing-box for iOS/macOS 等),内核与界面分离。理解「入站 → 路由 → 出站」这条链,配置就不再是黑箱。

准备工作

  • 一台 Windows / macOS / Linux 电脑或 Android / iOS 设备;
  • 一条支持 sing-box 格式的订阅(部分服务需要单独复制该格式链接);
  • 会用文本编辑器打开 JSON 文件。

第 1 步 · 先理解三段结构

sing-box 的配置由三块组成,缺一块就跑不起来:

  • inbounds:流量怎么进来(TUN 网卡、系统代理端口、混合端口)
  • outbounds:流量往哪去(你的节点、直连、拦截)
  • route:分流的判断规则(域名、IP、GeoIP、规则集)

第 2 步 · 选一个图形客户端

Windows 用 SFW 或 NekoRay;macOS / iOS 用 SFI;Android 用 SFA。它们都只是外壳,真正干活的是同一份 sing-box 内核。

也可以直接跑命令行:下载对应平台的二进制,用 -c config.json 启动。

  • 桌面端建议用图形客户端,托盘切换节点更省事
  • 服务器或软路由直接跑二进制更稳定

第 3 步 · 导入订阅

在客户端里点「新建配置」→「从链接导入」,粘贴 sing-box 格式的订阅链接。

导入后先点一次「检查配置」,确认 JSON 结构合法再启动;启动失败时日志会指出是哪个字段出错。

  • 订阅格式不对是新手最常见的失败原因,确认链接是 sing-box 而非 Clash 格式
  • 导入成功后不要手动改订阅生成的 JSON,改了自己维护一份覆盖配置

第 4 步 · 开启并验证

启动后先看日志有没有 start inbound 字样;有就说明入站已就绪。

再打开浏览器验证;需要命令行也走代理时,把 TUN 入站打开。

  • TUN 需要管理员权限
  • 日志里出现 permission denied,基本都是权限问题

一份可直接改用的路由模板

下面是最小可用结构,节点部分替换成你自己的出站配置即可。

{
  "log": { "level": "info" },
  "inbounds": [
    { "type": "mixed", "listen": "127.0.0.1", "listen_port": 7890 }
  ],
  "outbounds": [
    { "type": "shadowsocks", "tag": "proxy", "server": "YOUR_HOST", "server_port": 8388, "method": "2022-blake3-aes-128-gcm", "password": "YOUR_PASSWORD" },
    { "type": "direct", "tag": "direct" }
  ],
  "route": {
    "rules": [
      { "geosite": ["cn"], "outbound": "direct" },
      { "geoip": ["cn"], "outbound": "direct" }
    ],
    "final": "proxy"
  }
}

改完用客户端的「检查配置」跑一遍,比直接启动再翻日志快。

需要安装包?sing-box 下载 一页列出各平台安装包与版本核对结果。

常见问题

sing-box 和 Clash 有什么本质区别?

内核不同:sing-box 是单二进制、纯 JSON 配置,路由规则表达力更强;Clash 生态的图形界面更成熟。日常使用体验差别不大,差别在配置的可维护性。

订阅链接导入后启动失败?

九成是格式不匹配。Clash 订阅不能直接喂给 sing-box,需要在服务后台复制 sing-box 专用链接。

日志提示 permission denied?

TUN 入站需要管理员权限。Windows 以管理员身份运行,macOS / Linux 用 sudo 或给二进制相应能力。

配置文件改坏了怎么恢复?

客户端一般会保留历史版本或订阅原始配置,重新导入一次订阅即可覆盖。自己手改的部分建议单独存一份。

能替代 Clash Verge 吗?

能,但需要你愿意读配置。如果你只想要「装完能用」,Clash Verge Rev 更省事。

手机端怎么用?

iOS 用 SFI(App Store 部分地区上架),Android 用 SFA。导入订阅的逻辑与桌面端一致。

内核懂了,回到实用路线

不想手写配置的话,Clash Verge Rev 的图形界面能覆盖 90% 场景。