- 群晖 NAS Docker 加速 - 轩辕镜像配置手册
- 威联通 NAS Docker 加速 - 轩辕镜像配置手册
- 绿联 NAS Docker 加速 - 轩辕镜像配置手册
- 极空间 NAS Docker 加速 - 轩辕镜像配置手册
- 飞牛fnOS Docker 加速 - 轩辕镜像配置手册
- Docker Compose Docker 镜像加速 - 轩辕镜像配置手册
- K8s containerd 下载加速 - 轩辕镜像配置手册
- ghcr、Quay、nvcr、k8s、gcr 仓库下载加速 - 轩辕镜像配置手册
- Podman Docker 镜像下载加速 - 轩辕镜像配置手册
该脚本支持 13 种 Linux 发行版，包括国产操作系统（openEuler、Anolis OS、OpenCloudOS、Alinux、Kylin Linux），一键安装 docker、docker-compose 并自动配置轩辕镜像加速源。
# 下载并执行一键安装脚本
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
# 也可以使用 GitHub 上的脚本
bash <(curl -sSL https://raw.githubusercontent.com/SeanChang/xuanyuan_docker_proxy/refs/heads/main/docker.sh)脚本已开源： GitHub 源码
- ✅ 支持 13 种主流发行版：openEuler (欧拉)、OpenCloudOS、Anolis OS (龙蜥)、Alinux (阿里云)、Kylin Linux (银河麒麟)、Fedora、Rocky Linux、AlmaLinux、Ubuntu、Debian、CentOS、RHEL、Oracle Linux
- ✅ 国产操作系统完整支持：深度适配国产操作系统（openEuler、Anolis OS、OpenCloudOS、Alinux、Kylin Linux），支持版本自动识别和最优配置
- ✅ 多镜像源智能切换：内置阿里云、腾讯云、华为云、中科大、清华等 6+ 国内镜像源，自动检测并选择最快源
- ✅ 老版本系统特殊处理：支持 Ubuntu 16.04、Debian 9/10 等已过期系统，自动配置兼容的安装方案
- ✅ 双重安装保障：包管理器安装失败时自动切换到二进制安装，确保安装成功率
- ✅ macOS/Windows 友好提示：自动检测 macOS 和 Windows 系统，提供适合的 Docker Desktop 安装指引
我们的一键安装脚本支持 13 种主流 Linux 发行版，包括国产操作系统、CentOS 替代品和传统发行版：
| 操作系统 | 版本 | 支持状态 | 说明 |
|---|---|---|---|
| 🇨🇳 国产操作系统 | |||
| 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 Enterprise Linux |
| Oracle Linux | 7, 8, 9 | ✅ | Oracle 企业级发行版 |
💡 提示：脚本会自动检测您的操作系统类型和版本，并选择最优的安装方案。对于老版本系统（如 Ubuntu 16.04、Debian 9/10），脚本会自动使用兼容的安装方式。
- 复制上述命令到您的 Linux 终端
- 按提示选择版本（免费版或专业版）
- 如选择专业版，输入您的专属免登录地址
- 脚本将自动完成所有配置
轩辕镜像 提供高速稳定的 Docker 镜像加速服务，让您的 Docker 操作享受极速体验。
在 Linux 系统上配置轩辕镜像源，让所有 Docker 操作都享受高速加速体验。
在轩辕镜像个人中心获取您的专属免登录加速地址，格式为：xxx.xuanyuan.run
注意：
xxx.xuanyuan.run请替换为您的专属免登录加速地址，请登录网站后在个人中心获取。
使用以下命令配置 Docker daemon 文件：
echo '{"insecure-registries":["xxx.xuanyuan.run"],"registry-mirrors":["https://xxx.xuanyuan.run"]}' | sudo tee /etc/docker/daemon.json > /dev/null此命令会将镜像源配置写入 /etc/docker/daemon.json 文件
注意：
xxx.xuanyuan.run请替换为您的专属免登录加速地址，请登录网站后在个人中心获取。
重新加载 systemd daemon 配置：
systemctl daemon-reload重启 Docker 服务使配置生效：
systemctl restart docker重启后，Docker 将使用新的镜像源配置
验证配置是否生效：
docker info | grep -A 10 "Registry Mirrors"如果配置成功，您应该能看到您的轩辕镜像地址
配置完成后，您可以直接使用标准的 Docker 命令搜索镜像：
docker search nginx配置完成后，您可以直接使用标准的 Docker 命令拉取镜像：
docker pull mysql:latestPS: 不加 TAG 默认为 latest，建议指定具体的 TAG 版本进行下载。
很多用户反馈，已经在 Docker 中配置了镜像加速器（registry-mirrors），但拉取镜像时仍然访问官方源（docker.io）。
拉取报错如下：
Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client. Timeout exceeded while awaiting headers)
这是因为 Docker 的镜像拉取机制是优先尝试使用镜像加速器，而不是强制始终使用。部分镜像的 tag 或 namespace 特殊（如 docker-library），可能仍绕过加速器。
如果你使用免登录地址，但该地址没有购买流量，当 Docker 客户端请求加速器时，服务端会返回 402 Payment Required 错误，Docker 就会直接回退到官方仓库 docker.io 拉取镜像。
解决方案: 请前往轩辕镜像充值页面购买相应的流量包，确保您的免登录地址有足够的流量支持镜像加速服务。
建议先用下列方式测试：
docker pull abc123def456.xuanyuan.run/mysql如果能正常拉取，说明免登录地址可用且有流量。
如果配置后仍然不生效，建议参考下列文档拉取镜像：
访问 轩辕镜像官网 获取更多配置教程和技术支持。