Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

开启 TUN 后本地服务无法访问

有些软件会在电脑上启动一个本地服务,可以通过浏览器或其他程序访问它

比如开发服务器、软件的管理页面,以及登录时跳回本机的回调页面

如果在代理软件中开启了 TUN 模式,可以尝试关闭代理软件的 TUN 模式

Note

本文默认系统为 Windows 10/11

现象

  • 浏览器访问 http://localhost:目标服务端口,提示连接被拒绝(ERR_CONNECTION_REFUSED)、连接重置(ERR_CONNECTION_RESET),或者一直转圈
  • 软件明明已经启动,使用 netstat -ano 调查发现端口又被正确监听,但本地管理页面却打不开
  • 开启 TUN 后出问题,关闭 TUN 后恢复;也可能只有 localhost 不能用,换成 127.0.0.1 就能用

Tip

最快的临时处理就是关闭 TUN,再重新尝试一次。如果不需要 TUN,也可以改用系统代理模式;不过部分程序不读取系统代理设置,之后需要确认它们还能不能正常联网

不过绝大多数软件都会优先读取HTTP_PROXY / HTTPS_PROXY环境变量,优先设置这两个变量是好习惯

本地回环地址

让电脑通过网络接口的方式访问自己

地址含义
127.0.0.1最常用的 IPv4 回环地址,IPv4 回环网段是 127.0.0.0/8
::1IPv6 回环地址
localhost本机使用的特殊域名,通常解析为 127.0.0.1 或 ::1

例如 http://127.0.0.1:3000,就是访问本机 3000 端口上的 HTTP 服务。这里的 3000 只是举例,实际端口以软件给出的地址为准

localhost、127.0.0.1 和 ::1 都指向本机,但访问同一个服务时,结果不一定相同。比如程序只监听了 127.0.0.1:3000,客户端却尝试连接 [::1]:3000,就可能连接失败

Tip

IPv6 地址放进网址时要加方括号,例如 http://[::1]:3000,否则地址和端口分不清

为什么开了 TUN 会出问题

系统代理主要是告诉应用“请求可以交给这个代理端口”,而 TUN 则通过虚拟网卡和路由设置接管流量,影响范围更大

本地服务异常可能发生在几个地方:

  • 解析出了不合适的地址:例如本地域名被返回了 Fake IP(代理软件分配的占位地址或者 Host 文件被篡改),或者优先使用了服务没有监听的 IPv6 地址
  • 路由或过滤规则影响了连接:严格路由、虚拟网卡,以及其他 VPN 的设置可能互相干扰
  • 应用自己还独立设置了代理:即使关掉系统代理,浏览器插件、软件内的代理设置或环境变量仍可能生效

排查方法

确认服务运行

保持本地服务运行,只关闭 TUN,访问原来的地址’

如果依然打不开,先检查软件是否正常启动、地址和端口是否填对

如果是偶发问题,可以再开关一次 TUN 对照,每次只改一项设置,避免把服务重启后的恢复误认为是配置生效

netstat -ano | findstr :3000

其中 3000 替换为实际端口。没有找到记录时,先检查服务是否启动、端口是否改变

测试域名、IPv4 和 IPv6

如果是 HTTP 服务,在 PowerShell 中执行:

curl --noproxy "*" --max-time 5 -v "http://localhost:3000/"
curl --noproxy "*" --max-time 5 -v "http://127.0.0.1:3000/"
curl -g --noproxy "*" --max-time 5 -v "http://[::1]:3000/"

替换成软件实际使用的协议、端口和路径,开启和关闭 TUN 时各测一次

Note

--noproxy "*" 表示这次请求不使用 curl 的显式代理,不会绕过 TUN

测试结果优先排查方向
关闭 TUN 仍然全部失败服务状态、监听地址、端口、协议是否正确
127.0.0.1 成功,localhost 失败域名解析结果、是否尝试了 ::1、应用代理设置
IPv4 正常,IPv6 失败服务是否监听 IPv6,TUN 是否影响 IPv6 回环连接
同一个地址关闭 TUN 成功,开启后失败严格路由、路由排除、代理日志、其他 VPN 或虚拟网卡
curl 正常,只有浏览器或某个软件失败该软件自己的代理设置、插件及具体报错

能收到 HTTP 响应,即使是 404,也说明已经有 HTTP 服务响应了请求;接下来应检查路径和应用行为。如果是连接被拒绝或超时,再继续检查连接本身

Tip

ping 通不代表服务可用!ping 测的是 ICMP,网页使用的是 TCP/HTTP,要测实际端口和请求

解决方式

临时关闭 TUN 或者关闭严格路由

不需要 TUN 时,直接关闭即可

如果仍然需要 TUN,可以保持 TUN 开启,单独关闭严格路由 / Strict Route再测试

Note

严格路由在 Windows 上包含防止 DNS 泄漏的处理,关闭后相关行为也会改变,如果没有改善就改回原值

处理 localhost 的解析问题

如果直接访问 127.0.0.1 能用,而 localhost 不能用,先看连接日志中的实际地址

如果得到的是 Fake IP,检查 DNS 设置 / Fake IP 过滤,将 localhost 和需要使用的本地域名排除

如果使用了自己定义的本地域名,也要检查 hosts 映射,以及代理内核是否读取系统 hosts

只有某个软件失败

检查浏览器代理插件、软件内的 HTTP/SOCKS 代理,以及 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 等环境变量

支持 NO_PROXY 的软件,可以把 localhost,127.0.0.1,::1 加入其代理绕过列表。但这个变量只对读取它的软件有效

如果命令行能访问,浏览器却提示证书、跨域或权限错误,继续按对应报错处理,这不是 TUN 的问题

修改后仍然无效

ipconfig /flushdns 清理 Windows DNS 缓存,应用自身的缓存可能仍需重启应用才会清除,暂时退出其他和网络相关的软件,再做对照

Warning

不要为了让本地页面能打开,就把服务监听地址一律改成 0.0.0.0,这可能使同一局域网里的其他设备也能访问它。也没必要一上来就关闭整个防火墙或重置网络