镜像加速器仅对docker pull有效，对docker push无效；拉取时通过registry-mirrors配置国内镜像源（如阿里云、腾讯云）加速，推送则需改用国内仓库、压缩镜像等优化。
docker 镜像推送与拉取的加速，核心在于拉取环节可加速，推送环节无法通过镜像加速器提速。这一点必须先厘清：镜像加速器（registry mirror）只对 docker pull 有效，它本质是为 docker hub 等公共仓库做的国内缓存代理；而 docker push 是你主动上传镜像到目标仓库（如 docker hub、harbor、阿里云 acr），走的是你本地网络直连该仓库的路径，加速器不参与也不起作用。
下面分两块讲清楚怎么做、为什么这么做：
拉取国外镜像：靠 registry-mirrors 配置生效
这是加速器唯一管用的场景。当你执行 docker pull nginx 或 docker pull python:3.11 这类从 Docker Hub 拉取的命令时，Docker 守护进程会优先查询你配置的镜像源列表，而不是直连 registry-1.docker.io。
- 加速器地址必须是 HTTPS 协议，且格式为完整 URL（如
@#@#@#@#@#@#@#@#@#@0，不能少https://） - 可同时配置多个镜像源，Docker 会按顺序尝试，第一个可用即用（不是负载均衡）
- 热门镜像（ubuntu、alpine、redis 等）基本已预热缓存，首次拉取也快；冷门镜像或带特殊 tag 的，第一次仍需回源，但后续就快了
推荐当前（2026年10月）稳定可用的几个国内镜像源：
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 阿里云（需登录控制台获取专属地址）：
https://<your-id>.mirror.aliyuncs.com</your-id> - 腾讯云：
https://mirror.ccs.tencentyun.com - 网易：
http://hub-mirror.c.163.com（支持 HTTP，兼容性好） - 中科大：
https://mirrors.ustc.edu.cn - 百度云：
https://<unique-id>.mirror.baidubce.com</unique-id>（ECS 用户推荐）
推送国外镜像：不走加速器，但有替代优化路径
docker push 不经过 mirror，所以配了 registry-mirrors 对推送完全没影响。如果你要推送到 Docker Hub，速度取决于你本地出口带宽和国际链路质量。这时可考虑以下实际可行的优化方式：
- 避免直接推到 Docker Hub：改用国内云厂商的私有镜像仓库（如阿里云 ACR、腾讯云 TCR），它们在国内机房，
push和pull都快 - 压缩镜像再推送：构建时用多阶段构建、删除调试工具、合并 RUN 层，减小镜像体积，自然缩短上传时间
- 使用
docker push --quiet减少日志输出开销（微小提升，适合 CI 场景） - 确认是否真在推“国外”镜像：如果你
push的是自己打的 tag（如myapp:v1），目标仓库是你自建 Harbor 或云上 ACR，那就不是“国外”问题，而是你仓库部署位置的问题——把仓库建在国内节点即可
验证加速是否真正起作用
别只看配置写了就以为成功。最直接的验证方式是：
- 运行
docker info | grep -A 5 "Registry Mirrors"，确认输出里有你填的地址 - 执行
time docker pull alpine:latest，记录耗时；再临时禁用加速（改配置为空并重启 docker），对比两次结果 - 观察拉取过程中的域名：用
tcpdump或docker events可看到实际请求发往哪个 host，确认是不是走的你配的镜像源
记住一个关键边界：加速器只对 Docker Hub 上的公开镜像有效。如果你拉的是 gcr.io/k8s-staging-xxx、quay.io/coreos/etcd 或企业内网 Harbor 地址，registry-mirrors 不会转发，得单独配 insecure-registries 或用代理工具（如 Nexus 或自建 registry 作中转）。
