COCODUCK - 国际网络VPN加速服务提供商

sing-box设置:从配置导入到连接排查的完整步骤

更新于 2026-11-04 · cocoduck.buzz

简答:sing-box设置最稳妥的顺序是:先确认客户端和订阅格式,再导入或编写 JSON 配置,用 sing-box check 校验后启动,最后逐项开启 DNS、分流和 TUN。假如一上来就启用 TUN,出现无网络、DNS 超时或局域网异常时,往往很难判断是节点、规则还是本机接管方式出了问题。本文给出一套先跑通、再增强的设置流程。

定义:sing-box 是使用 JSON 配置、由核心程序和图形客户端共同组成的网络连接工具;核心负责读取 inbounds、outbounds、route、dns 等配置,客户端负责提供导入、启动、权限和系统网络接管界面。

先做这一步:确认配置类型与接管方式

本文是面向实际设置的使用指南,本站为第三方使用指南站,不是 sing-box 或任何节点服务的官方网站。不同客户端的菜单名称、支持平台和版本状态可能变化,下载地址与具体版本请以 sing-box 官方文档及其项目发布页为准。

不要先猜订阅格式。把服务方提供的内容按下面三类判断,判断错了通常会直接导致“配置解析失败”“导入后没有节点”或“启动后无流量”。

你拿到的内容常见特征下一步
完整 JSON 配置能看到 inbounds、outbounds、route、dns 等字段保存为 .json,先校验,再导入本地配置
远程配置链接通常是一个 URL,打开后返回 JSON、订阅文本或转换结果在客户端使用远程配置功能;不要把链接公开到群组或截图中
Clash YAML、Base64 或节点 URI出现 YAML 缩进、编码文本,或以协议名称开头的单节点链接不能直接假设 sing-box 可原样读取;应使用服务方提供的 sing-box 格式,或使用可信的本地转换工具后再校验

sing-box 官方配置结构明确使用 JSON,常见顶层字段包括 dns、inbounds、outbounds、route 和 experimental;官方还提供 sing-box check 用于检查配置、sing-box format 用于格式化配置。参考 官方配置介绍。

推荐的最小闭环:先使用系统代理或 mixed 入站跑通,再考虑 TUN。mixed 可以同时提供 SOCKS 和 HTTP 代理服务,并可在部分平台自动设置系统代理;其具体行为以客户端和系统权限为准,见 官方 Mixed 入站说明。

分平台设置路径:先核对客户端,再核对权限

sing-box 核心、图形客户端和第三方 GUI 不是同一个东西。官方项目组织页面列出了 Android、Apple 平台和桌面客户端相关项目,但客户端名称、分发渠道和可用版本会调整,因此本文不把某个下载包、商店页面或版本号写死。可先从 SagerNet 官方项目组织确认客户端项目,再按当前页面操作。

平台优先设置方式遇到问题先查什么
Windows使用当前可核验的图形客户端导入 JSON 或远程配置;先开启系统代理,确认浏览器或测试程序能够连接系统代理是否被其他软件覆盖、客户端是否有网络权限、配置是否通过校验
macOS使用对应的图形客户端导入配置;先测试 HTTP/SOCKS 代理,再考虑 TUN 或系统网络扩展网络扩展权限、系统代理状态、是否残留其他代理规则
Android导入配置后使用系统 VPN 接管;同一时间通常只保留一个 VPN 类连接系统是否允许 VPN、是否启用了省电限制、其他 VPN 或工作配置是否冲突
iOS使用当前可用的 Apple 平台客户端导入配置,按系统提示允许 VPN 配置VPN 配置权限、后台限制、旧配置是否仍在生效
Linux可以使用命令行核心或图形客户端;命令行先用 check,再用 run文件路径、运行用户权限、TUN 设备权限、系统路由和 DNS 服务

官方文档对 TUN 的平台支持、DNS 处理方式和严格路由有明确限制。例如,auto_detect_interface只支持 Linux、Windows 和 macOS;TUN 的 strict_route 在 Windows 上可用于减少普通多网卡 DNS 解析造成的泄漏,但也可能影响部分虚拟机或特殊网络软件。不要把某个平台的参数直接复制到另一个平台,先看 官方 TUN 入站文档。

本地 JSON 配置:先做一个最小可验证结构

如果你已经有服务方生成的 sing-box JSON,优先使用它,不要为了“看起来完整”而手写协议字段。下面这个示例只展示结构和接管逻辑,其中的服务器地址、端口、UUID、密码、TLS 和传输参数都是占位符,不能直接连接。

{
  "$schema": "https://sing-box.sagernet.org/schema.json",
  "log": {
    "level": "info"
  },
  "inbounds": [
    {
      "type": "mixed",
      "tag": "mixed-in",
      "listen": "127.0.0.1",
      "listen_port": 2080
    }
  ],
  "outbounds": [
    {
      "type": "direct",
      "tag": "direct"
    },
    {
      "type": "block",
      "tag": "block"
    }
  ],
  "route": {
    "auto_detect_interface": true,
    "final": "direct"
  }
}

这个示例能够帮助你理解字段关系,但它没有代理节点,因此只能验证配置结构和本地入站,不能证明远端连接可用。真正的可用配置至少还需要一个由服务方提供、字段完整的代理出站,并把 route.final 或规则指向对应的出站标签。

  • inbounds:定义本机接收流量的入口,例如 mixed 或 tun。
  • outbounds:定义流量出口,例如代理节点、direct 直连、block 阻断、selector 手动选择和 urltest 自动测试。
  • route:决定哪些流量走哪个出口;如果 final 为空,官方文档说明会使用第一个出站,因此最好明确填写,减少误路由。
  • dns:定义 DNS 服务器、DNS 规则、缓存和解析策略,不能只靠切换节点来解决所有解析问题。

配置保存后,在核心程序所在目录执行:

sing-box check -c config.json
sing-box format -w -c config.json
sing-box run -c config.json

如果命令行提示参数不存在、字段未知或版本迁移警告,不要盲目删除字段。先对照当前官方文档和 官方迁移说明,因为部分旧字段会被弃用或改为新的 rule action。

远程配置导入:导入后先验证,不要直接开启全部功能

  1. 在服务方后台复制 sing-box 专用配置链接;如果只提供 Clash YAML、Base64 或节点 URI,先确认是否存在 sing-box 格式。
  2. 在客户端新建远程配置,粘贴链接并保存名称。不要把包含身份信息的链接发布到公开位置。
  3. 先执行更新或拉取配置,确认返回内容不是登录页、错误页或空白文本。
  4. 打开配置预览,确认至少能看到有效的 outbounds,并检查是否存在明显的解析错误。
  5. 先启动系统代理或 mixed 入站,选择一个节点进行最小连接测试。
  6. 只有基础连接成功后,再开启自动选择、DNS 分流、规则集和 TUN。

远程配置和远程规则集都属于外部输入。链接泄露可能导致他人使用你的配置额度或查看订阅信息;不明来源的规则集还可能造成错误分流。建议使用来源明确的配置,定期更新并在失效后撤销旧链接。不要把第三方转换服务当作官方服务,也不要在转换页面粘贴不必要的账号信息。

节点选择与分流:selector、urltest、direct、block 怎么用

selector适合手动选择节点,方便你在延迟、稳定性和业务可用性之间做判断;urltest适合在多个出站之间自动测试。官方文档显示,urltest会对指定出站列表进行测试,并可配置测试 URL、间隔和容差,默认测试 URL 与默认间隔以当前文档为准,见 官方 URLTest 说明。

目标建议出口注意事项
手动比较节点selector先比较真实业务连接,不要只看一次延迟
自动选择相对稳定节点urltest测试地址可达不等于所有业务都可用,仍需验证网页、办公系统或文件传输
本地和内网资源direct结合局域网、办公网和 DNS 规则检查,避免把内部地址错误送入代理
明确不需要的域名或地址block规则顺序很重要,先匹配的规则可能决定最终行为

路由规则可以按域名、域名后缀、网络类型、IP 版本和规则集等条件匹配;官方路由规则文档同时列出了字段变化和弃用项。设置分流时建议从少量明确规则开始,确认结果后再逐步增加规则集,避免规则冲突。参考 官方 Route Rule 文档。

DNS 与 TUN:先解决解析,再解决全流量接管

DNS 设置建议分两层排查:第一层确认客户端能否正常访问 DNS 服务器,第二层确认 DNS 请求是否按照预期被路由。官方 DNS 配置包含 servers、rules、final、strategy 和缓存相关字段;不同版本还可能出现弃用字段,因此不要照抄旧教程。可参考 官方 DNS 文档。

  1. 先暂时使用一个明确可达的 DNS 配置,避免同时启用多个复杂规则。
  2. 如果 IPv6 环境下出现部分域名打不开,临时将解析策略改为优先 IPv4 或仅 IPv4,观察是否改善;这是排查手段,不代表所有网络都应永久关闭 IPv6。
  3. 确认客户端是否接管了 DNS 请求。只开系统代理时,部分程序可能不走代理;TUN 才是更完整的流量接管方式,但会增加权限和路由复杂度。
  4. 开启 TUN 后,逐项检查系统代理、其他 VPN、虚拟网卡、局域网访问和 IPv6 路由,不要一次修改多个开关。

TUN 的 dns_mode、auto_route、strict_route 等选项会影响 DNS 处理和系统路由;官方文档还提示,某些严格路由设置可能影响虚拟机等软件。若开启 TUN 后“所有程序都没网”,最快回滚方法是关闭 TUN、恢复系统代理或直接模式,再重新检查节点与 DNS,而不是继续叠加规则。

常见错误对照:先分层定位,再改一个变量

现象优先判断处理动作
配置解析失败JSON 语法、字段名称或版本迁移运行 sing-box check,查看具体行号;对照当前官方配置文档,不要直接复制旧字段
导入后没有节点订阅格式不匹配、远程返回空内容或配置缺少 outbounds用文本方式检查返回内容,确认是 sing-box JSON;必要时重新获取专用格式
启动成功但网页打不开系统代理未接管、route.final 指向 direct、节点出站不可用先关闭 TUN,仅用 mixed 或系统代理测试,再查看日志和出站选择
DNS 超时或部分域名失败DNS 服务器不可达、规则选错、IPv6 路径异常临时简化 DNS 规则,分别测试 IPv4、IPv6 和直连解析
开启 TUN 后局域网异常路由接管范围过大或系统代理与 TUN 同时冲突关闭 TUN 回滚,确认局域网地址是否需要直连,再逐项恢复设置
UDP 应用不可用节点协议、出口能力或客户端配置不支持所需 UDP 流量先用 TCP 网页验证基础连接,再确认节点和出站是否明确支持 UDP

每次只改一个变量,并记录改动前后的配置。最小复现顺序是:直连测试 → mixed/系统代理测试 → 单节点测试 → DNS 测试 → 分流规则 → TUN。这样可以把问题分成配置、节点、DNS、路由和系统接管五层,避免把“节点慢”误判成“客户端坏了”。

一套可执行的 sing-box 设置清单

  1. 确认使用的是当前可核验的 sing-box 客户端或核心。
  2. 确认订阅是 sing-box JSON、远程 JSON,还是其他格式。
  3. 保存原始配置副本,不直接覆盖能正常工作的版本。
  4. 先用 sing-box check -c config.json 校验。
  5. 先启用系统代理或 mixed,用单个节点测试。
  6. 确认日志里没有 DNS、TLS、认证或路由错误。
  7. 再设置 selector 或 urltest,比较节点稳定性。
  8. 最后配置 DNS 分流、规则集和 TUN,并为每一步保留回滚方式。

如果你只是需要稳定完成跨境办公或多平台网络连接,建议先把节点、DNS 和本地接管方式分开验证,再根据办公软件、文件传输和视频会议等实际场景选择线路。不要只用一次延迟测试替代真实业务验证。

参考资料

本文关键配置说明来自 sing-box 官方文档与官方项目页面:配置介绍、TUN 入站、DNS 配置、路由规则、官方项目组织。版本、客户端名称和分发渠道如有变化,请以当前页面为准。

常见问题

sing-box 可以直接导入 Clash YAML 吗?

不能默认认为可以直接导入。sing-box 官方配置格式是 JSON;如果拿到的是 Clash YAML、Base64 或节点 URI,应先确认服务方是否提供 sing-box 专用格式,或使用可信工具转换后再运行 check 校验。

sing-box 设置后为什么没有节点?

常见原因是订阅格式不匹配、远程链接返回登录页或错误页、配置没有 outbounds,或者客户端只导入了空模板。先把远程内容保存下来检查,再确认配置中是否存在节点出站。

sing-box 应该先开 TUN 还是系统代理?

建议先开系统代理或 mixed 入站跑通单个节点,再开启 TUN。TUN 会改变系统路由和 DNS 接管范围,适合需要覆盖更多应用的场景,但排错变量更多。

开启 TUN 后没有网络怎么办?

先关闭 TUN并恢复系统代理或直连,确认基础节点仍可用;然后检查其他 VPN、虚拟网卡、DNS、auto_route 和 strict_route,最后一次只恢复一个选项。

urltest 测到的节点一定最快吗?

不一定。urltest 的结果取决于测试 URL、测试间隔和当前网络路径,只能作为自动选择依据。办公系统、文件传输和视频会议还需要进行真实业务验证。

sing-box 配置出现 unknown field 怎么处理?

先记录当前核心版本和完整错误位置,再对照官方配置文档与迁移说明。不要直接把字段删除后继续运行,因为它可能是旧字段迁移、拼写错误或客户端尚未支持的功能。

相关阅读

参考资料

  1. sing-box 官方文档首页
  2. sing-box 官方配置介绍
  3. sing-box 官方 Mixed 入站说明
  4. sing-box 官方 TUN 入站说明
  5. sing-box 官方 DNS 配置说明
  6. sing-box 官方路由规则说明
  7. sing-box 官方 URLTest 出站说明
  8. sing-box 官方迁移说明
  9. SagerNet 官方项目组织