WSL Ubuntu Docker 代理自动配置教程

WSL Ubuntu Docker 代理自动配置教程

背景说明

在 WSL2 环境下使用 Docker 时，由于网络环境限制，经常需要通过 Windows 主机上的代理来访问 Docker Hub。但每次 Windows 重启后，WSL 获取到的主机 IP 地址可能会发生变化，导致 Docker 代理配置失效。

本教程将帮你配置一个自动化方案，让 Docker 在每次 WSL 启动时都能自动获取最新的 Windows 主机 IP 并配置代理。

解决的问题

1. ✅ IP 地址动态变化：自动获取最新的 Windows 主机 IP
2. ✅ 开机自动配置：WSL 启动时自动设置 Docker 代理
3. ✅ 避免重复执行：只在系统层面执行一次，不会每次打开终端都重复设置
4. ✅ 时序问题：确保在 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 &)

工作原理

1. 启动时机：WSL 启动 → systemd 启动 → docker-proxy-update.service 运行
2. IP 获取：服务从 /etc/resolv.conf 动态获取最新的 Windows 主机 IP
3. 配置生成：自动生成 /etc/systemd/system/docker.service.d/http-proxy.conf 文件
4. 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 将能够：

1. 自动适应 IP 变化：每次启动都获取最新的 Windows 主机 IP
2. 开机即可用：无需手动配置，WSL 启动后 Docker 代理自动生效
3. 一次配置，长期使用：无需重复操作，稳定可靠

现在你可以愉快地使用 docker pull 命令，无论何时重启都不用担心代理配置问题了！