部署 Docker 后海外 VPS 拉取镜像超时怎么配置国内加速源？

部署 Docker 后海外 VPS 拉取镜像超时，最推荐的处理方向是配置 Docker 注册表镜像加速（Registry Mirrors）。适用场景为 Linux 服务器环境，风险边界在于公共加速源可能随时失效或需要认证，需准备备用源。

先说结论：通过修改 Docker 守护进程配置文件 daemon.json 添加国内镜像地址，可解决拉取超时问题。

适合：Linux 系统且已安装 Docker Engine 的 VPS
先准备：获取当前可用的国内镜像加速地址
验收：执行 docker info 确认 Registry Mirrors 已加载

命令速用版

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://<your-mirror>.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

为什么会这样

Docker 默认镜像仓库位于海外，国内或海外 VPS 直连时常因网络延迟导致连接超时。配置镜像加速源后，Docker 会优先从国内缓存节点拉取层数据，减少跨国传输耗时。

分步处理

1. 备份原有配置：若 /etc/docker/daemon.json 已存在，先执行 cp /etc/docker/daemon.json /etc/docker/daemon.json.bak 备份。

2. 写入加速地址：使用文本编辑器或 echo 命令写入 JSON 配置，确保 registry-mirrors 字段为数组格式。

3. 重载守护进程：执行 systemctl daemon-reload 让系统识别配置变更。

4. 重启 Docker 服务：执行 systemctl restart docker 使配置生效，注意这会中断正在运行的容器网络。

怎么验证是否生效

执行 docker info 命令，查看输出中 Registry Mirrors 部分是否包含配置的地址。随后执行 docker pull hello-world，观察拉取速度是否稳定且无超时报错。

常见坑

JSON 格式错误会导致 Docker 无法启动，确保逗号、括号闭合正确。部分云厂商镜像地址需要登录控制台获取专属链接，公共地址可能受限。配置生效后若 Docker 启动失败，查看 journalctl -u docker 排查日志。

常见问题

配置文件路径在哪里？

Linux 系统默认路径为 /etc/docker/daemon.json，不存在时需手动创建。

配置多个镜像源怎么写？

在 registry-mirrors 数组中按顺序填入多个 URL，Docker 会依次尝试直到成功。

修改配置后需要重启服务器吗？

不需要重启服务器，只需重启 Docker 服务即可生效。

参考来源

1. Docker 官方文档 - Daemon configuration file
URL: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file

2. 阿里云容器镜像服务 - 镜像加速器
URL: https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors