FlyingBird返回首页

WSL2 怎么使用 Windows 代理?先判断网络模式再配置

更新于 2026-11-14 · flyingbird.buzz

简答: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 网络文档

WSL2 使用 Windows 代理的选择表
方法适用网络模式代理地址代理协议端口限制
镜像网络+自动代理Windows 11 22H2 及以上、支持对应 WSL 功能的环境通常由 WSL 注入环境变量;也可用 127.0.0.1 验证Windows HTTP 代理信息以 Windows 代理设置和客户端设置页为准需要存在可读取的 Windows HTTP 代理信息;仅开启客户端 TUN 不等于已设置系统 HTTP 代理
NAT+手动环境变量默认 NAT 模式通过默认路由查询宿主机 IP,例如 172.30.96.1HTTP、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 --verbose

wsl --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.com

socks5h会让域名解析交给 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.com

HTTP 代理地址不要写成 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 失败时,可以单独配置,并保留撤销命令。

常见开发工具的代理配置速查
工具设置命令撤销命令说明
Gitgit config --global http.proxy http://172.30.96.1:7890
git config --global https.proxy http://172.30.96.1:7890
git config --global --unset http.proxy
git config --global --unset https.proxy
地址和端口替换为实际代理;可按全局或仓库范围设置
pippython -m pip install --proxy http://172.30.96.1:7890 包名删除命令中的 --proxy;持久化配置需用 pip 配置命令检查临时参数适合单次安装,持久化配置需单独核对
npmnpm config set proxy http://172.30.96.1:7890
npm config set https-proxy http://172.30.96.1:7890
npm config delete proxy
npm config delete https-proxy
使用 npm config get proxy检查当前值
aptsudo apt -o Acquire::http::Proxy="http://172.30.96.1:7890" update不带该 -o参数执行如需持久化,应单独创建 apt 配置文件并确认权限

Git 的代理配置项可参考Git 官方 git-config 文档;npm 的配置命令和配置项可参考npm 官方配置文档。如果 curl 成功而某个工具失败,优先检查该工具是否保存了旧代理地址、错误协议或旧端口。

本站推荐(广告):边界云加速官网,了解跨境网络连接方案

连接失败时按这个顺序排查

  1. 确认 WSL 版本:在 PowerShell 执行 wsl --version和wsl --list --verbose,确认发行版运行在 WSL 2;必要时执行 wsl --update。
  2. 确认网络模式:检查 .wslconfig是否写入networkingMode=mirrored。如果没有使用镜像模式,优先用 ip route show | grep -i default | awk '{ print $3}'获取宿主机 IP。
  3. 确认代理端口:端口必须来自代理客户端当前设置页。HTTP、HTTPS、SOCKS5 端口可能不同,不能只凭教程中的 7890判断。
  4. 确认监听范围:NAT 模式通过宿主机 IP 访问时,客户端通常需要允许局域网连接;否则即使 Windows 本机能用,WSL 也可能连接被拒绝。
  5. 确认环境变量:在 WSL 中执行 env | grep -i proxy。无输出时,检查 Windows HTTP 代理是否已设置,以及是否误把 TUN 模式当成系统 HTTP 代理。
  6. 分开测试网络层和工具层:先用 curl -I -x指定代理测试,再测试 Git、pip 或 npm。curl 失败说明地址、端口、防火墙或协议仍有问题;curl 成功而某个工具失败,则检查该工具自己的配置。
  7. 修改配置后重启:编辑 .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 实例已经关闭,再重新打开发行版。

相关阅读

参考资料

  1. Microsoft Learn:使用 WSL 访问网络应用程序
  2. Microsoft Learn:WSL 中的高级设置配置
  3. Microsoft Learn:WSL 的基本命令
  4. curl 官方命令手册
  5. Git 官方 git-config 文档
  6. npm 官方配置文档