Docker Mirror#

自动处理 Docker 镜像拉取失败，切换到国内镜像源。

工作原理#

1. 先尝试官方 registry ( docker.io)
2. 失败则按顺序尝试备用镜像
3. 成功后 tag 回原名并清理镜像残留

使用方法#

bash

# 拉取镜像（核心用法）
bash ./scripts/docker.sh pull <镜像名>[:标签]

# 示例
bash ./scripts/docker.sh pull nginx:latest
bash ./scripts/docker.sh pull redis:alpine
bash ./scripts/docker.sh pull postgres:15

其他 Docker 命令#

非 pull 命令直接透传给 docker：

bash

bash ./scripts/docker.sh ps -a
bash ./scripts/docker.sh images
bash ./scripts/docker.sh run -it nginx:latest
bash ./scripts/docker.sh stop nginx

镜像源状态#

最新验证结果（2026-03-29）：

镜像源状态备注docker.io❌ 超时国内访问不稳定docker.1ms.run✅ 可用主要备用源docker.m.daocloud.io✅ 可用DaoCloud 镜像

已验证可正常拉取： hello-world、 nginx:latest、 nginx:alpine

故障排除#

如果 docker.sh pull 失败：

1. 检查 Docker daemon 是否运行： bash

   bash ./scripts/docker.sh ps
   
   

2. 查看本地镜像： bash

   bash ./scripts/docker.sh images
   
   

3. 手动指定镜像源： bash

   bash ./scripts/docker.sh pull docker.1ms.run/library/nginx
   
   

环境依赖#

• sg 命令（sgdocker 组权限）
• docker 已安装且 daemon 运行中