翻墙侠 - 自由上网的好帮手

sing-box TUN 开启后断网怎么办?先恢复网络,再用 4 步定位

更新于 2026-11-12 · fanqiangxia.top

简答:刚开启 sing-box TUN 就断网时,先关闭 TUN、系统代理和其他 VPN;如果 GUI 关闭后仍断网,再结束 sing-box 核心进程或服务。随后分别测试网关、公共 IP、DNS 和 TCP 443,再根据“全局断网、域名失败、部分应用失败、仅节点失败”进入对应分支。

定义:sing-box TUN 模式是通过虚拟网卡接管系统流量的运行方式,开启后断网通常需要从虚拟网卡、默认路由、DNS、回环、权限、网络冲突和节点链路中逐层定位。

先做 30 秒急救:区分 TUN 开启时与关闭后的结果

如果你刚打开 sing-box TUN 后立即无法上网,先不要同时修改多个配置字段。本文为第三方使用指南,与 sing-box 及任何客户端官方无关。

  1. 先关闭 sing-box 的 TUN 开关,并关闭系统代理、其他 VPN、虚拟机网络工具和可能接管流量的安全软件。
  2. 如果 GUI 已关闭但网络仍然中断,打开 Windows 任务管理器结束仍在运行的 sing-box 进程;如果它以服务运行,在“服务”中停止对应服务。Linux 使用终端管理员权限执行 sudo systemctl stop sing-box。
  3. 记录 TUN 关闭后的测试结果,再重新开启 TUN 复测。不要把“代理端口没有监听”直接判断成电脑底层断网。
现象入口测试时状态检查方法优先进入
全局断网分别测试 TUN 关闭、开启网关、公共 IP、DNS、TCP 443默认路由、虚拟网卡、权限和网络冲突
只有域名失败TUN 开启nslookup example.comDNS 模式、DNS 劫持和上游 DNS
只有部分应用失败TUN 开启比较浏览器、终端和目标 App分应用规则、系统代理、IPv6、MTU 或应用自身代理
只有节点或代理出站失败TUN 关闭后也测试先测试普通网络,再测试节点 TCP 连接节点地址、端口、TLS、认证和出站配置

Windows 可先运行 ipconfig /all,在输出中找到当前物理网卡的“默认网关”;也可以运行 Get-NetRoute -DestinationPrefix 0.0.0.0/0 查看默认路由。不要固定使用 192.168.1.1,实际网关可能是其他地址。Microsoft 的 DNS 排查文档也建议先核对 IP、默认网关和 DNS 服务器,再使用 nslookup 测试解析,详见 Windows DNS 客户端排查文档。

测试Windows 命令正常时可观察到异常时说明
当前网关Get-NetRoute -DestinationPrefix 0.0.0.0/0存在有效的默认路由和接口可能是路由未恢复或接口选择错误
网关连通性ping 网关地址收到回复,或至少没有立即报错可能是局域网、网卡或路由问题;ICMP 被禁用时不能单独下结论
公共 IPping 1.1.1.1能到达公共 IP可能是默认路由、节点或防火墙问题
DNSnslookup example.com返回解析服务器和地址记录检查 DNS 配置、劫持规则和上游连接
TCP 443Test-NetConnection example.com -Port 443TcpTestSucceeded : True可能是 TCP、节点、MTU、防火墙或目标站点问题

按现象判断:全局断网、DNS 失败、部分应用失败还是节点失败

全局断网:如果 TUN 开启时网关也不通,而关闭 TUN 后恢复,优先检查 TUN 虚拟网卡、默认路由、权限和其他网络接管工具。先不要改 DNS;DNS 只能解释域名失败,不能解释网关本身不可达。

只有域名失败:如果 ping 1.1.1.1 或其他公共 IP 可达,但 nslookup example.com 失败,重点查看 TUN 的 DNS 处理方式。当前 sing-box testing 分支 TUN 文档将 dns_mode 和 dns_address 标为 1.14.0 相关字段,其中 hijack 会额外处理 DNS 流量;稳定版、旧核心或第三方 GUI 是否支持这些字段,需以所用版本文档和实际生成配置为准,不能仅凭 testing 分支判断,详见 sing-box TUN 配置文档。

只有部分应用失败:比较浏览器、终端和目标 App 的结果。如果浏览器能开而某个 App 不通,检查分应用规则、应用自身代理、IPv4/IPv6、系统代理继承方式和电池后台限制。Android 还要确认 VPN 授权、分应用代理以及“始终开启 VPN”或“阻止未使用 VPN 的连接”等系统选项。

只有节点或代理出站失败:关闭 TUN 后,如果普通网络可以访问,但 sing-box 节点仍连接失败,故障重点在节点域名或 IP、端口、TLS、认证、时间同步和出站配置,不应继续批量修改 TUN 路由。先运行 sing-box check,再查看首条明确的 ERROR 或 FATAL 日志。

冲突排查顺序:先停流量接管,再查虚拟网卡和防火墙

多个组件同时接管流量时,建议按“最容易恢复、影响范围最大”的顺序排查。每停用一项就测试一次,确认冲突来源后再恢复其他组件。

  1. 第一优先级:其他 VPN 和系统代理。关闭其他 VPN,关闭 Windows、macOS 或桌面环境中的 HTTP、HTTPS、SOCKS 系统代理。TUN 接管的是系统流量,系统代理则改变应用连接到本地代理端口的方式,两者同时启用可能让不同应用走不同路径。
  2. 第二优先级:残留的 sing-box 核心、服务和路由。GUI 关闭不代表核心进程、服务、虚拟网卡或策略路由已经消失。Windows 用任务管理器、服务管理器和 route print 复查;Linux 用 ps、ip route、ip rule 复查。
  3. 第三优先级:其他虚拟网卡。检查 Hyper-V、WSL、VMware、VirtualBox、Wintun、TAP 和其他 VPN 网卡。Windows 可运行 Get-NetAdapter 查看接口名称、状态和链路速度;不要因为某个虚拟网卡存在就直接删除,先记录名称和状态。
  4. 第四优先级:Docker Desktop 和 Linux 网桥。在 Linux 上,如果启用了 auto_redirect,官方 TUN 文档说明它依赖 nftables,并用于改善路由、性能以及 TUN 与 Docker bridge 网络的冲突。当前版本是否支持该字段,仍需以实际版本文档为准。
  5. 第五优先级:防火墙和安全软件。如果网关和公共 IP 正常,但 TCP 443 失败,临时检查防火墙日志、网络过滤驱动和安全软件拦截记录。不要为了测试长期关闭防火墙,测试后立即恢复原设置。
冲突对象判断方式安全处理
系统代理浏览器失败但终端直连正常,或代理端口没有监听关闭系统代理后重新测试
其他 VPN关闭 sing-box 后仍有 VPN 图标或 VPN 接口断开其他 VPN,再复查默认路由
虚拟机网卡默认路由接口指向虚拟接口,或启用后才断网暂时停用虚拟机网络,记录原状态
Docker 网桥宿主机或容器网络在启用 TUN 后同时异常先停止相关容器,确认是否为网桥冲突
防火墙接口和路由正常,但 TCP 连接被拒绝或超时查看拦截日志,不直接批量重置规则

分平台命令:Windows、Linux、macOS、Android 怎么看结果

Windows

  1. 查看网卡:Get-NetAdapter。确认物理网卡和 TUN 或虚拟网卡状态。
  2. 查看地址和 DNS:ipconfig /all。确认物理网卡有有效 IP、默认网关和 DNS 服务器。
  3. 查看路由:route print 或 Get-NetRoute -DestinationPrefix 0.0.0.0/0。TUN 关闭后,默认路由不应继续指向已经停止的接口。
  4. 执行分层测试:ping 网关地址、ping 1.1.1.1、nslookup example.com、Test-NetConnection example.com -Port 443。

正常输出的重点不是每次都必须收到 ping 回复,而是默认网关、DNS 和路由接口是否与当前网络一致,以及 TCP 测试是否成功。某些网络会阻止 ICMP,所以 ping 失败时要结合 Test-NetConnection 判断。

Linux

  1. ip addr:确认物理接口有地址,TUN 接口是否存在。
  2. ip route:确认存在默认路由,并记录它使用的接口。
  3. ip rule:确认是否残留由 TUN 或策略路由创建的规则。
  4. resolvectl status:确认当前 DNS 服务器和接口。
  5. sudo nft list ruleset:查看是否存在与透明转发或 DNS 处理有关的规则。
  6. sudo journalctl -u sing-box -b --no-pager:查看本次启动的服务日志。

正常情况下,TUN 关闭并停止服务后,物理接口仍有地址和默认路由;如果 ip rule 或 ip route 仍有明显属于 TUN 的内容,先保存输出,再确认创建者,不要直接删除未知规则。

macOS

  1. 执行 route -n get default,查看默认路由使用的接口。
  2. 执行 scutil --dns,查看当前 DNS 解析器。
  3. 在系统设置的网络代理页面确认 HTTP、HTTPS 和 SOCKS 代理没有残留。
  4. 如果客户端使用网络扩展或 VPN 权限,重新打开时确认系统授权状态。菜单名称可能随 macOS 版本和客户端界面变化,以当前界面为准。

Android

  1. 确认 sing-box 的 VPN 授权仍然有效。
  2. 检查分应用代理,确认测试应用没有被排除或错误地加入排除列表。
  3. 检查“始终开启 VPN”和“阻止未使用 VPN 的连接”等系统设置。
  4. 暂时取消电池优化或后台限制,避免客户端被系统挂起后留下异常网络状态。

sing-box TUN 文档明确写有 Android VPN 的路由优先级说明:默认情况下 VPN 优先于 TUN;如果需要让 TUN 流量经过 VPN,应根据文档和实际配置判断是否启用 route.override_android_vpn,不要直接把桌面端配置照搬到 Android,详见 TUN 配置中的 Android VPN 说明。

配置、日志与可逆回滚:一次只改一个变量

修改前先复制配置文件。配置中可能包含订阅链接、节点地址、UUID、密码、私钥或其他凭据,分享配置和日志前应打码,不要公开完整订阅链接或明文密码。

  1. 先运行 sing-box check,或按当前版本支持的参数指定配置文件。该命令用于检查配置能否被核心加载,但不代表 TUN、DNS、路由、节点和 TCP 链路运行正常,命令说明见 sing-box 配置文件与 check 文档。
  2. 临时把日志等级改为 debug,并保留时间戳。官方日志文档列出的等级包括 trace、debug、info、warn、error 和 fatal,可参考 sing-box 日志配置文档。
  3. 先只保留一个 TUN 入站、一个可确认工作的出站和最基础的路由,确认 TUN 关闭时普通网络与出站都能工作。
  4. 再逐项恢复 auto_route、DNS 处理、auto_redirect、strict_route、不同 stack 和 MTU。每次只改一个变量。
  5. 排查回环时检查 route.auto_detect_interface、route.default_interface 或出站的 bind_interface。官方文档建议这些设置用于避免流量回到 TUN 自身。
  6. MTU 不应作为第一步修改。只有在部分网站卡住、TLS 握手超时、长连接中断而小数据仍可用时,才逐次调整,并保留原始值方便回退。

如果关闭 GUI 后仍断网,Windows 可先禁用再启用物理网卡,随后重启系统并用 route print、ipconfig /all 复查;Linux 可停止 sing-box 服务,重启 NetworkManager 后再次检查 ip addr、ip route 和 ip rule。这些操作可能影响其他网络连接,因此应先保存原始输出,不要直接批量删除路由、重置防火墙或执行网络重置命令。

如果你观察到 Windows 11 上 TUN 运行一段时间后出现接口未就绪、或特定 stack 无法转发的现象,可以把完整错误、系统版本、核心版本、客户端版本和配置变更记录下来,再对照公开 Issue。Issue 只能说明某个用户报告过该现象,不能直接推导出适用于所有设备的修复方案,参考 sing-box TUN 断流 Issue 和 Windows 11 TUN 转发 Issue。

恢复后怎么继续排查

如果四层测试显示只有域名失败,可继续查看 DNS 配置排查步骤;如果 Windows 的系统代理残留或端口异常,再参考 系统代理无法上网排查步骤。若多种网络接管机制同时异常,可进入 连接问题排查,按底层网络、DNS、代理和节点顺序继续定位。

推荐回滚顺序是:恢复备份配置、关闭 TUN、停止仍在运行的核心进程或服务、确认默认路由和 DNS 恢复,再逐项重新启用功能。不要在没有记录原始输出的情况下批量删除路由或重置网络组件。

常见问题

sing-box TUN 开启后全局断网,第一步是什么?

先关闭 TUN、系统代理和其他 VPN;如果 GUI 关闭后仍断网,再结束 sing-box 核心进程或服务。确认网关、公共 IP、DNS 和 TCP 443 的结果后,再判断是路由、DNS、虚拟网卡、冲突还是节点问题。

sing-box check 通过,为什么仍然无法上网?

check 主要验证配置能否被核心加载,不会替代虚拟网卡、默认路由、DNS、节点和 TCP 运行时测试。因此仍要查看 debug 日志,并使用 ping、nslookup、Test-NetConnection 或 Linux 对应命令分层验证。

dns_mode 和 dns_address 能不能直接添加?

不能直接假设所有版本都支持。当前 testing 分支 TUN 文档将它们标为 sing-box 1.14.0 相关字段,旧核心或第三方 GUI 可能无法识别,应以实际核心版本文档和客户端生成的配置为准。

strict_route 会不会导致 Windows 开启 TUN 后断网?

可能影响部分路由和 DNS 行为,但不能仅凭字段名称判定根因。先导出客户端生成的实际配置,记录字段当前值,再逐项关闭或恢复,并结合日志、默认路由和 DNS 测试判断。

TUN 能启动但网页一直转圈,要先改 MTU 吗?

不建议。先测试公共 IP、DNS 和 TCP 443,再检查出站回环、DNS 处理、节点和防火墙。只有部分网站卡住、TLS 握手超时或长连接中断时,才逐次调整 MTU 并保留原值。

关闭 GUI 后仍然断网怎么办?

核心进程、服务、虚拟网卡或路由规则可能仍然存在。Windows 检查任务管理器、服务管理器和 <code>route print</code>;Linux 执行 <code>sudo systemctl stop sing-box</code>,再检查 <code>ip route</code> 和 <code>ip rule</code>。必要时重启网络服务或系统后复查,不要直接删除未知路由。

相关阅读

参考资料

  1. sing-box TUN 配置文档
  2. sing-box 日志配置文档
  3. sing-box 配置文件与 check 命令文档
  4. Microsoft Learn:Windows DNS 客户端排查
  5. sing-box Issue:TUN 运行后断流与接口错误报告
  6. sing-box Issue:Windows 11 TUN 转发问题报告