sing-box 教程：配置结构、订阅使用方式、TUN 模式与跨平台客户端

sing-box 是新一代通用代理内核，支持几乎所有协议，配置为 JSON。多数用户不直接操作内核，而是用基于它的图形客户端。

客户端

所有客户端都支持 TUN，无需系统代理。

配置结构

{
  "dns": { "servers": [], "rules": [] },
  "inbounds": [{ "type": "tun", "auto_route": true }],
  "outbounds": [
    { "type": "vless", "tag": "日本 01", "server": "..." },
    { "type": "selector", "tag": "节点选择", "outbounds": ["日本 01"] },
    { "type": "direct", "tag": "direct" }
  ],
  "route": {
    "rules": [
      { "domain_suffix": ["anthropic.com"], "outbound": "节点选择" },
      { "rule_set": ["geosite-cn"], "outbound": "direct" }
    ],
    "final": "节点选择"
  }
}

• inbounds： 流量入口，tun 或 mixed（HTTP/SOCKS 端口）。
• outbounds： 节点与策略组（selector 手动、urltest 自动）。
• route： 规则，按顺序匹配，final 兜底。
• dns： 解析服务器与规则。

与 Mihomo 的 proxies、proxy-groups、rules、dns 一一对应，见 Mihomo 配置详解。

使用机场订阅

方式一：机场直接提供 sing-box 订阅。 官网订阅页选 sing-box 格式，复制链接，客户端「添加配置」粘贴 URL。最省事。

方式二：转换。 机场只有通用订阅时，用订阅转换工具（自建或可信的转换服务）把通用订阅转为 sing-box JSON。注意转换服务能看到你的订阅内容，优先自建或用机场推荐的。

TUN 模式

sing-box 客户端默认用 TUN 入口，启动即接管系统流量，终端程序自动走代理。桌面端首次启动需管理员权限或授权扩展。原理见 TUN 是什么。

常见问题

• 配置导入报错： JSON 格式错误或字段版本不匹配。用最新客户端，检查配置版本。
• 启动后无网络： DNS 段配置错误。用机场配置或转换工具的默认 DNS。
• 部分协议不可用： 更新客户端到最新版。

Android 用户的选择见 Android 客户端指南。