FacMata 欢迎页 | Welcome

sing-box TUN 模式无法连接怎么办?按启动、DNS、路由逐步排查

更新于 2026-11-03 · facmata.site

简答:先停止 TUN,确认系统直连恢复,再只修改一个变量排查:先做配置检查和版本记录,然后看 TUN 是否创建、DNS 是否可用、路由是否回环,最后验证节点出站与 MTU。sing-box 的 TUN 行为受系统、客户端、内核版本和权限影响,不能把“配置检查通过”当成“网络已经可用”。

定义:sing-box TUN 模式是通过虚拟网卡接管系统流量,再依据路由规则转发到指定出站的透明代理工作方式。

先看症状:不要一上来反复改配置

本文是面向 sing-box 用户的第三方使用参考,不是任何客户端或服务的官方页面。先把现象归类,再选择最短路径。假如你开启 TUN 后整台设备断网,第一步不是更换节点,而是停止 TUN 并确认普通网络是否恢复。

sing-box TUN 故障快速分流
现象先检查预期判断优先回滚
TUN 一启动就报错或自动停止权限、VPN 授权、虚拟网卡、配置检查日志中不再出现创建接口或权限错误关闭 TUN,恢复系统代理或直连
TUN 启动成功但全局没网auto_route、auto_detect_interface、default_interface、路由回环能访问直连地址,路由表存在预期 TUN 路由关闭 auto_route 或停止 TUN
只有域名打不开,IP 测试正常dns_mode、dns_address、DNS 出站和 hijack-dns域名解析得到响应,日志不再出现 DNS timeout暂时改为较简单的 DNS 模式或关闭 TUN
只有部分应用不能连接系统代理、应用自带 DNS、IPv6、strict_route 和分流规则同一应用在直连、TUN 两种模式下现象可区分关闭 strict_route 或按应用回退
运行一段时间后断流节点出站、连接日志、MTU、睡眠恢复和其他 VPN重连后日志能看到新的出站连接停止其他 VPN,恢复原 MTU 和原配置

官方 TUN 文档说明,auto_route 会把默认路由设置到 TUN;为避免流量回环,需要配置自动探测接口、默认接口或出站绑定接口。Linux 上还可使用 auto_redirect 改善路由处理,但它只适用于启用 auto_route 的 Linux 场景。参见 sing-box TUN 配置文档。

最短可复制排查流程:先恢复,再定位

  1. 停止 TUN。 在客户端关闭 TUN 或退出 sing-box,确认浏览器、系统更新和普通 DNS 是否恢复。若停止后仍断网,先检查系统代理、其他 VPN、虚拟网卡和残留路由,不要继续叠加 sing-box 配置。
  2. 记录环境。 记下操作系统、客户端类型、TUN 栈、实际运行内核版本、首次报错时间,以及日志中的第一条 error 或 warn。版本不要凭文件名推断;从客户端关于页面、运行日志或发行包实际输出核对。官方文档中部分 TUN 字段标注了引入版本,例如 dns_mode、dns_address 自 sing-box 1.14.0 起提供,因此旧内核不能照搬新字段。
  3. 检查配置格式。 在实际配置所在环境运行 sing-box check。它用于发现 JSON、字段和配置结构问题,但不能证明节点端口可达、DNS 出站可用、路由正确或 TUN 已经接管流量。配置检查命令见 sing-box 配置说明。
  4. 只启动 TUN 一次并看第一条错误。 如果提示权限、接口创建失败、VPN 授权失败或地址冲突,先处理这一层;不要同时改 DNS 和出站。Windows 可能需要管理员权限,Android 需要系统 VPN 授权,Linux 可能需要相应网络权限,macOS 则取决于客户端提供的系统扩展或网络权限。
  5. 复测三类结果。 依次测试一个已知可访问的 IP、一个域名和实际目标应用。IP 成功而域名失败,优先查 DNS;两者都失败,查路由或出站;基础访问成功但单个应用失败,查应用代理、IPv6、分流或应用自己的网络策略。

日志可先临时提高到 debug,记录复现期间的 TUN、DNS、route、dial 和 outbound 信息;排查结束后恢复 info,避免长期产生过多日志。日志字段和级别以 sing-box 日志配置文档为准。

按故障层排查:权限、DNS、路由和出站

1. TUN 接口没有创建或启动即退出

先确认客户端是否真的获得系统权限,以及虚拟网卡是否出现并处于启用状态。Windows 可在“网络连接”或“设备管理器”查看新出现的虚拟适配器;Linux 可执行 ip link;macOS 可查看网络接口列表;Android 则看 VPN 授权提示和客户端状态。接口不存在时,优先处理权限、客户端安装组件或接口冲突,不要先改节点参数。

2. TUN 启动后全局断网

重点检查 auto_route 与回环规避。官方文档建议通过 route.auto_detect_interface、route.default_interface 或出站的 bind_interface 避免 sing-box 把自己的出站再次送回 TUN。若配置了 strict_route,Windows 上它可以减少普通多网卡 DNS 泄漏,但也可能影响部分虚拟机或特殊应用;Linux 上则要结合实际路由表判断。

Linux 可执行:

ip link

ip route

ip rule

重点观察:TUN 接口是否存在、默认路由或分裂路由是否出现、规则优先级是否把出站再次导入 TUN。systemd 服务可用 sudo journalctl -u sing-box --output cat -e 查看最近日志,命令来源见 sing-box 安装与服务管理说明。

Windows 可执行:

route print

nslookup example.com

example.com 只是演示占位域名,不能当作你的目标服务测试结论。观察 IPv4、IPv6 默认路由以及 DNS 服务器是否发生变化。Android 还要检查是否有系统 VPN、按应用 VPN 或电池后台限制;Apple 设备则要区分 TUN、系统代理和网络扩展权限。

3. 只有 DNS 失败

从 dns_mode、dns_address、DNS 出站和端口 53 劫持关系开始查。官方文档列出 disabled、native 和 hijack 三种模式;启用 auto_route 时,hijack 通常是默认行为。若 DNS 日志显示 timeout,先确认 DNS 出站本身能建立连接,再检查 DNS 地址是否被路由回 TUN。一次只切换一个模式,成功后记录差异再决定是否保留。

4. DNS 正常但节点出站失败

这时 TUN 和 DNS 可能都正常,故障在代理出站或服务器连接层。检查节点地址、端口、TLS 参数、证书名称、认证字段、系统时间和 IPv4/IPv6 选择。不要把延迟测试成功等同于目标应用可用;至少要在日志中看到实际出站建立连接,并通过目标应用复测。

平台差异与冲突项:每次只改一个变量

  • Windows:优先看管理员权限、虚拟网卡、route print、系统代理和其他 VPN。若启用 strict_route 后虚拟机或特殊程序异常,记录现象后临时关闭并复测;官方文档明确提示它可能影响部分 VirtualBox 等应用。
  • Linux:优先看用户权限、ip link、ip route、ip rule、nftables 和 Docker 网桥。官方文档推荐 Linux 使用 auto_redirect,但它需要相应内核支持,并且与某些标记和路由设置存在冲突。
  • macOS:确认网络扩展或 VPN 权限、系统代理是否重复接管,以及 IPv6 和睡眠恢复后的接口状态。不同客户端形态提供的权限和菜单可能不同,以当前客户端显示为准。
  • Android:确认 VPN 授权、后台运行、电池优化和按应用规则。官方 Android 客户端文档说明,TUN 需要通过 VpnService 等平台能力运行,具体可用项还会受客户端覆盖配置影响,参见 Android 客户端功能说明。
  • Docker、虚拟机和其他 VPN:先全部停止非必要的网络接管组件,再启动 sing-box。若恢复正常,一次只重新开启一个组件,观察路由表、DNS 和接口是否变化。
  • MTU 与 IPv6:当网页部分加载、长连接频繁断开或 IPv6 单独失败时,先记录当前 MTU 和地址族状态,再临时只禁用 IPv6 或恢复原 MTU。不要直接套用他人的数值,因为链路、系统和出站协议不同。

配置修改前复制原文件作为回滚版本。每次修改后执行配置检查、启动、三类网络复测;失败就恢复上一份配置,而不是连续修改多个字段。

如何确认修复成功:复测标准与回滚

  1. 停止 TUN 后,系统直连网络可以恢复,说明基础网络没有被残留代理或路由破坏。
  2. 重新启动 TUN 后,虚拟接口存在,客户端状态保持运行,日志没有新的接口、权限或 DNS fatal 错误。
  3. 用 IP、域名和目标应用分别测试:IP 用于区分路由,域名用于判断 DNS,目标应用用于确认真实业务链路。
  4. 检查日志是否出现预期的 DNS 请求、路由匹配和出站连接;不能只看客户端显示“已连接”。
  5. 关闭 sing-box 后再次测试系统直连。若关闭后仍无法联网,回滚系统代理、VPN、路由和 DNS 变更,再重启网络适配器或设备。

如果问题只在某个内核版本、特定 TUN 栈、特定 Linux 内核或某个客户端出现,应在反馈中同时提供系统、架构、实际版本、最小配置和第一条错误日志。不要把单一环境现象扩大为所有 sing-box 用户都会遇到的问题。

常见问题

sing-box TUN 开启后完全没网,第一步该做什么?

先停止 TUN,确认系统直连恢复。如果直连也没有网络,先处理系统代理、其他 VPN、残留路由或虚拟网卡;如果直连恢复,再回到 sing-box 检查权限、auto_route、接口探测和 DNS。

sing-box check 通过后,为什么仍然无法连接?

sing-box check 主要检查配置结构、字段和格式,不能证明节点端口可达、DNS 出站正常、路由没有回环,也不能证明 TUN 已经接管流量。因此还必须看启动日志、路由表和实际网络复测。

dns_mode 应该选 disabled、native 还是 hijack?

没有适合所有设备的固定答案。disabled 不配置原生 DNS,也不劫持 DNS;native 尝试设置系统或接口 DNS;hijack 在 native 基础上处理端口 53 流量。应根据实际版本、平台和 DNS 日志逐一测试,避免直接复制其他配置。

Windows 上 strict_route 要不要关闭?

如果启用后 DNS 更稳定且应用正常,可保留;如果虚拟机或特殊网络程序无法连接,可临时关闭并复测。官方文档明确提示 strict_route 在 Windows 上可能影响部分应用,因此应以实际现象决定。

Linux 上为什么建议检查 auto_redirect?

官方文档说明 auto_redirect 只支持 Linux 且需要启用 auto_route,它通过 nftables 改善 TUN 路由与性能,并可减少与 Docker 网桥的冲突。但它依赖内核能力,也可能与其他路由标记设置冲突,失败时应查看 nftables、ip rule 和日志。

TUN 能启动但目标应用仍然打不开,是节点问题吗?

不一定。先用 IP、域名和目标应用分层测试:IP 失败优先查路由,域名失败优先查 DNS,只有目标应用失败则检查应用代理、IPv6、分流规则、系统代理和应用自身网络策略。看到延迟或客户端在线状态,不能单独证明目标应用链路正常。

相关阅读

参考资料

  1. sing-box TUN 配置文档
  2. sing-box 配置与检查命令说明
  3. sing-box 日志配置文档
  4. sing-box 安装与服务管理说明
  5. sing-box Android 客户端功能说明