在 Windows 上做开发，WSL2（Windows Subsystem for Linux 2）已经成为很多人的标配。它提供了一个接近原生的 Linux 环境，可以直接运行 apt、pip、npm、git、docker 等工具。但很多开发者会发现一个尴尬的问题：Windows 宿主机上的快连明明工作正常，浏览器可以访问国外网站，可是在 WSL2 终端里执行 git clone、pip install、npm install 却经常超时或失败。
原因并不复杂：WSL2 虽然运行在 Windows 上，但它拥有独立的虚拟网络和 Linux 内核，默认不会继承 Windows 的系统代理设置。也就是说，你在 Windows 上开的快连，WSL2 里的流量并不会自动走代理。要解决这个问题，需要在 WSL2 中手动配置代理，把流量指向 Windows 宿主机上的快连代理端口。快连官网（kenlandd.com.cn）技术团队将在本文中，从网络架构、配置步骤、持久化方法到问题排查，完整讲解 WSL2 下如何使用快连。
一、先理解WSL2的网络结构
WSL2 与 WSL1 最大的区别之一，是 WSL2 使用了一个轻量级虚拟机来运行 Linux 内核。这个虚拟机有自己独立的虚拟网卡和 IP 地址，与 Windows 宿主机之间通过虚拟交换机通信。默认情况下，WSL2 处于 NAT 模式，访问外部网络时，流量会经过 Windows 宿主机进行地址转换。
这意味着两件事：
- WSL2 无法直接使用 Windows 的
127.0.0.1回环地址访问宿主机上的服务。 - WSL2 需要知道 Windows 宿主机的虚拟网卡 IP，才能把代理请求发送过去。
因此，WSL2 代理配置的核心步骤只有两个：找到 Windows 宿主机 IP，把 WSL2 的代理环境变量指向这个 IP 和快连的代理端口。
127.0.0.1 访问宿主机服务，配置会简单很多。本文以更常见的 NAT 模式为主，镜像模式在文末单独说明。
二、准备工作：确认快连代理端口
在配置 WSL2 之前，首先要确认 Windows 上快连的代理端口。打开快连电脑版，进入“设置”或“高级设置”，查看“本地代理端口”或“HTTP 代理端口”。常见端口有 1080、7890、8080 等，具体以客户端显示为准。记下这个端口号，后面会用到。
同时，建议在快连设置中确认已开启“允许局域网连接”或类似选项。虽然 WSL2 的虚拟网卡不完全等同于局域网，但开启后代理监听地址会更宽松，减少连接被拒绝的概率。如果你还没有安装最新版快连，可以前往快连下载页面获取最新客户端，新版本对代理端口的显示和局域网访问支持更清晰。
三、获取Windows宿主机IP
在 WSL2 中，可以通过读取 /etc/resolv.conf 文件来获取 Windows 宿主机的 IP。执行以下命令：
cat /etc/resolv.conf | grep nameserver | awk '{print $2}'
输出结果通常形如 172.28.192.1，这就是当前 WSL2 视角下的 Windows 宿主机 IP。注意，这个 IP 在每次重启 WSL2 或 Windows 后可能会变化，所以后续配置建议使用动态获取的方式，而不是写死。
也可以在 WSL2 中执行 ip route | grep default，输出的默认网关地址通常也是宿主机 IP。
四、在WSL2中临时配置代理
临时配置最简单，适合快速测试。在 WSL2 终端中执行以下命令（将 IP 和端口替换为你的实际值）：
export HOST_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy="http://$HOST_IP:7890"
export https_proxy="http://$HOST_IP:7890"
export all_proxy="socks5://$HOST_IP:7890"
这里的 7890 是示例端口，请替换为快连实际显示的端口。如果快连只提供 SOCKS5 代理，则只设置 all_proxy 即可；如果提供 HTTP 代理，则 http_proxy 和 https_proxy 都要设置。部分工具（如 git、curl）会读取小写的 http_proxy，部分工具读取大写的 HTTP_PROXY，建议两者都设置，避免兼容性问题。
配置完成后，执行 curl -I https://www.google.com 或 wget -qO- https://www.google.com 测试是否能够访问。如果返回 HTTP 状态码，说明代理生效。
五、让代理配置持久化
临时配置只在当前终端会话有效，关闭终端或重启 WSL2 后就会失效。为了让每次打开 WSL2 都自动配置代理，可以把配置写入 shell 的启动文件。
1. 写入 .bashrc 或 .zshrc
如果你使用 bash，编辑 ~/.bashrc；如果使用 zsh，编辑 ~/.zshrc。在文件末尾添加：
# 快连 WSL2 代理配置
export HOST_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy="http://$HOST_IP:7890"
export https_proxy="http://$HOST_IP:7890"
export all_proxy="socks5://$HOST_IP:7890"
保存后执行 source ~/.bashrc 或重新打开终端即可生效。这种方式的优点是简单，缺点是每次打开新终端都会重新计算 IP，适合 IP 经常变化的环境。
2. 使用独立脚本按需开启
有些开发者不希望所有终端都默认走代理，而是需要时手动开启。可以创建一个脚本文件，例如 ~/proxy-on.sh：
#!/bin/bash
export HOST_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy="http://$HOST_IP:7890"
export https_proxy="http://$HOST_IP:7890"
export all_proxy="socks5://$HOST_IP:7890"
echo "代理已开启：$HOST_IP:7890"
再创建一个关闭脚本 ~/proxy-off.sh：
#!/bin/bash unset http_proxy https_proxy all_proxy echo "代理已关闭"
赋予执行权限：chmod +x ~/proxy-on.sh ~/proxy-off.sh。需要代理时执行 source ~/proxy-on.sh，不需要时执行 source ~/proxy-off.sh。这种方式更灵活，适合代理需求不固定的场景。
3. 为特定工具单独配置
有些工具不读取环境变量，需要单独配置。例如 git 可以通过以下命令设置代理：
git config --global http.proxy "http://$HOST_IP:7890" git config --global https.proxy "http://$HOST_IP:7890"
npm 可以通过 npm config set proxy 和 npm config set https-proxy 设置。pip 可以通过 pip config set global.proxy 设置。docker 则需要在 daemon 配置中设置代理。关于开发工具的更多网络优化，可以参考《快连电脑版分应用代理设置》中的思路，虽然那是 Windows 端的，但分流逻辑相通。
六、验证代理是否生效
配置完成后，可以通过以下方法验证：
- curl 测试：执行
curl -I https://www.google.com，如果返回 200 或 301，说明代理生效。 - 查看环境变量：执行
env | grep -i proxy，确认 http_proxy、https_proxy、all_proxy 都已设置。 - IP 查询：执行
curl ipinfo.io，查看返回的 IP 是否为快连节点 IP。 - git 测试：执行
git clone https://github.com/octocat/Hello-World.git，如果能正常克隆，说明 git 代理生效。
如果验证失败，先检查 IP 和端口是否正确，再检查快连是否处于连接状态，最后检查 Windows 防火墙是否拦截了来自 WSL2 虚拟网卡的请求。
七、常见问题与排查
1. WSL2中ping不通宿主机IP
WSL2 的虚拟网络默认可能不允许 ICMP，ping 不通不代表代理不通。建议直接用 curl 测试代理端口，而不是依赖 ping。如果 curl 也超时，可以尝试在 Windows 防火墙中放行快连的代理端口，允许“专用网络”和“公用网络”访问。
2. 代理配置后部分命令仍然超时
有些命令不读取环境变量，或者使用了独立的网络栈。可以尝试为这些工具单独配置代理，或者使用 proxychains 等工具强制转发。另外，确认是否同时设置了大小写两种环境变量，部分工具只认其中一种。
3. 重启WSL2后IP变化导致代理失效
这是 NAT 模式的正常现象。建议使用本文介绍的动态获取 IP 方式，而不是把 IP 写死在配置里。每次打开终端时重新计算 HOST_IP，可以避免 IP 变化带来的问题。
4. DNS解析失败
WSL2 的 DNS 解析依赖 /etc/resolv.conf，如果该文件被覆盖或配置异常，可能导致域名无法解析。可以尝试在 /etc/wsl.conf 中添加 [network] generateResolvConf = false，然后手动配置 DNS。关于 DNS 的更多排查，可以参考《快连电脑版DNS污染检测与自定义DNS设置》。
5. Windows 11 镜像网络模式下的配置
如果你在 %UserProfile%\.wslconfig 中启用了 networkingMode=mirrored，WSL2 会与 Windows 共享网络接口，此时可以直接使用 127.0.0.1 作为代理地址：
export http_proxy="http://127.0.0.1:7890" export https_proxy="http://127.0.0.1:7890"
镜像模式下不需要再获取宿主机 IP，配置更简单，但需要 Windows 11 22H2 及以上版本支持。
6. 代理开启后本地服务访问异常
设置全局代理后，WSL2 访问 localhost 或局域网服务也可能被转发到代理，导致连接失败。可以在 no_proxy 环境变量中排除本地地址：
export no_proxy="localhost,127.0.0.1,::1,192.168.0.0/16,10.0.0.0/8"
这样本地和内网访问会绕过代理，避免不必要的绕路。
7. 快连断开后WSL2网络异常
如果快连断开，WSL2 的代理请求会失败，表现为所有网络操作超时。建议在快连断开时执行 proxy-off.sh 关闭代理，或者使用自动检测脚本。关于快连的稳定连接设置，可以参考《快连电脑版自动连接与断线重连设置》。
八、最佳实践建议
- 优先使用动态IP获取：不要写死宿主机IP，避免重启后失效。
- 区分全局和按需代理：日常开发如果经常需要访问国外资源，可以默认开启；如果只是偶尔需要，用脚本手动开关更灵活。
- 为常用工具单独配置：git、npm、pip、docker 等工具最好单独确认代理设置，不要完全依赖环境变量。
- 配置 no_proxy：排除本地和内网地址，避免本地服务访问异常。
- 保持快连客户端更新：新版本可能优化代理端口和局域网访问逻辑，建议从快连下载页面获取最新版本。
- 记录配置：把代理脚本和工具配置记录下来，换机或重装时快速恢复。关于配置备份，可以参考《快连电脑版如何备份与迁移配置文件》。
九、总结
WSL2 代理配置之所以让很多开发者头疼，根本原因在于它的网络架构与 Windows 宿主机是隔离的。只要理解了“WSL2 需要知道宿主机 IP 和代理端口”这一点，配置本身并不复杂。临时配置几条环境变量就能测试，持久化配置写入 shell 启动文件即可，再针对 git、npm、pip 等工具单独设置，基本可以覆盖日常开发需求。
如果你在配置过程中遇到问题，或者想了解更多快连使用技巧，欢迎访问快连技术博客，或联系快连官方客服获取支持。快连技术团队会持续输出实用教程，帮助大家在 Windows、Linux、WSL2 等各种环境下都能顺畅使用快连。