TAG官网 - TAG VPN套餐价格 | Bronze、Silver、Gold计划 - TAG Pro网络加速返回首页

sing-box 启动后没有网络:按故障层级排查 TUN、DNS 和路由

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

简答:sing-box 启动后没有网络,先停止 sing-box,确认系统直连是否恢复;如果恢复,再区分是系统代理、TUN 接管、DNS 解析、路由规则还是节点出站失败。不要一开始反复换节点,先用日志和单变量测试定位具体层级。

定义:“sing-box 启动后没有网络”是指配置已经启动或客户端显示运行中,但浏览器、应用或终端无法正常建立连接,原因可能发生在系统代理、TUN/VPN、DNS、路由、权限或出站节点中的任一层。

先做 30 秒分流:停止、恢复、判断故障范围

本站是第三方使用指南站,不代表 sing-box 或任何客户端官方。遇到启动后断网,先不要修改多个字段,也不要马上更换订阅。

  1. 停止 sing-box,关闭 TUN、VPN 或系统代理接管。
  2. 测试系统直连:打开一个平时可访问的网站,或使用系统网络诊断功能。
  3. 根据结果分流:直连仍然断网,先排查系统网络、其他 VPN、代理和虚拟网卡;直连恢复,才继续检查 sing-box。
启动后没有网络的第一判断
现象优先检查不要先做什么
停止 sing-box 后仍然断网系统代理、其他 VPN、网络过滤器、虚拟网卡和默认路由不要继续改 DNS 或节点
所有网站都打不开TUN/VPN 权限、默认路由、系统代理端口、出站连接不要只判断为节点失效
只有域名打不开,IP 测试正常DNS 服务器、DNS 规则、DNS 劫持或解析出站不要同时修改路由和 MTU
只有部分应用失败分应用规则、应用自身代理设置、IPv6 或 UDP 支持不要直接删除全部规则
浏览器能用但终端不能用系统代理是否覆盖终端、终端自身代理变量和端口不要把浏览器成功当成全局网络成功

如果停止后直连仍无法恢复,先关闭其他 VPN、系统代理和网络过滤器,再重新连接 Wi-Fi 或移动网络。若只有 sing-box 启动时断网,问题通常集中在接管方式、端口、DNS、路由或出站链路。

确认运行模式:系统代理、TUN、VPN 不是一回事

sing-box 可以通过不同方式接管流量。系统代理通常只影响支持代理设置的应用;TUN 会创建虚拟网络接口并接管更广泛的流量;移动端图形客户端在需要 TUN 时通常依赖系统 VPN 能力。官方客户端资料明确区分了图形客户端与 TUN/VpnService 的关系,具体选项仍以当前客户端界面为准:Android 客户端功能说明。

  1. 先确认客户端当前到底开启了系统代理、TUN、VPN还是命令行模式。
  2. 如果系统代理模式下可用、TUN 模式下断网,优先检查 TUN 权限、虚拟接口、自动路由和 DNS 接管。
  3. 如果 TUN 模式关闭后仍残留断网,检查系统代理是否还指向旧端口,以及其他 VPN 是否仍处于连接状态。
  4. 如果使用 Android,检查是否有其他 VPN、始终开启 VPN、分应用 VPN 或省电限制;这些设置的入口会因系统版本和厂商界面不同而变化。

不要把“客户端显示运行中”当作“流量已经成功转发”。运行状态只说明进程或服务启动,不能单独证明 TUN 接口、默认路由、DNS 和节点出站都正常。

检查配置格式和启动错误:先验证 JSON,再看第一条错误日志

sing-box 使用 JSON 配置。官方配置文档提供了 sing-box check 用于检查配置,也提供了格式化命令和与当前二进制匹配的 JSON Schema:sing-box 配置说明。如果你使用命令行启动,可以在不启动代理的情况下先校验配置:

sing-box check -c config.json

如果客户端没有命令行入口,就使用客户端自带的配置检查、日志或导入预览功能。看到报错时,优先处理第一条与配置加载、字段不支持、DNS、TUN、route 或 outbound 相关的错误,不要只看最后一行。

  • 配置解析失败:检查是否把 Clash YAML 或其他格式直接当成 sing-box JSON 使用。
  • 字段不支持:字段可能依赖 sing-box 内核版本或客户端封装,按当前版本文档核对,不要照抄旧教程。
  • 远程配置失败:确认配置是否下载完成、缓存是否可用,以及订阅内容是否确实是 sing-box 支持的格式。
  • 端口绑定失败:检查同一端口是否被其他程序占用,或旧进程是否仍在运行。

如需分享日志,只保留时间、错误类型和必要上下文;订阅地址、UUID、密码、令牌、私钥、服务器地址和完整配置都应先打码。

TUN 相关排查:路由、DNS 接管和权限要分开看

官方 TUN 文档将 auto_route、auto_redirect、strict_route、dns_mode 和路由排除项分别定义。不要把它们当成同一个“开关”:sing-box TUN 配置文档。

TUN 故障的单变量检查表
检查项适合判断的问题处理方式
auto_route流量是否被自动导向 TUN确认配置是否启用,以及系统是否真的创建了对应路由
auto_redirectLinux 下透明接管与路由冲突只在当前平台和内核支持时按官方说明启用,不要跨平台照搬
strict_route严格路由、未支持网络和部分 DNS 行为若开启后特定应用失效,记录现象并暂时回滚该项测试
dns_modeTUN 是否配置平台 DNS 或劫持 DNS根据当前版本支持情况检查 disabled、native 或 hijack
route_exclude_address局域网、网关或本地地址是否被错误接管核对局域网网段和实际网络,不要凭经验填写陌生网段

需要特别注意版本差异:TUN 文档显示部分字段是在不同版本中加入或调整的,因此旧配置中的字段名、默认行为和客户端界面可能不一致。资料没有明确说明的平台行为,不要直接推断为所有 Windows、macOS、Linux 或 Android 都相同。

如果 TUN 一启动就全局断网,建议按这个顺序回滚:先关闭 TUN 保留系统代理测试;再关闭 DNS 劫持或改回客户端默认 DNS 测试;最后才检查自定义路由和 MTU。每次只改一个变量,并记录改动前后的结果。

DNS 失败怎么判断:区分解析失败和节点连接失败

“网页打不开”不一定是节点失败。可以先判断域名解析是否成功,再判断解析出的地址能否通过当前出站建立连接。

  1. 停止 sing-box,确认系统 DNS 能否解析常用域名。
  2. 启动 sing-box 后,使用系统 DNS 测试工具,例如 Windows 的 nslookup example.com;macOS 和 Linux 也可使用系统中可用的 DNS 查询工具。
  3. 如果启动后查询超时或服务器不可达,查看日志中是否出现 dns、hijack、timeout、permission denied 等关键词。
  4. 如果 DNS 能返回地址,但所有连接仍超时,再转到 outbound、路由和节点协议兼容性检查。

sing-box 的 DNS 配置包含 DNS server、DNS rule、final 和解析策略等部分,官方文档说明了默认 DNS server 和策略的关系:sing-box DNS 配置文档。不要在没有日志依据时同时更换 DNS、修改 fake IP、调整 IPv4/IPv6 和改变 TUN 路由。

如果只有部分域名失败,检查是否存在针对域名、DNS server、规则集或出站的专门规则;如果所有域名都失败,优先检查 DNS 接管是否生效、DNS 地址是否能到达,以及 TUN 或系统防火墙是否拦截了请求。

路由、节点和规则:确认流量到底去了哪里

当 TUN 已建立、DNS 也能解析,但浏览器仍无法打开网页,应检查 route 和 outbound。官方 route 文档说明了默认网卡、Android VPN 覆盖、路由循环防止等行为:sing-box Route 配置文档。

  1. 确认节点已选中:客户端显示配置已加载,不代表实际出站已经选择了可用节点或正确的 selector。
  2. 看连接日志:区分连接超时、TLS 握手失败、认证失败、地址解析失败和被规则拒绝。
  3. 检查规则顺序:过早命中 direct 或 block,可能造成部分网站失败;规则调整后必须重新测试同一个目标。
  4. 检查 IPv4/IPv6:如果只有部分网络失败,可分别测试 IPv4 和 IPv6,不要直接把 MTU 当成首要原因。
  5. 检查路由循环:TUN 接管后,出站连接必须避免再次被自己的 TUN 接管。官方文档建议通过自动检测网卡、默认网卡或出站绑定网卡等方式避免循环。

如果只有某一个节点失败,先用同一配置中的其他已知可用出站做对照;如果所有节点都失败,优先怀疑本地接管、DNS、规则或配置格式,而不是直接认定所有节点都不可用。

按系统做最后复测:Windows、macOS、Linux、Android

不同平台的复测重点
平台优先查看回滚方式
Windows系统代理开关、VPN 状态、虚拟网卡、DNS、默认路由和防火墙提示停止 TUN,关闭系统代理,断开其他 VPN 后恢复网络
macOS网络设置中的代理、VPN、DNS、接口顺序和客户端权限关闭代理或 VPN 配置,重新连接当前网络
LinuxTUN 接口、路由表、策略路由、nftables/iptables、systemd-resolved 和权限停止进程并撤销客户端创建的网络规则;无法确认时重启网络服务或设备
AndroidVPN 权限、其他 VPN、分应用规则、省电限制和当前 Wi-Fi/移动网络断开 VPN,关闭始终开启 VPN,再重新测试普通网络

这些入口会因系统版本、客户端封装和权限模型不同而变化。复测时只保留一个网络入口:例如先只开系统代理,不开 TUN;或者只开 TUN,不叠加其他 VPN。确认一个模式正常后,再逐项恢复高级功能。

MTU 只在特定现象下检查:如果 DNS、连接握手和小页面正常,但大页面、文件传输或特定协议反复卡住,才考虑 MTU 或路径分片问题。不要因为启动后断网就直接修改 MTU。

修复后的验证与回滚清单

  1. 停止 sing-box,确认直连恢复。
  2. 重新启动配置,确认客户端没有新的 TUN、DNS、route 或 permission 错误。
  3. 先测试域名解析,再测试一个普通网页,最后测试原本失败的应用或网站。
  4. 检查连接记录是否出现实际请求,确认请求没有全部命中 block 或 direct。
  5. 记录当前有效配置和改动项,避免下一次故障无法回退。

如果修改后问题更严重,按相反顺序回滚:恢复原配置文件,关闭自定义 TUN 路由,关闭系统代理和 VPN,停止 sing-box,再确认直连。不要删除所有配置或规则,因为这会让后续定位缺少对照。

最终仍无法判断时,准备一份脱敏信息:操作系统、客户端名称、运行模式、内核版本、首次错误日志、是否能恢复直连、DNS 测试结果和失败范围。不要公开订阅地址、身份凭据或完整节点参数。

常见问题

sing-box 显示运行中,但所有网站都打不开,先换节点吗?

不建议先换节点。先停止 sing-box,确认系统直连是否恢复;如果恢复,再检查 TUN/VPN 权限、系统代理端口、DNS 接管、默认路由和第一条错误日志。只有确认本地接管正常后,才适合对比节点或出站。

sing-box 启动后只有域名打不开,IP 地址测试正常,是什么问题?

优先排查 DNS,而不是 MTU 或节点。检查 DNS server、DNS rule、final、TUN 的 dns_mode,以及是否有 DNS 劫持或 DNS 请求超时。确认 DNS 能解析后,再检查解析结果对应的出站连接。

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

不能默认这样判断。sing-box 官方配置格式是 JSON,Clash YAML 与 sing-box JSON 不是同一种配置格式。导入前确认客户端是否提供转换或订阅解析功能;如果没有,应使用适配 sing-box 的配置,并先通过客户端检查或 sing-box check 验证。

开启 TUN 后断网,关闭 TUN 后恢复,应该先检查什么?

先检查 TUN 权限、虚拟接口和 auto_route;然后检查 DNS 接管、路由排除项和是否存在其他 VPN 或代理冲突。不要一开始同时改 route、DNS、MTU 和节点,建议一次只改一个变量并记录结果。

sing-box 配置没有明显报错,但启动后还是没有网络,怎么办?

配置能启动不等于流量能转发。继续确认实际运行模式、连接日志、请求是否出现、请求命中了哪个规则、DNS 是否成功以及 outbound 是否发生超时或握手失败。若关闭后直连仍异常,先清理系统代理、其他 VPN 或残留网络接管。

分享 sing-box 日志排查时,哪些内容必须打码?

订阅地址、UUID、密码、令牌、私钥、服务器地址、完整节点参数和远程配置 URL 都应打码。可以保留操作系统、客户端类型、运行模式、错误关键词、时间和是否能恢复直连等必要信息。

相关阅读

参考资料

  1. sing-box 配置说明:JSON、check 与 format
  2. sing-box TUN 入站配置:auto_route、DNS、auto_redirect 与 strict_route
  3. sing-box Route 配置:默认网卡、路由与 Android VPN
  4. sing-box DNS 配置:DNS server、rules、final 与策略
  5. sing-box Android 客户端功能与 TUN/VpnService 说明