修改WSL网络模式为镜像模式

原创已于 2025-07-21 12:20:45 修改 · 1k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#网络 #wsl

于 2025-07-21 12:16:26 首次发布

组件安装部署专栏收录该内容

15 篇文章

订阅专栏

在WSL（Windows Subsystem for Linux）中遇到“检测到 localhost 代理配置，但未镜像到 WSL。NAT 模式下的 WSL 不支持 localhost 代理”的问题，通常是由于WSL的网络隔离机制导致的。以下是综合多篇技术文档的解决方案：

一、核心解决方案：修改WSL网络模式为镜像模式

WSL默认的NAT模式会导致本地代理无法直接映射到WSL环境。通过切换为镜像模式（Mirrored Mode），WSL将共享Windows的网络配置，从而支持localhost代理：

创建或编辑 .wslconfig 文件在Windows用户目录（C:\Users\）下创建或修改名为 .wslconfig 的文件，添加以下内容：
```
[experimental]
networkingMode = mirrored
autoProxy = true
dnsTunneling = true
firewall = true
autoMemoryReclaim = gradual
```
- networkingMode=mirrored：强制WSL与Windows共享同一网络栈，消除NAT隔离。
- autoProxy=true：自动同步Windows的代理设置到WSL。
重启WSL 执行以下命令使配置生效：
```
wsl --shutdown
wsl
```
重启后，WSL的IP地址将与Windows主机一致，且localhost代理可直接使用。

二、备选方案：手动设置代理变量

若无法切换网络模式，可通过环境变量手动指定Windows主机的代理地址：

获取Windows主机的IP地址在WSL中执行以下命令：

host_ip=$(cat /etc/resolv.conf | grep -oP '(?<=nameserver ).*')

或通过PowerShell脚本动态获取：

host_ip=$(powershell.exe -Command "Get-NetIPAddress -InterfaceAlias 'WLAN' | Select-Object -ExpandProperty IPAddress | Select-String -Pattern '^\d+\.\d+\.\d+\.\d+' | Select-Object -First 1")

设置代理环境变量在WSL的 .bashrc 或 /etc/profile 中添加：

export http_proxy="http://$host_ip:端口号"
export https_proxy="http://$host_ip:端口号"
export no_proxy="localhost,127.0.0.1"

需将 端口号 替换为实际代理端口（如7890）。

三、其他辅助配置

更新WSL版本执行以下命令升级WSL至最新版本，修复潜在兼容性问题：
```
wsl --update --preview
```
关闭自动代理同步（临时场景）若无需代理，可通过以下命令临时关闭提示：
```
export no_proxy="localhost,127.0.0.1"
```
调整网络适配器设置若使用第三方代理工具（如Clash），需确保其支持局域网共享，并在WSL中绑定工具的监听地址。

四、验证与注意事项

验证代理生效：执行 curl -I https://www.google.com，若成功返回HTTP状态码则代理配置成功。
IP冲突问题：镜像模式下，若Windows和WSL服务使用相同端口，需注意端口冲突。
系统兼容性：镜像模式要求WSL版本≥2.0，且Windows需为11 22H2或更高版本。通过以上方法，可有效解决WSL代理隔离问题，实现与Windows网络环境的无缝衔接。若需进一步优化网络性能，可结合DNS隧道、防火墙规则等高级配置。