让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Podman Docker 镜像源配置教程
教程简介
适用于 CentOS / Ubuntu / Arch 等系统，支持通过配置专属镜像地址提升镜像拉取速度、可控性与可用性。
适用场景
适用于 Podman 配置指南 等场景。
1适用场景
- 你使用的是 Podman 替代 Docker
- 想加快从 docker.io, ghcr.io, gcr.io, k8s.gcr.io 拉取镜像的速度
- 你有自己的专属镜像地址，如：***.xuanyuan.run
2打开配置文件
编辑 Podman 的镜像仓库配置文件：
sudo nano /etc/containers/registries.conf
有些系统是 /etc/containers/registries.conf.d/ 目录内多个文件，也可以新增一个 custom.conf 文件。
3添加配置内容
在配置文件中添加以下内容：
unqualified-search-registries = ["docker.io"] [[registry]] prefix = "docker.io" insecure = true location = "registry-1.docker.io" [[registry.mirror]] location = "***.xuanyuan.run" [[registry]] prefix = "k8s.gcr.io" insecure = true location = "k8s.gcr.io" [[registry.mirror]] location = "***-k8s.xuanyuan.run" [[registry]] prefix = "registry.k8s.io" insecure = true location = "registry.k8s.io" [[registry.mirror]] location = "***-k8s.xuanyuan.run" [[registry]] prefix = "gcr.io" insecure = true location = "gcr.io" [[registry.mirror]] location = "***-gcr.xuanyuan.run" [[registry]] prefix = "ghcr.io" insecure = true location = "ghcr.io" [[registry.mirror]] location = "***-ghcr.xuanyuan.run"
说明：请将 ***.xuanyuan.run 替换为你的专属镜像地址。
4测试是否生效
运行以下命令测试是否走专属域名：
podman pull docker.io/library/alpine
然后查看是否访问了 ***.xuanyuan.run，可以在代理服务器或网络抓包工具中确认。
5常见问题
镜像拉取仍走官方源
可能原因：
- 配置文件路径错误或语法错误
- 配置文件中没有配置对应的仓库
- 专属域名没有流量
解决方法：
- 检查配置文件路径和 TOML 语法
- 检查具体是哪个仓库链接不上，配置到配置文件中
- 前往充值页面充值流量包
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"