2025 年 11 月最新 Docker 镜像源加速列表与使用指南

举报
程序员老张 发表于 2025/11/02 11:15:17 2025/11/02
【摘要】 建议收藏本文,每月会更新镜像源可用性及配置细节。

2025年11月最新 Docker 镜像源加速列表与使用指南

本文汇总了当前可用且稳定的 Docker 镜像加速地址,覆盖 Docker、K8s containerd、Podman 等主流场景,零基础用户也能按步骤完成配置。

⚠️ 说明:本文内容仅限学习研究,请勿违规使用。建议收藏,以便获取后续更新。

2025年11月可用镜像加速源

1. 腾讯云镜像

  • 地址:https://mirror.ccs.tencentyun.com
  • 仅推荐在腾讯云服务器上使用,其他环境可能无法正常访问

2. 阿里云镜像

  • 地址:https://xxx.mirror.aliyuncs.com(不同账号专属地址不同)
  • 仅推荐在阿里云 ECS 环境中使用,需配合自身账号配置

3. 轩辕镜像(推荐优先使用)

  • 免费版(适合常规用户)
    • 地址:https://docker.xuanyuan.me
    • 无需登录,免费使用
    • 境内 CDN 加速,访问稳定
    • 兼容 Linux 桌面/服务器/NAS 设备,支持 containerd、Podman 环境
    • 提供官网搜索功能,方便查找镜像
  • 专业版(适合开发者、科研人员、企业及 NAS 用户)
    • 地址:https://xuanyuan.cloud
    • 需登录,提供专属加速地址(如 xxx.xuanyuan.run),速度更稳定
    • 支持 K8s(k3s/cri-o)、群晖/威联通/极空间 NAS 等特殊环境
    • 提供企业级支持、售后服务及定制化配置方案

一键安装与配置镜像加速(推荐方案)

Linux Docker & Docker Compose 一键安装配置脚本

脚本支持 13 种主流 Linux 发行版(含国产系统),可一键完成 Docker、Docker Compose 安装及轩辕镜像加速配置,无需手动操作。

执行命令

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

脚本特性与优势

  • 支持 13 种发行版:覆盖 openEuler、OpenCloudOS、Anolis OS、Alinux、Kylin Linux 等国产系统,以及 Fedora、Rocky Linux、Ubuntu、Debian、CentOS 等主流发行版
  • 国产系统深度适配:自动识别国产操作系统版本,提供最优配置方案
  • 多源智能切换:内置阿里云、腾讯云、华为云、中科大、清华等 6+ 国内镜像源,自动选择最快节点
  • 老版本兼容:支持 Ubuntu 16.04、Debian 9/10 等过期系统,自动适配兼容安装方案
  • 双重安装保障:包管理器安装失败时,自动切换到二进制安装,确保安装成功
  • 跨系统提示:检测到 macOS 或 Windows 系统时,自动提供 Docker Desktop 安装指引
  • 开源透明:脚本已在 GitHub 开源,可查看源码确认安全性

支持的操作系统详情

分类 操作系统 版本 支持状态 说明
国产操作系统 openEuler (欧拉) 20.03+, 22.03+, 24.03+ 华为开源,兼容 CentOS
OpenCloudOS 9.x 腾讯开源,兼容 CentOS 9
Anolis OS (龙蜥) 7.x, 8.x 阿里云支持,兼容 RHEL
Alinux (阿里云) 2.x, 3.x 阿里云 ECS 默认系统
Kylin Linux (银河麒麟) V10 国产系统,兼容 RHEL
CentOS 替代品 Rocky Linux 8.x, 9.x 10年支持周期,兼容 RHEL
AlmaLinux 8.x, 9.x 10年支持周期,兼容 RHEL
创新发行版 Fedora 34+ Red Hat 上游,含最新特性
传统发行版 Ubuntu 16.04+ 含老版本特殊兼容处理
Debian 9+ 含老版本特殊兼容处理
CentOS 7, 8, 9 包含 Stream 版本
RHEL 7, 8, 9 Red Hat 企业级发行版
Oracle Linux 7, 8, 9 Oracle 企业级发行版

💡 提示:脚本会自动检测系统类型和版本,无需手动选择安装方案,全程自动化完成。

手动配置镜像加速(已安装 Docker 环境)

Linux 系统

  1. 创建 Docker 配置目录并写入加速配置
# 创建配置目录
sudo mkdir -p /etc/docker

# 写入加速配置
cat <<EOF | sudo tee /etc/docker/daemon.json
{
  "registry-mirrors": ["https://docker.xuanyuan.me"]
}
EOF

# 重新加载配置并重启 Docker
sudo systemctl daemon-reload
sudo systemctl restart docker
  1. 验证配置:执行 docker info | grep "Registry Mirrors" -A 3,输出包含 https://docker.xuanyuan.me 即配置成功

macOS(Docker Desktop)

基础配置(免费加速源)

  1. 点击菜单栏 Docker 图标 → Preferences
  2. 找到 Daemon → Registry mirrors
  3. 添加地址 https://docker.xuanyuan.me
  4. 点击 Apply & Restart 完成重启

补充配置(轩辕专业版专属地址)

  1. 进入 Docker Desktop 设置 → 左侧 Docker Engine
  2. 按以下格式修改配置(替换 xxx.xuanyuan.run 为专属地址)
{
  "insecure-registries": ["xxx.xuanyuan.run"],
  "registry-mirrors": ["https://xxx.xuanyuan.run", "https://docker.xuanyuan.me"]
}
  1. 点击 Apply & Restart,通过 docker info 验证生效

Windows(Docker Desktop)

基础配置(免费加速源)

  1. 右键点击右下角 Docker 图标 → Settings
  2. 打开 Docker Daemon 配置,修改 JSON 内容
{
  "registry-mirrors": ["https://docker.xuanyuan.me"]
}
  1. 点击 Apply,等待 Docker 重启完成

补充配置(轩辕专业版专属地址)

  1. 进入 Docker Desktop → Settings → Docker Engine
  2. 按以下格式修改配置(替换 xxx.xuanyuan.run 为专属地址)
{
  "insecure-registries": ["xxx.xuanyuan.run"],
  "registry-mirrors": ["https://xxx.xuanyuan.run"]
}
  1. 点击 Apply 重启,通过 docker info 查看 Registry Mirrors 确认生效

其他容器环境加速配置

K8s containerd 镜像加速配置

适用于 Kubernetes(k3s/cri-o)或自建 containerd 环境,提升镜像拉取速度。

适用版本

containerd 版本 是否支持
< 1.4 不支持(语法差异)
1.4 ~ 1.7.x 完全支持
≥ 1.7.x 推荐使用

查看当前版本:containerd --version

配置步骤

  1. 初始化配置文件(若未生成)
containerd config default > /etc/containerd/config.toml
  1. 编辑配置文件:sudo nano /etc/containerd/config.toml
  2. plugins."io.containerd.grpc.v1.cri".registry.mirrors 节点下添加以下内容(替换 xxx.xuanyuan.run 为专属地址)
[plugins."io.containerd.grpc.v1.cri".registry]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
    # Docker Hub 加速
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
      endpoint = ["https://xxx.xuanyuan.run"]
    # K8s 旧版镜像仓库(k8s.gcr.io)
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."k8s.gcr.io"]
      endpoint = ["https://xxx-k8s.xuanyuan.run"]
    # GCR 镜像仓库
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"]
      endpoint = ["https://xxx-gcr.xuanyuan.run"]
    # GHCR 镜像仓库
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."ghcr.io"]
      endpoint = ["https://xxx-ghcr.xuanyuan.run"]
    # 新版 K8s 镜像仓库(registry.k8s.io)
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."registry.k8s.io"]
      endpoint = ["https://xxx.xuanyuan.run"]

生效与验证

# 重启 containerd
sudo systemctl restart containerd

# 验证配置
grep -A 5 "docker.io" /etc/containerd/config.toml

# 拉取测试镜像
ctr images pull xxx.xuanyuan.run/library/alpine:latest

# K8s 环境测试
kubectl run test-pod --image=nginx:latest
kubectl describe pod test-pod | grep "Image:"

Podman 镜像加速配置

适用于无守护进程的轻量场景,兼容 Docker 命令习惯。

配置步骤

  1. 新建自定义配置文件(推荐,避免覆盖系统默认配置)
sudo nano /etc/containers/registries.conf.d/custom.conf
  1. 写入以下配置(替换 xxx.xuanyuan.run 为专属地址)
# 默认搜索 Docker Hub
unqualified-search-registries = ['docker.io']

# Docker Hub 加速
[[registry]]
prefix = "docker.io"
insecure = true
location = "registry-1.docker.io"
  [[registry.mirror]]
  location = "xxx.xuanyuan.run"

# K8s.gcr.io 加速
[[registry]]
prefix = "k8s.gcr.io"
insecure = true
location = "k8s.gcr.io"
  [[registry.mirror]]
  location = "xxx-k8s.xuanyuan.run"

# GCR.io 加速
[[registry]]
prefix = "gcr.io"
insecure = true
location = "gcr.io"
  [[registry.mirror]]
  location = "xxx-gcr.xuanyuan.run"

# GHCR.io 加速
[[registry]]
prefix = "ghcr.io"
insecure = true
location = "ghcr.io"
  [[registry.mirror]]
  location = "xxx-ghcr.xuanyuan.run"
  1. 保存文件(Ctrl+O → 回车 → Ctrl+X)

验证生效

# 拉取测试镜像
podman pull docker.io/library/alpine:latest

# 查看镜像拉取来源
podman inspect alpine:latest | grep -i "registry"

镜像拉取使用示例

拉取官方镜像

# Docker(免费源)
docker pull docker.xuanyuan.me/library/mysql:5.7
docker pull docker.xuanyuan.me/library/nginx:1.25

# Docker(轩辕镜像专业版专属地址)
docker pull xxx.xuanyuan.run/library/mysql:8.0
docker pull xxx.xuanyuan.run/library/nginx:latest

# Podman(自动走加速)
podman pull mysql:5.7
podman pull nginx:1.25

# containerd(显式指定加速地址)
ctr images pull xxx.xuanyuan.run/library/mysql:5.7
ctr images pull xxx-k8s.xuanyuan.run/k8s.gcr.io/pause:3.9

拉取用户自定义镜像

# Docker 拉取 Docker Hub 用户镜像
docker pull xxx.xuanyuan.run/username/my-web-app:v1.0

# Docker 拉取 GHCR 用户镜像
docker pull xxx-ghcr.xuanyuan.run/username/my-tool:v2.1

# Podman 拉取 GHCR 用户镜像
podman pull ghcr.io/username/my-tool:v2.1

# containerd 拉取 GCR 用户镜像
ctr images pull xxx-gcr.xuanyuan.run/google-samples/node-hello:1.0

Docker Compose 使用示例

配置好加速源后,无需修改 docker-compose.yml,自动使用加速拉取镜像。

docker-compose.yml 示例(Nginx + MySQL)

version: "3.8"
services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./nginx/conf:/etc/nginx/conf.d
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: test_db
    volumes:
      - mysql-data:/var/lib/mysql
volumes:
  mysql-data:

运行与停止命令

# 启动服务(后台运行)
docker compose up -d

# 查看状态
docker compose ps

# 停止服务(保留数据)
docker compose down

# 停止并删除数据卷(谨慎使用)
docker compose down -v

containerd 单独使用示例

# 拉取镜像
ctr images pull xxx.xuanyuan.run/library/nginx:latest

# 运行容器
ctr run --rm -t --net-host xxx.xuanyuan.run/library/nginx:latest nginx-test

# 查看容器
ctr containers ls

# 停止容器
ctr tasks stop nginx-test

Podman 使用示例(兼容 Docker 命令)

# 运行 Redis 容器
podman run -d -p 6379:6379 --name redis-test redis:7.2

# 查看容器状态
podman ps

# 进入容器
podman exec -it redis-test redis-cli

# 停止并删除容器
podman stop redis-test
podman rm redis-test

常见问题(FAQ)

Q1:配置加速源后,部分镜像仍拉不下来?

核心原因是 registry-mirrors 仅对 Docker Hub 镜像生效。若拉取 ghcr.ioregistry.k8s.io 等第三方仓库镜像,需按对应环境配置专属加速(如 containerd 单独配置各仓库 mirrors,Podman 在 registries.conf 中添加对应镜像源);使用轩辕专业版可获取全仓库加速方案,或联系客服定制地址。

Q2:NAS(群晖、威联通)如何配置?

推荐使用轩辕镜像专业版,步骤如下:

  1. 登录轩辕官网,在「NAS 配置」专区选择对应设备型号;
  2. 按指引进入 NAS 的 Docker/containerd 配置界面(群晖需开启 SSH,威联通进入容器 Station 高级设置);
  3. 粘贴专属加速地址,保存并重启 NAS 容器服务;
  4. 拉取 nginx:latest 测试速度。

Q3:K8s 部署 Pod 提示镜像拉取失败?

  1. 检查 config.toml 是否配置了 Pod 所需镜像的仓库(如 registry.k8s.io);
  2. 重启 containerd 后,通过 kubectl describe pod <pod-name> 查看错误日志;
  3. 若为证书错误,可在对应仓库配置下添加 tls_config = { insecure_skip_verify = true }(仅测试环境使用);
  4. 若为 endpoint 不可达,确认加速地址正确性,或联系轩辕客服排查。

Q4:Podman 提示“insecure registry”错误?

  1. 若加速地址为 HTTP 协议:确保 registries.conf 中对应仓库 insecure = true,并开放对应端口;
  2. 若为 HTTPS 协议:检查地址是否包含 https://,且服务器证书有效;自签证书需放入 /etc/containers/certs.d/xxx.xuanyuan.run/ 目录。

Q5:企业环境如何保障稳定性?

  1. 使用轩辕专业版「企业专属节点」,获取独立 IP 和带宽;
  2. 配置多节点 fallback(如 endpoint = ["https://node1.xxx.xuanyuan.run", "https://node2.xxx.xuanyuan.run"]);
  3. 搭建 Harbor 本地镜像缓存,同步常用镜像;
  4. 开通「企业级监控」,实时查看节点状态和拉取日志。

总结

  1. 常规用户:优先使用一键安装脚本,或手动配置轩辕免费加速源 https://docker.xuanyuan.me,满足日常需求;
  2. 专业/企业用户:选择轩辕镜像专业版,获取专属地址,支持全环境适配和稳定售后服务;
  3. K8s/集群用户:重点配置 containerd 的多仓库加速,确保集群部署不超时;
  4. Podman 用户:通过 registries.conf 配置加速,适合轻量场景使用。

建议收藏本文,每月会更新镜像源可用性及配置细节;遇到问题可查看轩辕镜像官网 FAQ(https://xuanyuan.cloud/faq),或联系官网客服获取

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。