在京东云服务器(JCS,JD Cloud Server)上配置国内 Docker 镜像仓库(提速器),主要是为了提升 docker pull、docker build 等操作的拉取速度,避免访问默认的 Docker Hub(hub.docker.com)因网络延迟或限速导致超时失败。
以下是推荐且经验证的完整配置方法(适用于 Ubuntu/Debian/CentOS/RHEL 等主流 Linux 发行版):
✅ 一、推荐使用「京东云官方镜像提速器」(优先推荐)
京东云提供专属镜像提速服务(免费、稳定、低延迟),地址为:
👉 https://jdcprod1001.mirror.jdcloud.com
(该地址已通过京东云内网优化,对京东云 ECS 实例效果最佳)
🔍 验证方式:在京东云控制台 → 【容器服务】→ 【镜像仓库】或【文档中心】搜索“镜像提速器”,可查到最新官方地址。当前(2024)仍有效,支持 HTTPS + 认证(无需登录即可使用公共镜像提速)。
✅ 二、配置 Docker 镜像提速器(标准步骤)
1️⃣ 创建/编辑 Docker 守护进程配置文件
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://jdcprod1001.mirror.jdcloud.com",
"https://docker.mirrors.ustc.edu.cn", // 中科大(备用)
"https://registry.docker-cn.com", // 官方中国站(已逐步停用,可选)
"https://mirror.baidubce.com" // 百度(备用)
],
"live-restore": true,
"log-driver": "json-file",
"log-opts": {
"max-size": "100m",
"max-file": "3"
}
}
EOF
✅ 说明:
registry-mirrors是数组,Docker 会按顺序尝试,首个失败则自动 fallback;- 京东云地址放首位,确保优先走内网提速;
- 所有地址均为 HTTPS,无需额外证书配置。
2️⃣ 重载 Docker 配置并重启服务
# 重新加载配置
sudo systemctl daemon-reload
# 重启 Docker 服务(注意:会短暂中断正在运行的容器)
sudo systemctl restart docker
# 可选:检查是否生效
sudo docker info | grep "Registry Mirrors" -A 5
✅ 正常输出应包含:
Registry Mirrors:
https://jdcprod1001.mirror.jdcloud.com/
https://docker.mirrors.ustc.edu.cn/
...
3️⃣ 验证提速效果(可选)
# 拉取一个基础镜像(首次会缓存,第二次明显更快)
time sudo docker pull nginx:alpine
# 查看实际使用的镜像源(日志中可观察)
sudo journalctl -u docker --since "1 hour ago" | grep -i "mirror|jdcprod"
✅ 三、进阶建议(京东云用户专属)
| 场景 | 建议 |
|---|---|
| 🌐 私有镜像仓库(JCR) | 若需托管私有镜像,开通 京东云容器镜像服务 JCR ,支持 VPC 内网免密拉取(更安全+零公网流量);配置方式:sudo docker login --username=xxx --password=xxx jcr.cn-north-1.jcloudcs.com/your-namespace |
| 🚀 Kubernetes 集群(JDKE) | 在 JDKE 节点上同样配置 /etc/docker/daemon.json;或通过节点池自定义镜像预装提速配置。 |
| 🛑 Docker Desktop(Windows/macOS) | 若本地开发连接京东云服务器,本地 Docker Desktop 也建议配置相同镜像源,保持体验一致。 |
❌ 注意事项(避坑指南)
- ⚠️ 不要使用已失效地址(如旧版
https://registry.docker-cn.com已于 2023 年底停止服务); - ⚠️ 避免在
daemon.json中混用 HTTP(非 HTTPS)镜像源(Docker 默认禁用,需额外加"insecure-registries",不推荐); - ⚠️ 修改后务必
systemctl daemon-reload && systemctl restart docker,仅 reload 不生效; - ⚠️ 京东云部分老版本系统(如 CentOS 7 + Docker 18.09)需确认
overlay2存储驱动已启用(sudo docker info | grep "Storage Driver")。
✅ 附:一键脚本(复制即用)
# 运行前请确认已安装 Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 配置京东云提速器
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{"registry-mirrors": ["https://jdcprod1001.mirror.jdcloud.com"]}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker
sudo docker info | grep "Registry Mirrors" -A 1
如有特殊需求(如企业级 Harbor 私有仓库对接、镜像签名验证、CI/CD 流水线集成),可进一步提供场景,我可为你定制方案。
需要我帮你生成 JCR(京东云容器镜像服务)的完整私有仓库配置流程 或 配合 Jenkins/GitLab CI 的最佳实践 吗? 😊
CLOUD技术笔记