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

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

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

2025年12月可用镜像加速源

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
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 开源，可查看源码确认安全性

支持的操作系统详情

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

手动配置镜像加速（已安装 Docker 环境）

Linux 系统

1. 创建 Docker 配置目录并写入加速配置

bash
# 创建配置目录
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

2. 验证配置：执行 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 为专属地址）

json
{
  "insecure-registries": ["xxx.xuanyuan.run"],
  "registry-mirrors": ["https://xxx.xuanyuan.run", "https://docker.xuanyuan.me"]
}

3. 点击 Apply & Restart，通过 docker info 验证生效

Windows（Docker Desktop）

基础配置（免费加速源）

1. 右键点击右下角 Docker 图标 → Settings
2. 打开 Docker Daemon 配置，修改 JSON 内容

json
{
  "registry-mirrors": ["https://docker.xuanyuan.me"]
}

3. 点击 Apply，等待 Docker 重启完成

补充配置（轩辕专业版专属地址）

1. 进入 Docker Desktop → Settings → Docker Engine
2. 按以下格式修改配置（替换 xxx.xuanyuan.run 为专属地址）

json
{
  "insecure-registries": ["xxx.xuanyuan.run"],
  "registry-mirrors": ["https://xxx.xuanyuan.run"]
}

3. 点击 Apply 重启，通过 docker info 查看 Registry Mirrors 确认生效

其他容器环境加速配置

K8s containerd 镜像加速配置

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

适用版本

查看当前版本：containerd --version

配置步骤

1. 初始化配置文件（若未生成）

bash
containerd config default > /etc/containerd/config.toml

2. 编辑配置文件：sudo nano /etc/containerd/config.toml
3. 在 plugins."io.containerd.grpc.v1.cri".registry.mirrors 节点下添加以下内容（替换 xxx.xuanyuan.run 为专属地址）

toml
[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"]

生效与验证

bash
# 重启 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. 新建自定义配置文件（推荐，避免覆盖系统默认配置）

bash
sudo nano /etc/containers/registries.conf.d/custom.conf

2. 写入以下配置（替换 xxx.xuanyuan.run 为专属地址）

toml
# 默认搜索 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"

3. 保存文件（Ctrl+O → 回车 → Ctrl+X）

验证生效

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

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

镜像拉取使用示例

拉取官方镜像

bash
# 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

拉取用户自定义镜像

bash
# 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）

yaml
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:

运行与停止命令

bash
# 启动服务（后台运行）
docker compose up -d

# 查看状态
docker compose ps

# 停止服务（保留数据）
docker compose down

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

containerd 单独使用示例

bash
# 拉取镜像
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 命令）

bash
# 运行 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.io、registry.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），或联系官网客服获取