sing-box TUN 开启后断网怎么办?先恢复网络,再用 4 步定位
简答:刚开启 sing-box TUN 就断网时,先关闭 TUN、系统代理和其他 VPN;如果 GUI 关闭后仍断网,再结束 sing-box 核心进程或服务。随后分别测试网关、公共 IP、DNS 和 TCP 443,再根据“全局断网、域名失败、部分应用失败、仅节点失败”进入对应分支。
定义:sing-box TUN 模式是通过虚拟网卡接管系统流量的运行方式,开启后断网通常需要从虚拟网卡、默认路由、DNS、回环、权限、网络冲突和节点链路中逐层定位。
先做 30 秒急救:区分 TUN 开启时与关闭后的结果
如果你刚打开 sing-box TUN 后立即无法上网,先不要同时修改多个配置字段。本文为第三方使用指南,与 sing-box 及任何客户端官方无关。
- 先关闭 sing-box 的 TUN 开关,并关闭系统代理、其他 VPN、虚拟机网络工具和可能接管流量的安全软件。
- 如果 GUI 已关闭但网络仍然中断,打开 Windows 任务管理器结束仍在运行的 sing-box 进程;如果它以服务运行,在“服务”中停止对应服务。Linux 使用终端管理员权限执行
sudo systemctl stop sing-box。 - 记录 TUN 关闭后的测试结果,再重新开启 TUN 复测。不要把“代理端口没有监听”直接判断成电脑底层断网。
| 现象入口 | 测试时状态 | 检查方法 | 优先进入 |
|---|---|---|---|
| 全局断网 | 分别测试 TUN 关闭、开启 | 网关、公共 IP、DNS、TCP 443 | 默认路由、虚拟网卡、权限和网络冲突 |
| 只有域名失败 | TUN 开启 | nslookup example.com | DNS 模式、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 被禁用时不能单独下结论 |
| 公共 IP | ping 1.1.1.1 | 能到达公共 IP | 可能是默认路由、节点或防火墙问题 |
| DNS | nslookup example.com | 返回解析服务器和地址记录 | 检查 DNS 配置、劫持规则和上游连接 |
| TCP 443 | Test-NetConnection example.com -Port 443 | TcpTestSucceeded : 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 日志。
冲突排查顺序:先停流量接管,再查虚拟网卡和防火墙
多个组件同时接管流量时,建议按“最容易恢复、影响范围最大”的顺序排查。每停用一项就测试一次,确认冲突来源后再恢复其他组件。
- 第一优先级:其他 VPN 和系统代理。关闭其他 VPN,关闭 Windows、macOS 或桌面环境中的 HTTP、HTTPS、SOCKS 系统代理。TUN 接管的是系统流量,系统代理则改变应用连接到本地代理端口的方式,两者同时启用可能让不同应用走不同路径。
- 第二优先级:残留的 sing-box 核心、服务和路由。GUI 关闭不代表核心进程、服务、虚拟网卡或策略路由已经消失。Windows 用任务管理器、服务管理器和
route print复查;Linux 用ps、ip route、ip rule复查。 - 第三优先级:其他虚拟网卡。检查 Hyper-V、WSL、VMware、VirtualBox、Wintun、TAP 和其他 VPN 网卡。Windows 可运行
Get-NetAdapter查看接口名称、状态和链路速度;不要因为某个虚拟网卡存在就直接删除,先记录名称和状态。 - 第四优先级:Docker Desktop 和 Linux 网桥。在 Linux 上,如果启用了
auto_redirect,官方 TUN 文档说明它依赖 nftables,并用于改善路由、性能以及 TUN 与 Docker bridge 网络的冲突。当前版本是否支持该字段,仍需以实际版本文档为准。 - 第五优先级:防火墙和安全软件。如果网关和公共 IP 正常,但 TCP 443 失败,临时检查防火墙日志、网络过滤驱动和安全软件拦截记录。不要为了测试长期关闭防火墙,测试后立即恢复原设置。
| 冲突对象 | 判断方式 | 安全处理 |
|---|---|---|
| 系统代理 | 浏览器失败但终端直连正常,或代理端口没有监听 | 关闭系统代理后重新测试 |
| 其他 VPN | 关闭 sing-box 后仍有 VPN 图标或 VPN 接口 | 断开其他 VPN,再复查默认路由 |
| 虚拟机网卡 | 默认路由接口指向虚拟接口,或启用后才断网 | 暂时停用虚拟机网络,记录原状态 |
| Docker 网桥 | 宿主机或容器网络在启用 TUN 后同时异常 | 先停止相关容器,确认是否为网桥冲突 |
| 防火墙 | 接口和路由正常,但 TCP 连接被拒绝或超时 | 查看拦截日志,不直接批量重置规则 |
分平台命令:Windows、Linux、macOS、Android 怎么看结果
Windows
- 查看网卡:
Get-NetAdapter。确认物理网卡和 TUN 或虚拟网卡状态。 - 查看地址和 DNS:
ipconfig /all。确认物理网卡有有效 IP、默认网关和 DNS 服务器。 - 查看路由:
route print或Get-NetRoute -DestinationPrefix 0.0.0.0/0。TUN 关闭后,默认路由不应继续指向已经停止的接口。 - 执行分层测试:
ping 网关地址、ping 1.1.1.1、nslookup example.com、Test-NetConnection example.com -Port 443。
正常输出的重点不是每次都必须收到 ping 回复,而是默认网关、DNS 和路由接口是否与当前网络一致,以及 TCP 测试是否成功。某些网络会阻止 ICMP,所以 ping 失败时要结合 Test-NetConnection 判断。
Linux
ip addr:确认物理接口有地址,TUN 接口是否存在。ip route:确认存在默认路由,并记录它使用的接口。ip rule:确认是否残留由 TUN 或策略路由创建的规则。resolvectl status:确认当前 DNS 服务器和接口。sudo nft list ruleset:查看是否存在与透明转发或 DNS 处理有关的规则。sudo journalctl -u sing-box -b --no-pager:查看本次启动的服务日志。
正常情况下,TUN 关闭并停止服务后,物理接口仍有地址和默认路由;如果 ip rule 或 ip route 仍有明显属于 TUN 的内容,先保存输出,再确认创建者,不要直接删除未知规则。
macOS
- 执行
route -n get default,查看默认路由使用的接口。 - 执行
scutil --dns,查看当前 DNS 解析器。 - 在系统设置的网络代理页面确认 HTTP、HTTPS 和 SOCKS 代理没有残留。
- 如果客户端使用网络扩展或 VPN 权限,重新打开时确认系统授权状态。菜单名称可能随 macOS 版本和客户端界面变化,以当前界面为准。
Android
- 确认 sing-box 的 VPN 授权仍然有效。
- 检查分应用代理,确认测试应用没有被排除或错误地加入排除列表。
- 检查“始终开启 VPN”和“阻止未使用 VPN 的连接”等系统设置。
- 暂时取消电池优化或后台限制,避免客户端被系统挂起后留下异常网络状态。
sing-box TUN 文档明确写有 Android VPN 的路由优先级说明:默认情况下 VPN 优先于 TUN;如果需要让 TUN 流量经过 VPN,应根据文档和实际配置判断是否启用 route.override_android_vpn,不要直接把桌面端配置照搬到 Android,详见 TUN 配置中的 Android VPN 说明。
配置、日志与可逆回滚:一次只改一个变量
修改前先复制配置文件。配置中可能包含订阅链接、节点地址、UUID、密码、私钥或其他凭据,分享配置和日志前应打码,不要公开完整订阅链接或明文密码。
- 先运行
sing-box check,或按当前版本支持的参数指定配置文件。该命令用于检查配置能否被核心加载,但不代表 TUN、DNS、路由、节点和 TCP 链路运行正常,命令说明见 sing-box 配置文件与 check 文档。 - 临时把日志等级改为
debug,并保留时间戳。官方日志文档列出的等级包括trace、debug、info、warn、error和fatal,可参考 sing-box 日志配置文档。 - 先只保留一个 TUN 入站、一个可确认工作的出站和最基础的路由,确认 TUN 关闭时普通网络与出站都能工作。
- 再逐项恢复
auto_route、DNS 处理、auto_redirect、strict_route、不同 stack 和 MTU。每次只改一个变量。 - 排查回环时检查
route.auto_detect_interface、route.default_interface或出站的bind_interface。官方文档建议这些设置用于避免流量回到 TUN 自身。 - 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>。必要时重启网络服务或系统后复查,不要直接删除未知路由。