sing-box 启动后没有网络:按故障层级排查 TUN、DNS 和路由
简答:sing-box 启动后没有网络,先停止 sing-box,确认系统直连是否恢复;如果恢复,再区分是系统代理、TUN 接管、DNS 解析、路由规则还是节点出站失败。不要一开始反复换节点,先用日志和单变量测试定位具体层级。
定义:“sing-box 启动后没有网络”是指配置已经启动或客户端显示运行中,但浏览器、应用或终端无法正常建立连接,原因可能发生在系统代理、TUN/VPN、DNS、路由、权限或出站节点中的任一层。
先做 30 秒分流:停止、恢复、判断故障范围
本站是第三方使用指南站,不代表 sing-box 或任何客户端官方。遇到启动后断网,先不要修改多个字段,也不要马上更换订阅。
- 停止 sing-box,关闭 TUN、VPN 或系统代理接管。
- 测试系统直连:打开一个平时可访问的网站,或使用系统网络诊断功能。
- 根据结果分流:直连仍然断网,先排查系统网络、其他 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 客户端功能说明。
- 先确认客户端当前到底开启了系统代理、TUN、VPN还是命令行模式。
- 如果系统代理模式下可用、TUN 模式下断网,优先检查 TUN 权限、虚拟接口、自动路由和 DNS 接管。
- 如果 TUN 模式关闭后仍残留断网,检查系统代理是否还指向旧端口,以及其他 VPN 是否仍处于连接状态。
- 如果使用 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 配置文档。
| 检查项 | 适合判断的问题 | 处理方式 |
|---|---|---|
auto_route | 流量是否被自动导向 TUN | 确认配置是否启用,以及系统是否真的创建了对应路由 |
auto_redirect | Linux 下透明接管与路由冲突 | 只在当前平台和内核支持时按官方说明启用,不要跨平台照搬 |
strict_route | 严格路由、未支持网络和部分 DNS 行为 | 若开启后特定应用失效,记录现象并暂时回滚该项测试 |
dns_mode | TUN 是否配置平台 DNS 或劫持 DNS | 根据当前版本支持情况检查 disabled、native 或 hijack |
route_exclude_address | 局域网、网关或本地地址是否被错误接管 | 核对局域网网段和实际网络,不要凭经验填写陌生网段 |
需要特别注意版本差异:TUN 文档显示部分字段是在不同版本中加入或调整的,因此旧配置中的字段名、默认行为和客户端界面可能不一致。资料没有明确说明的平台行为,不要直接推断为所有 Windows、macOS、Linux 或 Android 都相同。
如果 TUN 一启动就全局断网,建议按这个顺序回滚:先关闭 TUN 保留系统代理测试;再关闭 DNS 劫持或改回客户端默认 DNS 测试;最后才检查自定义路由和 MTU。每次只改一个变量,并记录改动前后的结果。
DNS 失败怎么判断:区分解析失败和节点连接失败
“网页打不开”不一定是节点失败。可以先判断域名解析是否成功,再判断解析出的地址能否通过当前出站建立连接。
- 停止 sing-box,确认系统 DNS 能否解析常用域名。
- 启动 sing-box 后,使用系统 DNS 测试工具,例如 Windows 的
nslookup example.com;macOS 和 Linux 也可使用系统中可用的 DNS 查询工具。 - 如果启动后查询超时或服务器不可达,查看日志中是否出现
dns、hijack、timeout、permission denied等关键词。 - 如果 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 配置文档。
- 确认节点已选中:客户端显示配置已加载,不代表实际出站已经选择了可用节点或正确的 selector。
- 看连接日志:区分连接超时、TLS 握手失败、认证失败、地址解析失败和被规则拒绝。
- 检查规则顺序:过早命中 direct 或 block,可能造成部分网站失败;规则调整后必须重新测试同一个目标。
- 检查 IPv4/IPv6:如果只有部分网络失败,可分别测试 IPv4 和 IPv6,不要直接把 MTU 当成首要原因。
- 检查路由循环:TUN 接管后,出站连接必须避免再次被自己的 TUN 接管。官方文档建议通过自动检测网卡、默认网卡或出站绑定网卡等方式避免循环。
如果只有某一个节点失败,先用同一配置中的其他已知可用出站做对照;如果所有节点都失败,优先怀疑本地接管、DNS、规则或配置格式,而不是直接认定所有节点都不可用。
按系统做最后复测:Windows、macOS、Linux、Android
| 平台 | 优先查看 | 回滚方式 |
|---|---|---|
| Windows | 系统代理开关、VPN 状态、虚拟网卡、DNS、默认路由和防火墙提示 | 停止 TUN,关闭系统代理,断开其他 VPN 后恢复网络 |
| macOS | 网络设置中的代理、VPN、DNS、接口顺序和客户端权限 | 关闭代理或 VPN 配置,重新连接当前网络 |
| Linux | TUN 接口、路由表、策略路由、nftables/iptables、systemd-resolved 和权限 | 停止进程并撤销客户端创建的网络规则;无法确认时重启网络服务或设备 |
| Android | VPN 权限、其他 VPN、分应用规则、省电限制和当前 Wi-Fi/移动网络 | 断开 VPN,关闭始终开启 VPN,再重新测试普通网络 |
这些入口会因系统版本、客户端封装和权限模型不同而变化。复测时只保留一个网络入口:例如先只开系统代理,不开 TUN;或者只开 TUN,不叠加其他 VPN。确认一个模式正常后,再逐项恢复高级功能。
MTU 只在特定现象下检查:如果 DNS、连接握手和小页面正常,但大页面、文件传输或特定协议反复卡住,才考虑 MTU 或路径分片问题。不要因为启动后断网就直接修改 MTU。
修复后的验证与回滚清单
- 停止 sing-box,确认直连恢复。
- 重新启动配置,确认客户端没有新的 TUN、DNS、route 或 permission 错误。
- 先测试域名解析,再测试一个普通网页,最后测试原本失败的应用或网站。
- 检查连接记录是否出现实际请求,确认请求没有全部命中 block 或 direct。
- 记录当前有效配置和改动项,避免下一次故障无法回退。
如果修改后问题更严重,按相反顺序回滚:恢复原配置文件,关闭自定义 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 都应打码。可以保留操作系统、客户端类型、运行模式、错误关键词、时间和是否能恢复直连等必要信息。