轩辕镜像免费版使用说明与注意事项
轩辕镜像免费版配置方法、镜像加速与使用说明、注意事项与免责说明
服务定位
docker.xuanyuan.me为轩辕镜像免费公共测试服务的访问入口之一，仅用于学习、体验和测试用途，不承诺访问速度、稳定性或持续可用性。
如对镜像的安全性、稳定性及可追溯性有较高要求，建议使用 轩辕镜像官方专业版（xuanyuan.cloud），以获得更高稳定性、持续可用性与技术支持服务。
重要说明与注意事项
docker.xuanyuan.me 为开放式公共测试节点，不适用于生产环境或自动化使用场景。 由于承载大量自动化、CI/CD 与批量拉取等非交互访问，负载具有不可控性，可能出现限流、中断等情况，且 不提供任何形式的可用性或稳定性保障。
轩辕镜像不建议在生产环境或对安全敏感的场景中使用任何免费公共镜像服务；免费测试节点的运行状态 不代表 轩辕镜像专业版服务水平。
以下场景请务必使用专业版服务：生产环境部署、CI/CD 持续集成、集群或大规模节点部署、对稳定性与可用性有明确要求的业务。
为保障整体体验与公共资源合理分配，免费版对访问设有适度限制，具体规则见 黑名单与使用说明。
更多问题可先查阅 常见问题。
镜像使用方法
以下配置均以免费版镜像加速域名 docker.xuanyuan.me为例：可先使用一键脚本完成 Docker 安装与镜像源配置，再按需采用手动修改 daemon.json 或临时拉取等方式。
一键安装脚本（推荐优先尝试）
Linux 下可使用官方一键脚本安装 Docker 并配置镜像源（与免费版落地页一致）：
更多文档与专业版拉取：
- Docker 安装与详细使用方法
- Linux 配置镜像源
- 轩辕镜像专业版拉取方式： 登录仓库拉取、 专属域名拉取
方式一：配置 registry-mirrors
1、编辑或写入 /etc/docker/daemon.json，将 registry-mirrors 指向 docker.xuanyuan.me（示例使用 sudo tee 写入）：
2、重载配置并重启 Docker：
若已存在其他 registry-mirrors 条目，请合并为同一数组，勿重复整文件覆盖导致丢失配置。
方式二（临时）：直接指定拉取地址
无需改 daemon 时，可临时拉取测试镜像验证与 docker.xuanyuan.me 的连通性：
群晖（DSM 7.2）Docker 镜像配置
请按下图顺序在「注册表」或「镜像」相关设置中配置镜像源（含 docker.xuanyuan.me）；完整图文步骤见站内教程：
群晖 Docker 镜像详细教程
免费版与专业版对比
| 功能特性 | 轩辕镜像免费版 | 轩辕镜像专业版 |
|---|---|---|
| 网站域名 | docker.xuanyuan.medocker.xuanyuan.me | xuanyuan.cloudxuanyuan.cloud |
| 拉取域名 | docker.xuanyuan.me | docker.xuanyuan.run docker.xuanyuan.dev |
| 专属域名 | 不支持 | 支持 |
| 镜像获取 | 支持 | 支持 |
| 可用性 | 不承诺 | 保证可用 |
| 下载速度 | 不承诺 | 稳定 |
| 客服响应 | 不承诺 | 优先响应 |
| 高峰期优先级 | 不承诺 | 保障高优先级 |
| 请求频率限制 | 1,000 次/小时10,000 次/天（请求数）⚠️ 不可提升 | |
| 价格 | 免费 | 充值流量 |
💡 提示：轩辕镜像专业版提供企业级稳定保障；免费版为公共服务，不保证可用性。推荐使用轩辕镜像专业版。
支持的仓库对比
下列镜像源（registry）在免费版与专业版下的支持范围与 FAQ 文档完全一致；专业版多仓库需配合专属域名使用。
| 镜像源 | 轩辕镜像免费版 | 轩辕镜像专业版 |
|---|---|---|
docker.io(Docker 官方镜像仓库) | 支持 Docker 仓库 | 支持 Docker 仓库 |
gcr.io(谷歌容器镜像仓库) | 不支持 GCR 仓库 | 支持 GCR 仓库 |
ghcr.io(GitHub 容器镜像仓库) | 不支持 GitHub 仓库 | 支持 GitHub 仓库 |
registry.k8s.io(Kubernetes 镜像仓库) | 不支持 Kubernetes 仓库 | 支持 Kubernetes 仓库 |
nvcr.io(NVIDIA 容器镜像仓库) | 不支持 NVIDIA 仓库 | 支持 NVIDIA 仓库 |
quay.io(红帽 Quay 镜像仓库) | 不支持 Quay 仓库 | 支持 Quay 仓库 |
mcr.microsoft.com(微软容器镜像仓库) | 不支持 Microsoft 仓库 | 支持 Microsoft 仓库 |
docker.elastic.co(Elastic 容器镜像仓库) | 不支持 Elastic 仓库 | 支持 Elastic 仓库 |
如何使用这些镜像源？
免费版用户：
仅支持从 docker.io 拉取镜像。
专业版用户：
支持所有列出的镜像源，需使用专属域名访问不同仓库；详见 镜像访问教程。
💡 提示：更多示例与说明见 支持的镜像仓库（完整文档）。
免责声明
用户在使用本服务时，需遵守当地法律法规，任何因非法使用本服务而导致的法律责任，由用户自行承担，与本服务提供方无关。
请用户在使用本服务时，遵守法律法规，不得用于任何非法目的，否则后果自负。
使用者在使用本服务时，需自行承担风险，本服务提供方不对任何因使用本服务而导致的任何直接或间接损失承担责任。
使用者在使用本服务时，需自行承担风险，并同意不会因使用本服务而向服务提供方提出任何索赔要求。
不建议在生产环境或对安全敏感的场景中使用免费公共镜像。
如果您对镜像的安全性、稳定性及可追溯性有较高要求，建议使用我们提供的 专业版镜像加速服务。
使用本服务即视为同意本免责声明的所有条款。如果使用者不同意本免责声明的任何条款，请立即停止使用本服务。
轩辕镜像主站注册用户及付费服务的完整权利义务，另以站内 用户协议 等法律文本为准。
轩辕镜像致力于为科研与开发场景提供合规、可追溯的 Docker 镜像访问支持，请合理使用公共测试资源。