对于开发者来说，WSL2和Docker几乎是日常工作的标配。但很多人在使用快连电脑版时发现：宿主机浏览器能正常访问GitHub，但WSL2终端里 git clone 却超时；Windows上 npm install 很快，Docker容器里拉取镜像却卡住不动。这不是快连的问题，而是WSL2和Docker的网络模型与宿主机隔离，需要额外的代理桥接配置。
本文将从网络原理讲起，提供一套完整的配置方案，让WSL2、Docker容器内的开发工具都能顺畅走快连代理。如果你还没有安装客户端，可以前往快连下载页面获取最新版本。
一、为什么WSL2和Docker默认不走快连代理
要理解这个问题，先要理解快连电脑版的工作方式。快连在Windows上创建一个虚拟网卡（TUN/TAP），接管系统流量。宿主机上的应用（浏览器、Git for Windows等）会遵循系统代理设置，因此能走快连。
但WSL2和Docker的网络模型不同：
- WSL2：运行在一个轻量级虚拟机中，拥有独立的虚拟网络（默认是NAT模式）。它有自己的IP地址（如172.x.x.x），发往外网的流量默认不经过Windows的代理设置。
- Docker Desktop：同样运行在虚拟机中，容器网络与宿主机隔离。容器内应用的代理配置需要单独指定。
简单说，快连代理了宿主机，但WSL2和Docker是“另一个世界”的设备，需要显式告诉它们“代理在哪里”。
二、WSL2代理配置：三种方案
WSL2的代理配置有三种思路，按推荐程度排序。
方案一：使用镜像网络模式（推荐，Windows 11 22H2+）
Windows 11 22H2及以上版本支持WSL2的“镜像网络模式”（Mirrored Networking）。开启后，WSL2与Windows共享网络接口，WSL2里的 localhost 可以直接访问Windows的服务，代理配置也会自动继承。
开启方法：在Windows用户目录下创建或编辑 .wslconfig 文件（路径：C:\Users\你的用户名\.wslconfig），添加以下内容：
[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true保存后，在PowerShell中执行 wsl --shutdown 重启WSL。重启后，WSL2会自动使用Windows的代理设置，无需额外配置。autoProxy=true 会自动同步系统代理环境变量。
这是最省心的方案，推荐所有符合条件的用户使用。
方案二：手动设置环境变量
如果你的Windows版本不支持镜像模式，可以在WSL2中手动设置代理环境变量。在WSL2的终端中执行：
export http_proxy="http://宿主机IP:端口"
export https_proxy="http://宿主机IP:端口"
export all_proxy="socks5://宿主机IP:端口"宿主机IP的获取方法：在WSL2中执行 cat /etc/resolv.conf，nameserver 后面的地址通常就是宿主机IP。或者使用 ip route show | grep -i default 获取网关地址。
端口需要查看快连电脑版的设置。在“设置” → “连接设置”或“高级设置”中，找到“本地代理端口”或“HTTP代理端口”。常见的端口有7890、1080、8888等，具体以你的客户端显示为准。
为了让配置永久生效，可以将上述export命令添加到 ~/.bashrc 或 ~/.zshrc 文件末尾。但需要注意：宿主机IP可能会变化，建议写成动态获取的方式：
export hostip=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy="http://$hostip:7890"
export https_proxy="http://$hostip:7890"方案三：使用proxychains-ng
如果只有部分命令需要走代理，可以使用 proxychains-ng。安装后编辑 /etc/proxychains.conf，在末尾添加：
http 宿主机IP 7890之后用 proxychains4 git clone ... 的方式执行命令即可。这种方式适合临时使用，不需要全局代理。
三、Docker容器代理配置
Docker的代理配置分为两个层面：Docker守护进程（用于拉取镜像）和容器内部应用。
配置Docker守护进程代理
Docker Desktop for Windows的代理设置可以在“Settings” → “Resources” → “Proxies”中配置。填入快连的HTTP代理地址和端口，点击“Apply & Restart”。这样 docker pull 拉取镜像时会走代理。
如果使用Docker CLI，也可以在 ~/.docker/config.json 中配置：
{
"proxies": {
"default": {
"httpProxy": "http://宿主机IP:7890",
"httpsProxy": "http://宿主机IP:7890",
"noProxy": "localhost,127.0.0.1"
}
}
}配置容器内部应用的代理
容器启动时，可以通过环境变量注入代理设置：
docker run -e http_proxy=http://宿主机IP:7890 \
-e https_proxy=http://宿主机IP:7890 \
your-image或者在Dockerfile中设置（不推荐，因为会硬编码IP）：
ENV http_proxy=http://宿主机IP:7890
ENV https_proxy=http://宿主机IP:7890如果容器需要访问宿主机的代理，注意在Windows上使用 host.docker.internal 代替具体的宿主机IP。例如：
-e http_proxy=http://host.docker.internal:7890host.docker.internal 是Docker Desktop提供的特殊DNS名称，指向宿主机。
四、验证代理是否生效
配置完成后，需要在WSL2和容器中分别验证。
WSL2验证
在WSL2终端执行：
curl -I https://www.google.com如果返回HTTP 200或301/302，说明代理生效。如果超时或连接被拒绝，说明配置有问题。
也可以执行 curl ipinfo.io 查看出口IP，确认是否为快连节点的IP。
Docker验证
启动一个临时容器测试：
docker run --rm -e http_proxy=http://host.docker.internal:7890 \
curlimages/curl -I https://www.google.com如果能返回正常响应，说明容器代理配置成功。
五、常见问题与排查
问题1：WSL2设置了代理但git clone仍然失败
可能原因：Git默认不读取 http_proxy 环境变量，需要单独配置：
git config --global http.proxy http://宿主机IP:7890
git config --global https.proxy http://宿主机IP:7890取消代理使用 git config --global --unset http.proxy。
问题2：npm/pip安装慢
npm和pip也需要单独设置代理：
npm config set proxy http://宿主机IP:7890
npm config set https-proxy http://宿主机IP:7890
pip config set global.proxy http://宿主机IP:7890问题3：宿主机IP经常变
WSL2每次重启后宿主机IP可能变化。如果使用方案二，建议在 ~/.bashrc 中使用动态获取方式（如前文所示）。或者直接使用方案一的镜像模式，一劳永逸。
问题4：Docker容器内DNS解析失败
这通常是DNS泄漏或DNS配置问题。可以在Docker Desktop的“Settings” → “Docker Engine”中配置DNS：
{
"dns": ["8.8.8.8", "1.1.1.1"]
}关于DNS的更多排查方法，可以参考DNS泄漏检测与修复一文。
问题5：快连端口号在哪里看
打开快连电脑版，进入“设置” → “连接设置”或“高级设置”，找到“本地代理”或“HTTP代理”相关选项。如果找不到端口信息，可以在“帮助” → “关于”中查看，或联系技术支持。部分版本默认不开启本地代理端口，需要在设置中手动启用。
六、进阶：按需代理与分流
有些开发者希望“国内源直连、国外源走代理”，以兼顾速度和稳定性。可以在WSL2中配置 no_proxy 环境变量，排除国内镜像源：
export no_proxy="localhost,127.0.0.1,*.aliyun.com,*.tsinghua.edu.cn,*.ustc.edu.cn"这样访问阿里云、清华源、中科大源时不会走代理，速度更快。Docker同理，可以在 config.json 的 noProxy 字段中添加排除列表。
如果需要在WSL2中实现更精细的分流，可以结合快连的自定义路由规则。具体规则写法可以参考快连分流规则优先级详解。
七、总结
WSL2和Docker的代理配置并不复杂，关键是理解它们的网络模型与宿主机隔离。核心方案回顾：
- WSL2：优先使用镜像网络模式（
.wslconfig），旧版系统使用环境变量或proxychains。 - Docker：在Docker Desktop中配置守护进程代理，容器内通过环境变量注入代理。
- 常用工具：git、npm、pip需要单独设置代理。
- 验证：用
curl或ipinfo.io确认出口IP。
配置完成后，你就能在WSL2和Docker中顺畅使用快连代理，享受一致的开发体验。如果遇到问题，可以查阅快连常见问题页面，或浏览快连技术博客的其他文章。还没有体验过快连的用户，欢迎前往快连下载页面下载最新客户端。