宝塔面板 Docker 镜像加速教程

一、准备工作

1.  安装 Docker 管理器：

   登录宝塔面板，进入「软件商店」，搜索并安装 Docker 管理器 插件。

2.  获取轩辕镜像加速地址：

•  免费版加速地址：docker.xuanyuan.me

•  专业版加速地址：xuanyuan.cloud

（具体镜像加速链接需要打开链接获取）

二、配置步骤

步骤 1：生成镜像地址

复制获取到的 免费版（docker.xuanyuan.me）或 专业版（xuanyuan.cloud）加速地址，备用。

步骤 2：进入 Docker 加速配置界面

1.  登录宝塔面板，左侧菜单点击 Docker 进入管理器；

2.  切换到顶部 设置 标签页，找到 加速 URL 配置项（如图示）：

宝塔Docker加速配置界面

步骤 3：填写并保存加速地址

1.  在 加速 URL 输入框中，粘贴复制的轩辕镜像地址；

2.  点击输入框右侧的 修改 按钮，完成配置保存。

步骤 4：验证配置（可选）

保存后，可通过以下方式验证：

•  拉取测试镜像：在 Docker 管理器的「线上镜像」中搜索 hello-world 并拉取，观察下载速度；

•  检查 Docker 服务：确认「Docker 服务」状态为开启，无报错提示。

三、日常使用方法

配置完成后，宝塔 Docker 管理器会自动通过轩辕镜像加速拉取镜像：

1.  进入 Docker 管理器，点击 线上镜像；

2.  输入镜像名称（如 nginx、mysql）和标签（如 latest）；

3.  点击「拉取」，系统自动通过加速地址获取镜像，下载速度会显著提升。

四、注意事项

1.  免登录特性：轩辕镜像的免登录地址无需填写用户名 / 密码，直接配置即可；

2.  专业版优势：若使用 xuanyuan.cloud（专业版），可享受更稳定的带宽和优先级调度；

3.  故障排查：若拉取速度异常，可重新检查「加速 URL」是否正确，或尝试重启 Docker 服务（在「设置」页点击「重启」）。

通过以上步骤，即可快速为宝塔面板的 Docker 环境配置镜像加速，大幅提升镜像拉取效率。