WSL Ubuntu Docker 代理自动配置教程
WSL Ubuntu Docker 代理自动配置教程
WSL Ubuntu Docker 代理自动配置教程
背景说明
在 WSL2 环境下使用 Docker 时，由于网络环境限制，经常需要通过 Windows 主机上的代理来访问 Docker Hub。但每次 Windows 重启后，WSL 获取到的主机 IP 地址可能会发生变化，导致 Docker 代理配置失效。
本教程将帮你配置一个自动化方案，让 Docker 在每次 WSL 启动时都能自动获取最新的 Windows 主机 IP 并配置代理。
解决的问题
- ✅ IP 地址动态变化：自动获取最新的 Windows 主机 IP
- ✅ 开机自动配置：WSL 启动时自动设置 Docker 代理
- ✅ 避免重复执行：只在系统层面执行一次，不会每次打开终端都重复设置
- ✅ 时序问题：确保在 Docker 启动前就配置好代理
前提条件
- WSL2 Ubuntu 系统
- Docker 已安装并可正常运行
- Windows 上运行着代理服务（本教程以 7890 端口为例）
配置步骤
步骤 1：创建代理配置脚本
创建专门用于 systemd 服务的 Docker 代理配置脚本：
# 创建脚本文件
nano ~/setup_docker_proxy_systemd.sh
脚本内容：
#!/bin/bash# 专门给 systemd 服务使用的 Docker 代理配置脚本
# 此脚本以 root 身份运行，不需要使用 sudo# 获取 Windows 宿主机 IP
HOST_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
PROXY_PORT=7890echo "Setting up Docker proxy with Windows host IP: $HOST_IP:$PROXY_PORT"# 检查代理是否可用（可选，失败不会阻止执行）
if ! timeout 2 nc -z $HOST_IP $PROXY_PORT 2>/dev/null; thenecho "Warning: Proxy server not reachable at $HOST_IP:$PROXY_PORT"
fi# 创建 Docker systemd 代理配置文件
mkdir -p /etc/systemd/system/docker.service.d# 动态生成代理配置文件
cat > /etc/systemd/system/docker.service.d/http-proxy.conf << EOF
[Service]
Environment="HTTP_PROXY=http://${HOST_IP}:${PROXY_PORT}"
Environment="HTTPS_PROXY=http://${HOST_IP}:${PROXY_PORT}"
Environment="NO_PROXY=localhost,127.0.0.1,::1,10.0.0.0/8,192.168.0.0/16,172.16.0.0/12"
EOF# 重新加载 systemd 配置
systemctl daemon-reloadecho "Docker proxy configuration updated for host IP: $HOST_IP:$PROXY_PORT"
给脚本添加执行权限：
chmod +x ~/setup_docker_proxy_systemd.sh
步骤 2：创建 systemd 服务
创建 systemd 服务配置文件：
# 创建服务文件
nano ~/docker-proxy-update.service
服务文件内容：
[Unit]
Description=Update Docker proxy with current Windows host IP
After=network.target
Before=docker.service[Service]
Type=oneshot
ExecStart=/home/user/setup_docker_proxy_systemd.sh
RemainAfterExit=yes
User=root[Install]
WantedBy=multi-user.target
注意：请将 /home/user/ 替换为你的实际用户主目录路径。
步骤 3：安装并启用服务
# 复制服务文件到系统目录
sudo cp docker-proxy-update.service /etc/systemd/system/# 重新加载 systemd 配置
sudo systemctl daemon-reload# 启用服务（开机自启）
sudo systemctl enable docker-proxy-update.service# 启动服务进行测试
sudo systemctl start docker-proxy-update.service
步骤 4：验证配置
检查服务状态：
# 查看服务状态
sudo systemctl status docker-proxy-update.service# 查看生成的配置文件
cat /etc/systemd/system/docker.service.d/http-proxy.conf# 验证 Docker 环境变量
sudo systemctl show docker --property=Environment
重启 Docker 服务以应用配置：
sudo systemctl restart docker
步骤 5：测试 Docker 代理
测试是否能正常拉取镜像：
# 测试拉取小镜像
sudo docker pull hello-world# 测试拉取稍大的镜像
sudo docker pull nginx:alpine
如果能成功拉取，说明代理配置成功！
清理旧配置（可选）
如果之前在 .bashrc 中配置过 Docker 代理，建议清理掉避免冲突：
# 编辑 .bashrc
nano ~/.bashrc# 删除或注释掉类似以下的行：
# ~/setup_docker_proxy.sh
# (~/setup_docker_proxy.sh > /dev/null 2>&1 &)
工作原理
- 启动时机：WSL 启动 → systemd 启动 →
docker-proxy-update.service运行 - IP 获取：服务从
/etc/resolv.conf动态获取最新的 Windows 主机 IP - 配置生成：自动生成
/etc/systemd/system/docker.service.d/http-proxy.conf文件 - Docker 应用：Docker 服务启动时自动读取代理配置
文件结构
配置完成后，相关文件分布如下：
/home/user/
├── setup_docker_proxy_systemd.sh # 代理配置脚本
└── docker-proxy-update.service # 服务配置文件（备份）/etc/systemd/system/
├── docker-proxy-update.service # systemd 服务文件
└── docker.service.d/└── http-proxy.conf # Docker 代理配置文件
故障排除
问题 1：服务启动失败
# 查看详细错误信息
sudo journalctl -u docker-proxy-update.service -f
问题 2：代理不生效
# 检查代理服务器是否可达
nc -z $(cat /etc/resolv.conf | grep nameserver | awk '{print $2}') 7890# 手动重新运行配置脚本
sudo ~/setup_docker_proxy_systemd.sh# 重启 Docker
sudo systemctl restart docker
问题 3：IP 地址变化后代理失效
由于服务只在启动时运行一次，如果 Windows 重启后 IP 变化，需要：
# 重新运行服务
sudo systemctl start docker-proxy-update.service# 或者重启 WSL（推荐）
自定义配置
修改代理端口
如果你的代理端口不是 7890，修改脚本中的 PROXY_PORT 变量：
# 编辑脚本
nano ~/setup_docker_proxy_systemd.sh# 修改这一行
PROXY_PORT=你的端口号
添加更多 NO_PROXY 地址
如果需要排除更多地址不走代理，修改脚本中的 NO_PROXY 环境变量。
验证清单
- 脚本文件已创建并有执行权限
- systemd 服务已安装并启用
- 服务运行状态正常
- Docker 配置文件已生成
- Docker 能成功拉取镜像
- 重启 WSL 后代理仍然生效
总结
通过这个配置方案，你的 WSL Ubuntu Docker 将能够：
- 自动适应 IP 变化：每次启动都获取最新的 Windows 主机 IP
- 开机即可用：无需手动配置，WSL 启动后 Docker 代理自动生效
- 一次配置，长期使用：无需重复操作，稳定可靠
现在你可以愉快地使用 docker pull 命令，无论何时重启都不用担心代理配置问题了！