在 Windows 11 中设置 WSL2 Ubuntu 的 `networkingMode=mirrored` 详细教程

在 Windows 11 中设置 WSL2 Ubuntu 的 `networkingMode=mirrored` 详细教程

引言

在 Windows 11 中使用 WSL2(Windows Subsystem for Linux 2)时,默认的网络配置可能会导致一些网络互通性问题,例如无法通过 localhost 访问 WSL2 中的服务,或者在局域网中无法访问 WSL2 中的服务。为了解决这些问题,Windows 11 23H2 及以上版本引入了 networkingMode=mirrored 配置,使 WSL2 与 Windows 主机共享相同的网络配置。本文将详细介绍如何设置 WSL2 Ubuntu 的 networkingMode=mirrored,并解决常见问题。


环境要求

在开始之前,请确保满足以下环境要求:

  • Windows 版本:Windows 11 23H2 或更高版本。
  • WSL 版本:WSL2 2.0.0 或更高版本。

可以通过以下命令检查 WSL 版本:

bash 复制代码
wsl --version

如果版本低于 2.0.0,可以通过以下命令更新:

bash 复制代码
wsl --update --pre-release

配置 .wslconfig 文件

  1. 创建或编辑 .wslconfig 文件

    • 打开 PowerShell 或命令提示符,输入以下命令创建或编辑 .wslconfig 文件:

      bash 复制代码
      notepad $env:USERPROFILE\.wslconfig
    • 如果文件已存在,直接编辑即可。

  2. 添加镜像网络配置

    .wslconfig 文件中添加以下内容:

    ini 复制代码
    [wsl2]
    networkingMode=mirrored
    dnsTunneling=true
    autoProxy=true
    firewall=true
    
    [experimental]
    autoMemoryReclaim=gradual
    sparseVhd=true
    hostAddressLoopback=true
    • networkingMode=mirrored:启用镜像网络模式,使 WSL2 与 Windows 共享网络。
    • dnsTunneling=true:启用 DNS 隧道,提高与 VPN 等复杂网络的兼容性。
    • autoProxy=true:同步 Windows 的代理设置到 WSL2。
    • firewall=true:启用 Windows 防火墙集成。
    • hostAddressLoopback=true:允许通过主机的局域网 IP 访问 WSL2 中的服务。

重启 WSL2

完成配置后,重启 WSL2 以应用更改:

bash 复制代码
wsl --shutdown

等待几秒后重新启动 WSL2。


验证镜像网络模式

  1. 检查 IP 地址

    • 在 WSL2 中运行以下命令查看 IP 地址:

      bash 复制代码
      ip addr show eth0

      如果 IP 地址与 Windows 主机的 IP 地址一致,说明镜像网络模式已启用。

  2. 测试网络互通

    • 在 WSL2 中启动一个服务(如 Python HTTP 服务器):

      bash 复制代码
      python3 -m http.server 8000
    • 在 Windows 中访问 http://localhost:8000,如果能够访问,说明镜像网络模式配置成功。


解决常见问题

  1. 局域网访问问题

    • 如果局域网设备无法访问 WSL2 中的服务,可能是 Hyper-V 防火墙阻止了入站连接。可以通过以下命令允许入站连接:

      powershell 复制代码
      Set-NetFirewallHyperVVMSetting -Name '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -DefaultInboundAction Allow

      或者为特定端口添加规则:

      powershell 复制代码
      New-NetFirewallHyperVRule -Name "AllowPort8000" -DisplayName "Allow Port 8000" -Direction Inbound -VMCreatorId '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -Protocol TCP -LocalPorts 8000
  2. Docker 容器无法通过 localhost 访问

    • 如果使用 Docker,需要在 /etc/docker/daemon.json 中添加以下配置:

      json 复制代码
      {
        "iptables": false
      }

      然后重启 Docker 服务:

      bash 复制代码
      sudo service docker restart

其他注意事项

  • 端口冲突:如果遇到端口冲突问题,可以调整 Windows 的 TCP 动态端口范围,避免与常用端口冲突:

    powershell 复制代码
    netsh int ipv4 set dynamic tcp start=50000 num=15536
  • IPv6 支持 :镜像网络模式支持 IPv6,但 localhost 的 IPv6 地址 ::1 可能无法直接使用。


结论

通过以上步骤,您可以成功将 WSL2 Ubuntu 的网络模式设置为 mirrored,并享受更便捷的网络互通体验。如果遇到问题,可以参考相关文档或社区讨论。希望本文对您有所帮助!


参考文档

相关推荐
牧以南歌〆3 小时前
在Ubuntu主机中修改ARM Linux开发板的根文件系统
linux·arm开发·驱动开发·ubuntu
emplace_back3 小时前
C# 集合表达式和展开运算符 (..) 详解
开发语言·windows·c#
夜月yeyue4 小时前
设计模式分析
linux·c++·stm32·单片机·嵌入式硬件
kfepiza4 小时前
Debian的`/etc/network/interfaces`的`allow-hotplug`和`auto`对比讲解 笔记250704
linux·服务器·网络·笔记·debian
cuijiecheng20185 小时前
Ubuntu下布署mediasoup-demo
linux·运维·ubuntu
独行soc7 小时前
2025年渗透测试面试题总结-2025年HW(护网面试) 33(题目+回答)
linux·科技·安全·网络安全·面试·职场和发展·护网
一禅(OneZen)7 小时前
「Windows/Mac OS」AIGC图片生成视频 ,webui + stable-diffusion环境部署教程
windows·stable diffusion
java龙王*7 小时前
开放端口,开通数据库连接权限,无法连接远程数据库 解决方案
linux
AirDroid_cn8 小时前
OPPO手机怎样被其他手机远程控制?两台OPPO手机如何相互远程控制?
android·windows·ios·智能手机·iphone·远程工作·远程控制
bcbobo21cn8 小时前
Linux命令的命令历史
linux·histsize·histfile