sing-box 使用教程：配置结构、官方图形客户端与机场订阅导入

下载与安装：各平台用哪个版本

官方文档与下载入口在 sing-box.sagernet.org，核心二进制与 Android 客户端发布在 GitHub 的 SagerNet 组织下，iOS 与 macOS 客户端通过 App Store 分发。按平台选择：

• 核心与客户端版本要一致或相近。机场订阅通常标注适配的 sing-box 版本（如 1.11+），客户端版本低于要求时会报“未知字段”。
• 不要从应用市场之外的网站下载“汉化版”或“修改版”，sing-box 官方客户端本身就支持中文界面。

理解配置结构：inbounds、outbounds 与 route

即使完全使用机场的订阅，了解配置结构也有助于读懂报错。一个 sing-box 配置是一个 JSON 对象，常见顶层字段如下：

导入机场订阅：远程配置与自动更新

官方图形客户端把每个配置称为“Profile”（配置），支持本地与远程两种。机场订阅应作为远程配置导入，这样客户端会按设定的间隔重新拉取，节点变动时自动同步。

• 命令行用户：把订阅内容保存为 config.json，执行 sing-box check -c config.json 校验，再用 sing-box run -c config.json 启动；TUN 入站需要 root 或管理员权限。
• 配置中包含 clash_api 时，可在浏览器打开面板地址（默认 127.0.0.1:9090，配合外部 UI）查看连接与切换节点。

1. 1

   获取 sing-box 格式订阅链接

   在机场用户中心找到标注为 sing-box 的订阅入口。若只有 Clash 订阅，需要机场提供转换后的链接，或改用支持多格式导入的客户端（Hiddify 可直接导入多种格式）。

2. 2

   新建远程配置

   打开客户端的「配置」（Profiles）页，点击「+」新建，类型选择「远程」（Remote），名称填机场名，URL 粘贴订阅链接。

3. 3

   设置自动更新

   打开“自动更新”并把间隔设为 720 或 1440 分钟。保存后客户端会立即拉取一次，成功后配置出现在列表中。

4. 4

   启动并选择节点

   回到「仪表盘」（Dashboard）选中该配置并启动，首次启动系统会请求 VPN 权限。切换到「分组」（Groups）页，在 selector 分组中点选节点，或让 urltest 分组自动选择。

常用设置：TUN、规则分流与 DNS

• TUN 与系统代理：手机端只能用 TUN；桌面端如果只想让浏览器走代理，可在 inbounds 中保留 mixed 入站并把系统代理指向该端口，不启用 tun。
• auto_route 与 strict_route：tun 入站的两个常用选项，前者自动接管系统路由，后者防止流量绕过 TUN。strict_route 在部分 Windows 环境下会影响局域网访问，可按需关闭。
• 规则分流：route.rules 从上到下匹配，先匹配到的规则生效。要让某个域名强制走代理，在规则列表最前面添加 domain_suffix 规则并指向代理分组。
• DNS：dns.servers 中至少配置一个国内服务器（直连）和一个海外服务器（经代理），再用 dns.rules 把国内域名指向国内服务器，否则会出现解析慢或被污染。
• 日志：排错时把 log.level 改为 debug，客户端的日志页会显示每条连接命中的规则与出站。

常见问题与处理方法

• 导入时报 unknown field / 解析失败：订阅使用的字段与当前核心版本不匹配。升级客户端到最新版，或让机场提供对应版本的订阅链接。
• 启动失败，提示权限不足：TUN 入站需要 VPN 权限（手机）或管理员权限（桌面）。手机上允许 VPN 请求；桌面以管理员或 root 运行。
• 启动后全部超时：先确认配置中的 rule_set 是否能下载（远程规则集需要指定 download_detour 为 direct 或可用出站）；再检查节点是否失效，参考节点连接失败。
• 国内网站变慢或打不开：DNS 规则缺失，国内域名被送到海外 DNS 解析。补充国内 DNS 服务器与对应的 dns.rules，参考DNS 问题。
• Hysteria2 节点在某些网络不可用：部分运营商限制 UDP，切换到同机场的 TCP 协议节点（Trojan、VLESS）即可。