docker 入门

Docker Desktop 无法连接到 Docker 官方镜像仓库（docker.io），导致拉取 ros 镜像时超时失败，核心原因是网络访问不通畅。下面我会帮你一步步解决这个问题。

一、核心解决方案：配置 Docker 镜像加速器

国内访问 Docker 官方仓库速度极慢甚至超时，最有效的办法是配置国内镜像源（加速器），比如阿里云、网易云、腾讯云等。以下是针对 Docker Desktop 的详细配置步骤：

步骤 1：打开 Docker Desktop 配置界面

1. 确保 Docker Desktop 处于运行状态（右下角托盘能看到 Docker 图标）。
2. 右键点击 Docker 图标 → 选择 Settings（设置）。
3. 在左侧菜单中找到 Docker Engine（Docker 引擎）选项。

步骤 2：添加镜像加速器配置

在右侧的 JSON 配置框中，找到 "registry-mirrors": [] 这一行（如果没有就手动添加），将国内加速器地址填入数组中。推荐使用阿里云加速器（每个人的地址不同，也可先用通用地址）：

修改后的完整配置示例（保留原有其他配置，只新增 / 修改 registry-mirrors）：

json

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://mirror.baidubce.com",        // 百度云加速器（通用）
    "https://docker.mirrors.ustc.edu.cn", // 中科大加速器（通用）
    "https://hub-mirror.c.163.com"        // 网易云加速器（通用）
  ]
}

步骤 3：应用配置并重启 Docker

1. 点击配置界面右下角的 Apply & Restart（应用并重启）。
2. 等待 Docker Desktop 重启完成（约 1-2 分钟）。

二、重新拉取 ROS 2 镜像

重启完成后，打开新的 PowerShell/CMD 终端，重新执行拉取命令：

bash

运行

docker pull osrf/ros:humble-desktop-full

此时 Docker 会通过国内镜像源拉取镜像，速度会大幅提升，不会再出现超时问题。

三、备选方案：手动下载镜像（若加速器仍失效）

如果配置加速器后仍有问题，可通过以下方式手动导入镜像：

1. 访问第三方镜像站（如 https://hub.daocloud.io/），搜索 osrf/ros，找到 humble-desktop-full 标签。
2. 下载镜像包（.tar 格式）到本地。
3. 通过 Docker 导入镜像：

   bash

   运行

   docker load -i 下载的镜像包.tar
   

四、验证是否配置成功

执行以下命令，查看镜像加速器是否生效：

bash

运行

docker info

在输出结果中找到 Registry Mirrors 字段，若能看到你配置的国内镜像地址，说明配置成功。

总结

1. 核心问题：Docker 访问官方仓库超时，本质是网络问题，而非命令或镜像本身的问题。
2. 关键解决步骤：在 Docker Desktop 的 Docker Engine 中配置国内镜像加速器，重启后重新拉取。
3. 验证要点：通过 docker info 确认加速器生效，再执行 docker pull 命令。