WSL2 怎么使用 Windows 代理?先判断网络模式再配置
简答:WSL2 使用 Windows 代理,先确认 WSL 版本、网络模式和代理客户端端口。镜像网络可配合 autoProxy 自动读取 Windows HTTP 代理;NAT 模式则用默认路由获取宿主机 IP,再分别配置环境变量和开发工具。
定义:WSL2 使用 Windows 代理,是让 Linux 程序通过 Windows 宿主机正在监听的 HTTP、HTTPS 或 SOCKS5 代理端口访问网络。
先看这张表:WSL2 应该选哪种代理方法?
先不要直接把代理地址写成 127.0.0.1。WSL 默认使用 NAT 网络;在 NAT 模式下,WSL 访问 Windows 上的服务通常需要查询宿主机 IP。镜像网络模式则支持从 WSL 使用 127.0.0.1 访问 Windows 服务。Microsoft WSL 网络文档
| 方法 | 适用网络模式 | 代理地址 | 代理协议 | 端口 | 限制 |
|---|---|---|---|---|---|
| 镜像网络+自动代理 | Windows 11 22H2 及以上、支持对应 WSL 功能的环境 | 通常由 WSL 注入环境变量;也可用 127.0.0.1 验证 | Windows HTTP 代理信息 | 以 Windows 代理设置和客户端设置页为准 | 需要存在可读取的 Windows HTTP 代理信息;仅开启客户端 TUN 不等于已设置系统 HTTP 代理 |
| NAT+手动环境变量 | 默认 NAT 模式 | 通过默认路由查询宿主机 IP,例如 172.30.96.1 | HTTP、HTTPS 或 SOCKS5,需与客户端监听端口匹配 | 示例值 7890,以客户端设置页为准 | 客户端通常需要允许局域网连接,Windows 防火墙也可能拦截 |
| 单命令临时代理 | 两种模式均可 | 按当前网络模式填写 | 由 curl 或具体工具参数指定 | 示例值,以客户端设置页为准 | 只对当前命令生效,不会自动配置 Git、pip 或 npm |
如果你使用 Windows 11 且 WSL 支持镜像网络,可以先尝试第一种方法;如果镜像模式不可用,再使用 NAT 方法。微软文档列出,autoProxy=true用于让 WSL 使用 Windows 的 HTTP 代理信息,镜像网络和自动代理的可用条件以当前文档和本机 WSL 版本为准。Microsoft WSL 高级设置文档
方法一:mirrored 网络配合 autoProxy 自动继承 Windows 代理
该方法适合希望 WSL 中的 curl、Git、pip 等程序读取 Windows 代理信息的场景。相关设置写入 Windows 用户目录下的 %UserProfile%\.wslconfig,而不是 Linux 内的 /etc/wsl.conf。Microsoft WSL 高级设置文档
第 1 步:在 PowerShell 检查 WSL 版本和发行版
wsl --version
wsl --list --verbosewsl --version用于查看 WSL 组件信息,wsl --list --verbose用于确认具体发行版是否运行在 WSL 2。若命令无法识别或需要更新,可在 PowerShell 执行:
wsl --update更新后重新打开 PowerShell,再次执行检查命令。WSL 基本命令的用途可参考Microsoft WSL 基本命令文档。
第 2 步:确认 Windows 代理信息已经存在
打开 Windows 的代理设置,确认代理客户端已经写入系统 HTTP 代理或 PAC 信息。代理端口不要照抄教程中的固定数字,应以客户端设置页和 Windows 代理设置当前显示为准。
autoProxy 的生效前提:它主要读取 Windows 的 HTTP 代理信息。如果客户端只开启了 TUN 或虚拟网卡模式,却没有设置为 Windows 系统代理,WSL 中不一定会出现可用的代理变量。此时先在客户端打开“设置为系统代理”或等效选项,再继续测试。
第 3 步:创建或编辑 .wslconfig
在 Windows 用户目录创建文件:
%UserProfile%\.wslconfig先使用下面的最小配置:
[wsl2]
networkingMode=mirrored
autoProxy=true.wslconfig用于影响所有运行在 WSL 2 中的发行版;wsl.conf则用于单个发行版的设置。保存后不要只关闭 Linux 终端,还要完全停止 WSL 实例。
第 4 步:完全重启 WSL 并验证变量
在 PowerShell 执行:
wsl --shutdown然后重新进入发行版,在 Linux 终端执行:
env | grep -i proxy如果输出中出现 HTTP_PROXY、HTTPS_PROXY或对应的小写变量,说明 WSL 已经注入代理信息。没有输出时,依次检查 Windows 系统代理、客户端是否开启系统代理、.wslconfig文件位置,以及是否执行了wsl --shutdown。修改全局 WSL 配置后重启实例是文档要求的生效步骤。查看 WSL 配置重启说明
第 5 步:用 curl 实测
镜像网络下,可以用示例端口测试本机 HTTP 代理:
curl -I -x http://127.0.0.1:7890 https://example.com这里的 7890只是示例值,以代理客户端设置页为准。若返回 200、301或其他目标站点响应,说明代理连接和 HTTP 请求已经完成;如果出现 Connection refused,先检查监听端口和协议;如果超时,再检查客户端允许局域网、Windows 防火墙和目标网络。
如果客户端提供的是 SOCKS5 端口,可改用:
curl -I --proxy socks5h://127.0.0.1:7890 https://example.comsocks5h会让域名解析交给 SOCKS5 代理处理。curl 官方手册说明,--proxy支持通过协议前缀区分 HTTP、SOCKS4、SOCKS5 和 SOCKS5 主机名解析模式。curl 官方命令手册
方法二:NAT 网络用宿主机 IP 设置代理
如果 WSL 仍是 NAT 模式,不要默认使用 127.0.0.1。在 Linux 终端执行下面的命令获取 Windows 宿主机网关地址:
ip route show | grep -i default | awk '{ print $3}'假设输出为 172.30.96.1,它只是示例地址;实际地址应以本机命令输出为准。Microsoft 文档也列出了通过默认路由查询 Windows 主机 IP 的方法。Microsoft WSL 网络文档
第 1 步:确认代理客户端监听地址和端口
在 Windows 代理客户端设置中确认:是否允许局域网连接、HTTP 或混合端口是多少、SOCKS5 端口是多少。NAT 模式下,客户端如果只监听 Windows 回环地址,WSL 通过宿主机 IP 访问时可能无法连接;需要使用客户端提供的“允许局域网连接”或等效设置。端口必须以客户端设置页为准。
第 2 步:在当前终端临时设置 HTTP 代理
假设宿主机 IP 是 172.30.96.1,HTTP 代理端口是示例值 7890:
export http_proxy=http://172.30.96.1:7890
export https_proxy=http://172.30.96.1:7890
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"然后检查变量并测试:
env | grep -i proxy
curl -I https://example.com如果客户端只有 SOCKS5 端口,可使用:
export ALL_PROXY=socks5h://172.30.96.1:7890
export all_proxy="$ALL_PROXY"
curl -I https://example.comHTTP 代理地址不要写成 SOCKS5 协议,SOCKS5 端口也不要直接套用 HTTP 端口,除非客户端明确说明该端口是混合端口。
第 3 步:写入 shell 配置或随时撤销
希望每次打开 Bash 都自动使用代理,可以把变量写入 ~/.bashrc。先确认当前端口稳定,再执行:
cat >> ~/.bashrc <<'EOF'
export http_proxy=http://172.30.96.1:7890
export https_proxy=http://172.30.96.1:7890
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"
EOF
source ~/.bashrc需要取消当前终端的代理时,执行:
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY all_proxy ALL_PROXY如果已经把代理变量写入 ~/.bashrc,还要删除或注释对应行,否则重新打开终端后变量会再次出现。
Git、pip、npm 和 apt 怎么分别使用代理?
环境变量不一定能覆盖每个工具的独立设置。遇到 curl 能联网,但 Git、pip 或 npm 失败时,可以单独配置,并保留撤销命令。
| 工具 | 设置命令 | 撤销命令 | 说明 |
|---|---|---|---|
| Git | git config --global http.proxy http://172.30.96.1:7890git config --global https.proxy http://172.30.96.1:7890 | git config --global --unset http.proxygit config --global --unset https.proxy | 地址和端口替换为实际代理;可按全局或仓库范围设置 |
| pip | python -m pip install --proxy http://172.30.96.1:7890 包名 | 删除命令中的 --proxy;持久化配置需用 pip 配置命令检查 | 临时参数适合单次安装,持久化配置需单独核对 |
| npm | npm config set proxy http://172.30.96.1:7890npm config set https-proxy http://172.30.96.1:7890 | npm config delete proxynpm config delete https-proxy | 使用 npm config get proxy检查当前值 |
| apt | sudo apt -o Acquire::http::Proxy="http://172.30.96.1:7890" update | 不带该 -o参数执行 | 如需持久化,应单独创建 apt 配置文件并确认权限 |
Git 的代理配置项可参考Git 官方 git-config 文档;npm 的配置命令和配置项可参考npm 官方配置文档。如果 curl 成功而某个工具失败,优先检查该工具是否保存了旧代理地址、错误协议或旧端口。
本站推荐(广告):边界云加速官网,了解跨境网络连接方案
连接失败时按这个顺序排查
- 确认 WSL 版本:在 PowerShell 执行
wsl --version和wsl --list --verbose,确认发行版运行在 WSL 2;必要时执行wsl --update。 - 确认网络模式:检查
.wslconfig是否写入networkingMode=mirrored。如果没有使用镜像模式,优先用ip route show | grep -i default | awk '{ print $3}'获取宿主机 IP。 - 确认代理端口:端口必须来自代理客户端当前设置页。HTTP、HTTPS、SOCKS5 端口可能不同,不能只凭教程中的
7890判断。 - 确认监听范围:NAT 模式通过宿主机 IP 访问时,客户端通常需要允许局域网连接;否则即使 Windows 本机能用,WSL 也可能连接被拒绝。
- 确认环境变量:在 WSL 中执行
env | grep -i proxy。无输出时,检查 Windows HTTP 代理是否已设置,以及是否误把 TUN 模式当成系统 HTTP 代理。 - 分开测试网络层和工具层:先用
curl -I -x指定代理测试,再测试 Git、pip 或 npm。curl 失败说明地址、端口、防火墙或协议仍有问题;curl 成功而某个工具失败,则检查该工具自己的配置。 - 修改配置后重启:编辑
.wslconfig后执行wsl --shutdown,再重新进入发行版。WSL 全局配置需要在实例重新启动后应用。查看配置重启说明
如果出现 Connection refused,先查监听端口和允许局域网;如果出现超时,检查宿主机 IP、Windows 防火墙和客户端规则;如果域名解析失败,再单独检查 DNS,不要把所有问题都归因于代理变量。
如何恢复为不使用 Windows 代理?
如果使用的是 mirrored+autoProxy,编辑 %UserProfile%\.wslconfig,删除相关行或改为:
[wsl2]
networkingMode=mirrored
autoProxy=false保存后执行:
wsl --shutdown如果使用的是 NAT 手动变量,执行:
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY all_proxy ALL_PROXY同时检查 ~/.bashrc、Git、npm 或 pip 的持久化配置,避免终端变量取消后,单个工具仍继续走代理。Windows 端的系统代理是否关闭,应在 Windows 代理设置和代理客户端中分别确认。
常见问题
WSL2 为什么不能直接使用 Windows 的 127.0.0.1 代理?
因为 WSL 默认通常使用 NAT 网络。在 NAT 模式下,WSL 访问 Windows 服务要使用默认路由查询到的宿主机 IP;镜像网络模式才适合用 127.0.0.1 访问 Windows 服务。
autoProxy=true 为什么没有出现 HTTP_PROXY?
autoProxy读取的是 Windows HTTP 代理信息。请确认 Windows 系统代理已经设置,客户端不是只开启 TUN 模式,并执行 wsl --shutdown 后重新打开 WSL,再用 env | grep -i proxy 检查。
代理端口一定是 7890 吗?
不是。7890 只能作为示例值,实际端口必须查看代理客户端的 HTTP、混合或 SOCKS5 监听设置。不同协议的端口可能不同。
curl 能联网,但 Git 或 pip 仍然失败怎么办?
先查看 Git、pip 或 npm 是否存在独立代理配置。可以分别用 git config --get-regexp 'proxy'、python -m pip config list 和 npm config get proxy 检查,并删除错误的持久化配置后再测试。
修改 .wslconfig 后为什么没有变化?
WSL 配置在实例启动时应用。保存文件后先执行 wsl --shutdown,确认所有 WSL 实例已经关闭,再重新打开发行版。