安装docker后国内用户需更换镜像源以解决拉取慢或失败问题，操作包括验证环境、修改/etc/docker/daemon.json配置多个国内镜像地址、重载并重启服务，最后通过docker info和pull命令验证生效。
安装 Docker 后，国内用户最常遇到的问题是拉取镜像慢或失败，根本原因是默认连接的是国外的 Docker Hub。更换为国内镜像源是必须的一步，而且操作简单、效果立竿见影。
一、确认 Docker 已安装并运行正常
先验证基础环境是否就绪：
- 执行 docker --version 查看 Docker 版本
- 运行 docker run hello-world 测试能否拉取并运行基础镜像（首次会下载，需联网）
- 检查服务状态：sudo systemctl status docker，确保显示 active (running)
二、永久更换镜像源（推荐方式）
核心是修改 Docker 守护进程配置文件 /etc/docker/daemon.json，写入多个可用镜像地址。即使文件不存在，也可直接创建。
- 创建目录（如未存在）：sudo mkdir -p /etc/docker
- 用命令一键写入最新可用镜像源（2026年实测有效）：
sudo tee /etc/docker/daemon.json { "registry-mirrors": [
"https://docker.m.daocloud.io",
"https://docker.imgdb.de",
"https://docker.1ms.run",
"https://docker.hlmirror.com",
"https://func.ink"
] }
EOF - 重载配置并重启服务：
sudo systemctl daemon-reload && sudo systemctl restart docker
三、验证镜像源是否生效
执行以下命令查看当前生效的镜像源列表：
- sudo docker info | grep -A 1 "Registry Mirrors" —— 应输出你刚配置的多个地址
- 再试一次拉取：sudo docker pull nginx:alpine，明显比之前快，且无超时或 403 错误
四、不同系统的小差异提醒
Linux（Ubuntu/CentOS）：按上述 /etc/docker/daemon.json 方式操作即可。
Mac（Docker Desktop）：打开设置 → Docker Engine → 替换 JSON 内容 → 点击 Apply & Restart。
Windows（Docker Desktop）：同样在 Settings → Docker Engine 中编辑，保存后自动重启服务。
