sing-box 教程：官方客户端、远程配置与 JSON 结构

sing-box 是一个通用代理平台，既可以作为命令行内核运行，也有官方图形客户端。普通用户在手机或 Mac 上安装官方客户端，导入一个返回 sing-box JSON 配置的远程链接，即可开始使用。

快速步骤

1. 确认机场是否提供 sing-box 格式的订阅；没有的话，准备好转换后的配置链接。
2. 根据平台安装官方客户端：Android 从 GitHub Releases 或应用商店获取，Apple 设备从 App Store 获取。
3. 在客户端中新建配置，类型选择远程（Remote），粘贴链接。
4. 设置自动更新间隔并保存。
5. 选中该配置，点击启动，按系统提示允许创建 VPN。

内核与官方客户端

sing-box 由 SagerNet 开发，代码托管在 GitHub 的 SagerNet/sing-box 仓库。官方图形客户端均基于同一内核：

简称	平台	获取方式
SFA	Android	GitHub Releases 或应用商店
SFI	iOS / iPadOS	App Store（上架名称以实际为准）
SFM	macOS	App Store 或 GitHub Releases
SFT	Apple tvOS	App Store

Windows 和 Linux 上目前通常直接运行命令行内核，或使用以 sing-box 为内核的第三方图形客户端（如 v2rayN 新版本可以调用 sing-box 内核）。请认准官方仓库和官方文档中给出的下载链接。平台相关的设置可以参考 Android 使用指南和 iOS 使用指南。

远程配置与订阅转换

官方客户端的「远程配置」会定期从一个 URL 下载完整的 JSON 配置，它不能直接解析 Clash YAML 或 Base64 节点列表。获取 sing-box 配置有三种思路：

1. 机场原生提供：用户中心里标注为 sing-box 的订阅链接，最省事。
2. 订阅转换：把通用订阅转换为 sing-box 配置。注意转换服务能看到你的订阅链接，尽量用可信或自建的工具。
3. 自己编写：适合有经验的用户，按下文结构手写配置，并自行维护节点信息。

基本 JSON 结构

sing-box 配置的顶层字段主要有：

• log：日志级别；
• dns：DNS 服务器与解析规则，详见 DNS 设置教程；
• inbounds：入站，即本地如何接收流量（mixed 代理端口、tun 虚拟网卡等）；
• outbounds：出站，即节点和直连；
• route：路由规则，决定流量走哪个出站；
• experimental：缓存、Clash API 等实验功能。

一个最小化的示例（仅用于理解结构，字段以你使用的版本文档为准）：

{
  "log": { "level": "info" },
  "inbounds": [
    {
      "type": "mixed",
      "tag": "mixed-in",
      "listen": "127.0.0.1",
      "listen_port": 2080
    }
  ],
  "outbounds": [
    {
      "type": "shadowsocks",
      "tag": "proxy",
      "server": "example.com",
      "server_port": 8388,
      "method": "2022-blake3-aes-128-gcm",
      "password": "your-password"
    },
    { "type": "direct", "tag": "direct" }
  ],
  "route": {
    "rules": [
      { "ip_is_private": true, "outbound": "direct" }
    ],
    "final": "proxy"
  }
}

这段配置让局域网和私有地址直连，其余流量走 proxy 节点。与 Clash 一样，路由规则按顺序匹配，final 相当于 Clash 中的 MATCH 兜底，对比可参考 Clash 教程。

TUN 与系统代理

官方移动端客户端默认以 VPN（TUN）方式工作，由配置中的 tun 类型入站接管整机流量，因此远程配置里通常已经包含 tun 入站。桌面端直接运行内核时，可以只使用上例中的 mixed 入站，再把系统或浏览器代理指向 127.0.0.1:2080；若需要接管所有程序，再添加 tun 入站并以管理员权限运行。两种方式的取舍可以参考 TUN 模式相关教程，这里不展开。

需要注意，同一台设备上不要同时运行多个 TUN 类工具，否则路由表冲突会导致断网。

常见问题排查

• 启动时报配置错误：错误信息通常会指出字段路径，多为版本不匹配导致的弃用字段，更新配置或客户端版本。
• 远程配置下载失败：在浏览器中打开链接，确认返回的是 JSON 而不是网页或 YAML。
• 启动成功但无法上网：检查 DNS 配置和 route 规则是否把流量导向了正确的出站。
• 手机耗电偏高：适当调大远程配置的更新间隔，关闭不需要的日志输出。

请在遵守所在地法律法规的前提下使用。