sing-box 多平台入门：核心概念与基础配置

很多人第一次听说 sing-box，是在服务商的订阅格式列表或某个客户端的”内核”说明里。它与 Clash Verge Rev 这类图形客户端不是同一层面的东西：sing-box 首先是一个用 Go 编写的开源代理内核，定位是通用代理平台，靠 JSON 配置文件驱动，图形界面是建立在它之上的附加物。本文解释它的核心概念与配置结构，并给出普通用户实际可行的使用路径。

定位与适用平台

sing-box 支持的协议范围较广，涵盖 Shadowsocks、Trojan、VLESS、VMess、Hysteria2、TUIC 等，各协议的特点差异可参考四协议对比：SS、Trojan、VLESS、Hysteria2。内核本体可运行在 Windows、macOS、Linux 上；移动与桌面端另有官方图形客户端：SFA（Android）、SFI（iOS）、SFM（macOS）、SFW（Windows），命名与上架情况以官方仓库和文档为准。如果你还不清楚内核与客户端的分工，建议先读网络代理客户端是什么。

准备工作

• 一条服务商提供的、明确标注支持 sing-box 格式的订阅链接（普通 Clash 订阅不能直接使用）。哪些服务商提供 sing-box / v2rayN 系订阅格式，可参考适配 v2rayN / v2rayNG 的机场推荐中的格式兼容性说明。
• 明确自己的使用路径：直接跑命令行内核，还是使用图形客户端。本文建议多数读者走图形客户端路线。

核心概念：inbound、outbound 与 route

sing-box 的配置是一个 JSON 文件，主体由三部分组成：

• inbound（入站）：定义流量从哪里进入内核，例如本地混合端口（mixed）或 TUN 虚拟网卡。
• outbound（出站）：定义流量从哪里出去，每个代理节点就是一个出站，另有 direct（直连）等内置类型。
• route（路由）：定义规则，决定哪些流量走哪个出站，作用相当于其他客户端里的分流规则，概念可对照术语页路由规则。

下面是一个仅用于说明结构的最小化示例（字段做了简化，不能直接投入使用）：

{
  "inbounds": [
    { "type": "mixed", "listen": "127.0.0.1", "listen_port": 2080 }
  ],
  "outbounds": [
    { "type": "shadowsocks", "tag": "proxy", "server": "示例地址", "server_port": 8388 },
    { "type": "direct", "tag": "direct" }
  ],
  "route": {
    "final": "proxy"
  }
}

读懂这三段的关系，就理解了 sing-box 的骨架：流量从 inbound 进来，经 route 匹配规则，从对应的 outbound 出去。

下载与安装

命令行内核与各平台图形客户端都从官方渠道获取：内核与桌面客户端在官方 GitHub 仓库的 Releases 页面按平台和架构选择对应文件；SFA 可在 Releases 或应用商店获取，SFI 通过 App Store 分发（上架地区以商店实际情况为准）。不要使用第三方打包的”整合版”，配置来路不明的内核存在安全风险。

导入远程配置的一般流程

以官方图形客户端为例，通用流程如下：

1. 打开客户端，进入配置（Profiles）管理页面。
2. 选择”新建配置”，类型选择远程（Remote）。
3. 粘贴服务商提供的 sing-box 订阅链接，命名后保存。
4. 客户端下载配置后，在列表中选中该配置并启动服务。
5. 移动端首次启动会请求添加 VPN 配置，桌面端开启 TUN 时会请求管理员权限，按提示授权。

远程配置支持设置自动更新间隔，建议开启，避免节点信息过期。

运行模式与验证

图形客户端通常提供系统代理与 TUN 两种接管方式，TUN 的原理、权限要求与常见故障见 TUN 模式说明与排查。启动后验证三步走：客户端日志无报错、访问此前无法打开的网站成功、IP 检测网站显示出口为节点地区。命令行运行内核时，可直接观察终端输出确认有无 FATAL 级别错误。

适合什么人使用

适合的人群：希望统一多平台配置体验、需要 Hysteria2 等较新协议、或想通过一份 JSON 精确控制分流的用户。如果你只需要在电脑上稳定上网，现成的 Clash 系客户端可能更省心，入门可看 Clash Verge Rev 安装与配置教程；把 sing-box 留到确有需求时再学也不迟。

常见错误与处理

• 配置 JSON 语法错误：启动即退出且日志提示 decode/parse 失败，多为逗号、引号或括号问题。用带 JSON 校验的编辑器检查，或运行 sing-box 自带的 check 命令定位行号。
• TUN 权限不足：表现为创建接口失败。Windows 用管理员身份运行，macOS/Linux 需相应管理员权限；图形客户端按首次开启时的授权引导操作。
• 订阅格式不匹配：把 Clash 的 YAML 订阅填给 sing-box 客户端会解析失败，向服务商确认是否提供 sing-box 专用订阅地址。

恢复与卸载

停止服务后系统网络即恢复直连；若开启过 TUN，确认虚拟网卡随服务停止一并消失。卸载图形客户端按平台常规方式进行，命令行内核则删除可执行文件与配置目录即可，不会在系统中留下其他组件。