Windows 怎么配置 WSL2 虚拟机访问宿主机的本地网络服务

落敏君_3464

落敏君_3464

2026-08-29

583人浏览

原创

WSL2无法通过localhost访问Windows宿主机服务,因其采用NAT网络架构,拥有独立IP和回环接口,localhost在WSL2中指向自身而非宿主机;解决方法包括:①用宿主机网关IP(如172.27.128.1)配合服务监听0.0.0.0及防火墙放行;②启用.wslconfig中localhostForwarding=true实现localhost直连;③升级至Win11 23H2后启用mirrored网络实现双向localhost互通。

wsl2 默认无法直接用 localhost 访问 windows 宿主机上运行的服务(比如 http://localhost:3000),因为它的网络是独立的 nat 子网,和宿主机不在同一网络平面。但这个问题有成熟、稳定的解法,核心是让 wsl2 能正确识别并连接到宿主机的真实 ip。


为什么 WSL2 访问不了宿主机的 localhost?

WSL2 是一个轻量级 VM,它有自己的 IP(如 172.27.x.x),而 Windows 宿主机服务默认只监听 127.0.0.1(回环地址),不对外部网络接口开放。WSL2 不属于“本机”,所以 localhost 对它来说指的是自己,不是 Windows。


方法一:用宿主机真实 IP + 开放监听(推荐,最通用)

这是最可靠、无需改系统设置的方式,适用于所有服务(Node.js、Python Flask、MySQL、Nginx 等)。

  • 步骤 1:获取宿主机在 WSL2 网络中的 IP
    在 WSL2 终端中运行:

    ip route | grep default | awk '{print $3}'

    输出类似 172.27.128.1 —— 这就是 Windows 宿主机在 WSL2 NAT 网络中的网关 IP。

  • 步骤 2:确保服务监听 0.0.0.0(而非仅 127.0.0.1)
    比如启动 Node.js 服务时:

    node server.js --host 0.0.0.0 --port 3000

    或 Python Flask:

    app.run(host='0.0.0.0', port=5000)
  • 步骤 3:检查 Windows 防火墙是否放行该端口
    打开「Windows Defender 防火墙」→「高级设置」→「入站规则」→ 新建规则 → 选择「端口」→ 输入你的服务端口(如 TCP 3000)→ 允许连接 → 应用于「域、专用、公用」。

  • 验证访问
    在 WSL2 中执行:

    curl http://172.27.128.1:3000

    成功即表示通了。

    Codex Orchestrator
    Codex Orchestrator

    一款AI工具,主要用于监控、控制并编排后台 Codex 会话。用于跟踪进度、处理中断,并确保长时间运行的编码任务顺利完成,适合需要提升相关任务效率的用户。

    下载

方法二:启用 localhostForwarding(简化 localhost 访问)

适用于想直接用 http://localhost:3000 访问宿主服务的场景(需 WSL2 1.2.0+,Windows 11 22H2+)。

  • 编辑或创建 %USERPROFILE%\.wslconfig:
    [wsl2]
    localhostForwarding=true
  • 重启 WSL2:
    wsl --shutdown
    wsl
  • 此后,在 WSL2 中 curl http://localhost:3000 就能直连宿主机服务(前提是服务已监听 0.0.0.0 且防火墙放行)。

⚠️ 注意:localhostForwarding=true 只转发请求,不改变底层网络结构;它依赖 Windows 的端口代理机制,对 UDP 或某些低层服务(如 SSH)可能不生效。


方法三:启用镜像网络(mirrored networking,终极方案)

让 WSL2 和 Windows 完全共享网络栈,localhost 双向互通,IP 地址一致,适合深度集成场景。

  • 编辑 %USERPROFILE%\.wslconfig:
    [wsl2]
    networkingMode=mirrored
  • 确保已安装最新 WSL(wsl --update),且 Windows 版本 ≥ 23H2。
  • 执行:
    wsl --shutdown
    wsl
  • 验证:在 WSL2 中 curl http://localhost:3000 和 curl http://127.0.0.1:3000 均可直达宿主机服务,反之亦然。

✅ 优点:彻底消除网络隔离,支持 mDNS(.local)、SMB、Docker Desktop 与宿主机共网等复杂场景。
❗ 要求:仅限 Windows 11 23H2 及以上,且部分企业环境策略可能限制该模式。


不复杂但容易忽略的是服务监听地址和防火墙这两步——很多问题其实卡在这儿,而不是 WSL2 配置本身。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

457

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

1000

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3652

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

1176

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

1069

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

554

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

3376

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

6432

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

967

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HBuilderX Windows 安装手册
HBuilderX Windows 安装手册

共0课时 | 0人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习

好课诞生记
好课诞生记

共20课时 | 7.3万人学习