解决 WSL2 + Windows Hosts + 开启 VPN 后无法访问本地 Web 服务的问题

问题

场景描述

  • 你在 WSL2 中运行了一个 Web 服务(如 Nginx、Go、Php、Node.js 等)

  • Windows 的 hosts 文件中绑定了域名(如 dev.wsl.net -> 172.x.x.x,以便在 Windows 浏览器中访问该服务。

  • 不开 VPN 时一切正常

    ,但一旦开启公司或个人的 全流量接管型 VPN,Windows 就无法解析该域名,导致页面打不开。

本文将详细介绍这个问题的原因,并提供一个简单有效的解决方案:使用 .localhost 域名


🔍 问题描述

✅ 正常情况

  • WSL2 中运行的 Web 服务可以通过绑定的域名(如 http://dev.wsl.net)从 Windows 浏览器访问。

  • 例如,在 Windows 的 hosts 文件中有如下配置:

  1. 172.28.123.45 dev.wsl.net

❌ 开启 VPN 后

  • 开启公司或个人的 全流量接管型 VPN 后,尝试访问 http://dev.wsl.net 会失败,提示"无法访问此网站"或 DNS 解析失败。

🛠️ 导致问题的原因

1. VPN 劫持了所有 DNS 请求

许多企业级或安全型 VPN(如 Cisco AnyConnect、Palo Alto GlobalProtect、OpenVPN 全隧道模式)会:

  • 强制所有 DNS 查询走远程服务器

  • 忽略或绕过本地 C:\Windows\System32\drivers\etc\hosts 文件

  • 启用 DNS over HTTPS (DoH),进一步跳过本地解析。

2. 结果

当开启 VPN 后:

  • 访问 dev.wsl.net → 不再查 hosts → 发送 DNS 请求到远程 → 远程返回"不存在" → 访问失败 ❌

✅ 解决方案:使用 .localhost 域名

根据 RFC 6761,.localhost 域名必须解析为回环地址,且不得通过网络 DNS 查询。因此,它不会被任何远程 DNS 或 DoH 影响。

操作步骤:

1. 修改 Windows 的 hosts 文件

以管理员身份打开 C:\Windows\System32\drivers\etc\hosts,将原来的:

go 复制代码
172.28.123.45 dev.wsl.net

改为:

go 复制代码
172.28.123.45 wsl.localhost
2. 保存文件
3. 在 Windows 浏览器中访问
go 复制代码
http://wsl.localhost
4. 现在,无论是否开启 VPN,都能正常访问!✅

🧪 验证方法

在开启 VPN 的状态下,在 Windows 中执行:

go 复制代码
ping wsl.localhost

如果返回的是你的 WSL2 IP(如 172.28.123.45),说明解析成功 ✅

如果提示"找不到主机",说明你还没改 hosts 或拼写错误 ❌


⚠️ 注意事项

  1. 必须用 .localhost,不能是 .local.test
  • .local

    会被 mDNS(Bonjour/Zeroconf)接管,可能不稳定;

  • .test

    虽也是保留域名,但部分企业 VPN 仍可能劫持;

  • 只有 .localhost 是 100% 强制本地解析的

  • 不要用 localhost 本身

    • localhost

      默认指向 127.0.0.1(Windows 自己),而不是 WSL2;

    • 所以要用 子域名 ,如 app.localhostapi.localhost

  • 确保 WSL2 服务监听 0.0.0.0

    例如 Nginx 配置:

    或 Node.js:

    1. app.listen(3000,'0.0.0.0',()=>{``...})
    1. server {
    2. listen 80;
    3. server_name app.localhost;# 可选
    4. ...
    5. }

    ✅ 总结

    问题

    • 在 WSL2 中运行的 Web 服务,通过 Windows 的 hosts 文件绑定域名(如 dev.wsl.net -> 172.x.x.x)访问。

    • 开启全流量接管型 VPN 后,Windows 无法解析该域名,导致页面打不开。

    导致问题的原因

    • 开启 VPN 后,Windows 的 DNS 请求被强制走远程服务器,忽略本地 hosts 文件,导致域名解析失败。

    解决方案

    • 使用 .localhost 域名代替 .local 或其他自定义域名。

      • 修改 Windows 的 hosts 文件,将 dev.wsl.net 改为 wsl.localhost

      • 在浏览器中访问 http://wsl.localhost

    总结

    问题 解决方法
    开启 VPN 后 dev.wsl.net 无法访问 改为 wsl.localhostdev.wsl.localhost
    原因 VPN 劫持 DNS,绕过本地 hosts
    为什么 .localhost 有效 RFC 强制本地解析,不走 DNS
    是否需要重启 WSL? ❌ 不需要
    是否需要改代码? ❌ 只需改 hosts 和浏览器地址栏

    💡 一句话终极答案
    把你的开发域名从 xxx.local 改成 xxx.localhost,并在 Windows hosts 中绑定 WSL2 IP,即可在开 VPN 时正常访问。

    这是目前最简单、最可靠、兼容性最好的方案,已被无数开发者验证 ✅

    试试看吧!如果有任何问题,欢迎继续交流 😊

相关推荐
凯子坚持 c9 分钟前
CANN 性能剖析实战:从原始事件到交互式火焰图
windows·microsoft
清山博客20 分钟前
OpenCV 人脸识别和比对工具
前端·webpack·node.js
要加油哦~22 分钟前
AI | 实践教程 - ScreenCoder | 多agents前端代码生成
前端·javascript·人工智能
程序员Sunday25 分钟前
说点不一样的。GPT-5.3 与 Claude Opus 4.6 同时炸场,前端变天了?
前端·gpt·状态模式
yq19820430115631 分钟前
静思书屋:基于Java Web技术栈构建高性能图书信息平台实践
java·开发语言·前端
aPurpleBerry34 分钟前
monorepo (Monolithic Repository) pnpm rush
前端
青茶36041 分钟前
php怎么实现订单接口状态轮询请求
前端·javascript·php
开开心心就好1 小时前
发票合并打印工具,多页布局设置实时预览
linux·运维·服务器·windows·pdf·harmonyos·1024程序员节
獨枭1 小时前
PyCharm 跑通 SAM 全流程实战
windows
鹏北海1 小时前
micro-app 微前端项目部署指南
前端·nginx·微服务