sing-box设置:从配置导入到连接排查的完整步骤
简答: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。
远程配置导入:导入后先验证,不要直接开启全部功能
- 在服务方后台复制 sing-box 专用配置链接;如果只提供 Clash YAML、Base64 或节点 URI,先确认是否存在 sing-box 格式。
- 在客户端新建远程配置,粘贴链接并保存名称。不要把包含身份信息的链接发布到公开位置。
- 先执行更新或拉取配置,确认返回内容不是登录页、错误页或空白文本。
- 打开配置预览,确认至少能看到有效的
outbounds,并检查是否存在明显的解析错误。 - 先启动系统代理或
mixed入站,选择一个节点进行最小连接测试。 - 只有基础连接成功后,再开启自动选择、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 文档。
- 先暂时使用一个明确可达的 DNS 配置,避免同时启用多个复杂规则。
- 如果 IPv6 环境下出现部分域名打不开,临时将解析策略改为优先 IPv4 或仅 IPv4,观察是否改善;这是排查手段,不代表所有网络都应永久关闭 IPv6。
- 确认客户端是否接管了 DNS 请求。只开系统代理时,部分程序可能不走代理;TUN 才是更完整的流量接管方式,但会增加权限和路由复杂度。
- 开启 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 设置清单
- 确认使用的是当前可核验的 sing-box 客户端或核心。
- 确认订阅是 sing-box JSON、远程 JSON,还是其他格式。
- 保存原始配置副本,不直接覆盖能正常工作的版本。
- 先用
sing-box check -c config.json校验。 - 先启用系统代理或
mixed,用单个节点测试。 - 确认日志里没有 DNS、TLS、认证或路由错误。
- 再设置
selector或urltest,比较节点稳定性。 - 最后配置 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 怎么处理?
先记录当前核心版本和完整错误位置,再对照官方配置文档与迁移说明。不要直接把字段删除后继续运行,因为它可能是旧字段迁移、拼写错误或客户端尚未支持的功能。