Docker Engine安装本身不支持指定镜像源，所谓“国内源”实为替换APT仓库地址以加速安装包下载；真正的镜像拉取加速需在安装后配置/etc/docker/daemon.json中的registry-mirrors。

Docker Engine 安装阶段本身**不直接支持指定镜像源**，因为安装的是 Docker 的二进制程序（`dockerd`、`docker-cli` 等），不是拉取镜像。所谓“安装时用国内源”，实际是指：**在添加 Docker APT 仓库时，把官方源地址替换成国内镜像站同步的仓库地址**，从而让 `apt install docker-ce` 这一步从国内服务器下载安装包，而不是从 `download.docker.com`。 真正影响镜像拉取速度的 `registry-mirrors` 配置，是安装完成后的**运行时配置**，和安装过程无关。 下面分两部分说清楚：

安装 Docker Engine 时用国内 APT 源（加速安装包下载）

Ubuntu 系统（如 24.04）默认通过 APT 安装 Docker，官方推荐方式是添加 `download.docker.com` 的仓库。但该域名在国内访问慢，所以改用中科大、阿里云等镜像站提供的同步仓库。 以中科大镜像为例（稳定、无需登录）：

执行以下命令，跳过官方源，直接使用中科大 apt 镜像安装：

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 更新系统并安装依赖：
  sudo apt update && sudo apt install -y ca-certificates curl gnupg
• 添加中科大 Docker GPG 密钥：
  curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
• 添加中科大 APT 源（适配 Ubuntu 24.04 Noble）：
  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu noble stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
• 更新源并安装：
  sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io

> ✅ 验证：`apt policy docker-ce` 应显示安装源为 `https://mirrors.ustc.edu.cn/...`，而非 `download.docker.com`

安装后配置 registry-mirrors（加速后续镜像拉取）

这才是大家常说的“Docker 国内镜像源”，它控制 `docker pull` 时从哪里下载镜像（比如 `nginx`、`redis`），不影响 Docker 自身安装。 操作很简单：

• 创建或编辑配置文件：
  sudo mkdir -p /etc/docker && sudo nano /etc/docker/daemon.json
• 写入至少一个可靠镜像源（推荐组合使用，失败自动降级）：
  { "registry-mirrors": [ "https://hub-mirror.c.163.com", "https://mirror.ccs.tencentyun.com", "https://docker.mirrors.ustc.edu.cn" ] }
• 重载并重启服务：
  sudo systemctl daemon-reload && sudo systemctl restart docker
• 验证是否生效：
  docker info | grep "Registry Mirrors" —— 应输出上面填的地址

常见误区提醒

• ❌ 不要混淆 APT 源（装 Docker 用）和 registry-mirror（拉镜像用）；两者完全独立
• ❌ `--registry-mirror` 参数只对单次 `docker pull` 有效，不能替代 daemon.json 全局配置
• ❌ 阿里云镜像加速器地址形如 https://xxxxx.mirror.aliyuncs.com，必须去 cr.console.aliyun.com 登录后获取，不能直接填通用域名
• ✅ 多个 registry-mirrors 是顺序尝试，建议把最稳的放前面（如网易、腾讯、中科大）