Docker Desktop 无法连接到 Docker 官方镜像仓库docker.io导致拉取 ros 镜像时超时失败核心原因是网络访问不通畅。下面我会帮你一步步解决这个问题。一、核心解决方案配置 Docker 镜像加速器国内访问 Docker 官方仓库速度极慢甚至超时最有效的办法是配置国内镜像源加速器比如阿里云、网易云、腾讯云等。以下是针对 Docker Desktop 的详细配置步骤步骤 1打开 Docker Desktop 配置界面确保 Docker Desktop 处于运行状态右下角托盘能看到 Docker 图标。右键点击 Docker 图标 → 选择Settings设置。在左侧菜单中找到Docker EngineDocker 引擎选项。步骤 2添加镜像加速器配置在右侧的 JSON 配置框中找到registry-mirrors: []这一行如果没有就手动添加将国内加速器地址填入数组中。推荐使用阿里云加速器每个人的地址不同也可先用通用地址修改后的完整配置示例保留原有其他配置只新增 / 修改 registry-mirrorsjson{ 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点击配置界面右下角的Apply Restart应用并重启。等待 Docker Desktop 重启完成约 1-2 分钟。二、重新拉取 ROS 2 镜像重启完成后打开新的 PowerShell/CMD 终端重新执行拉取命令bash运行docker pull osrf/ros:humble-desktop-full此时 Docker 会通过国内镜像源拉取镜像速度会大幅提升不会再出现超时问题。三、备选方案手动下载镜像若加速器仍失效如果配置加速器后仍有问题可通过以下方式手动导入镜像访问第三方镜像站如 https://hub.daocloud.io/搜索osrf/ros找到humble-desktop-full标签。下载镜像包.tar 格式到本地。通过 Docker 导入镜像bash运行docker load -i 下载的镜像包.tar四、验证是否配置成功执行以下命令查看镜像加速器是否生效bash运行docker info在输出结果中找到Registry Mirrors字段若能看到你配置的国内镜像地址说明配置成功。总结核心问题Docker 访问官方仓库超时本质是网络问题而非命令或镜像本身的问题。关键解决步骤在 Docker Desktop 的 Docker Engine 中配置国内镜像加速器重启后重新拉取。验证要点通过docker info确认加速器生效再执行docker pull命令。