Docker 镜像源切换指南 —— 小白也能轻松上手！

## 🤔 为什么要切换 Docker 源？

打个比方：Docker 默认的镜像源在国外，就像你从国外网购东西，**又慢又容易丢包**。切换到国内镜像源，就像换成了国内快递，**速度嗖嗖的！**

常见症状：
- `docker pull` 卡在 `Pulling fs layer` 不动
- 下载速度只有几 KB/s
- 经常超时报错：`timeout`

---

## 📋 切换前的准备工作

### 确认 Docker 已安装

打开终端（Terminal / CMD），输入：

```bash
docker --version
```

如果看到类似 `Docker version 24.0.7` 的输出，说明已安装 ✅

> ⚠️ 如果提示 `command not found`，请先安装 Docker。

---

## 🚀 开始切换镜像源

### 方式一：通过修改配置文件（推荐）

#### 📌 Linux 系统

**第一步：** 创建或编辑 Docker 配置文件

```bash
sudo mkdir -p /etc/docker
sudo nano /etc/docker/daemon.json
```

**第二步：** 写入以下内容

```json
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}
```

> 💡 **小白解释：** 这个配置就像告诉 Docker："以后下载东西，优先去这几个国内快递站拿！"

**第三步：** 保存并退出

按 `Ctrl + O` 保存，`Enter` 确认，`Ctrl + X` 退出。

**第四步：** 重启 Docker 让配置生效

```bash
sudo systemctl daemon-reload
sudo systemctl restart docker
```

---

#### 📌 Windows / Mac 系统（Docker Desktop）

**第一步：** 打开 Docker Desktop

点击桌面右下角（Windows）或顶部菜单栏（Mac）的 Docker 鲸鱼图标 🐳

**第二步：** 进入设置

点击 **Settings**（齿轮图标 ⚙️）→ **Docker Engine**

**第三步：** 修改 JSON 配置

在配置框中添加 `registry-mirrors` 字段：

```json
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://docker.mirrors.ustc.edu.cn",
    "hub-mirror.c.163.com"
  ],
  "experimental": false,
  "builder": {
    "gc": {
      "enabled": true
    }
  }
}
```

**第四步：** 点击 **Apply & Restart**

等待 Docker 重启完成即可 ✅

---

### 方式二：命令行临时指定（快速体验）

如果只想临时用一下，不想改配置：

```bash
# 以拉取 nginx 为例，直接指定镜像源
docker pull docker.m.daocloud.io/library/nginx:latest
```

> 💡 这种方式不需要改配置，但每次都要手动写完整地址，适合临时尝鲜。

---

## ✅ 验证是否切换成功

### 方法一：查看 Docker 信息

```bash
docker info
```

找到 `Registry Mirrors` 部分，如果显示了你配置的地址，说明配置成功：

```
Registry Mirrors:
  https://docker.m.daocloud.io/
  https://dockerproxy.com/
  ...
```

### 方法二：实际拉取一个镜像试试

```bash
time docker pull hello-world
```

如果几秒内就下载完成，恭喜你，切换成功！🎉

---

## 📊 常用国内镜像源一览

| 镜像源 | 地址 | 说明 |
|--------|------|------|
| DaoCloud | `https://docker.m.daocloud.io` | 稳定可靠，推荐 |
| DockerProxy | `https://dockerproxy.com` | 速度快 |
| 中科大 | `https://docker.mirrors.ustc.edu.cn` | 高校镜像 |
| 网易 | `https://hub-mirror.c.163.com` | 网易提供 |
| 腾讯 | `https://mirror.ccs.tencentyun.com` | 腾讯云内网使用 |

> ⚠️ **注意：** 镜像源可能随时间变化而失效，建议配置多个作为备选。

---

## 🛠️ 常见问题排查

### Q1：重启 Docker 后报错怎么办？

```bash
# 检查配置文件格式是否正确
cat /etc/docker/daemon.json

# 查看 Docker 服务状态和错误日志
sudo systemctl status docker
sudo journalctl -u docker --no-pager | tail -20
```

> 常见原因：JSON 格式错误（少了逗号、引号不匹配等）

---

### Q2：配置了镜像源还是很慢？

可能原因和解决方案：

```bash
# 1. 检查 DNS 设置
nslookup docker.m.daocloud.io

# 2. 尝试换一个镜像源
# 3. 检查网络连接
ping docker.m.daocloud.io
```

---

### Q3：拉取镜像报错 `not found`？

某些镜像源可能不全，换个源试试：

```bash
# 比如拉取某个镜像失败
docker pull dockerproxy.com/library/镜像名:标签
```

---

### Q4：如何恢复默认配置？

**Linux：**
```bash
# 删除或清空配置文件中的 registry-mirrors
sudo nano /etc/docker/daemon.json
# 删除 registry-mirrors 字段后保存

sudo systemctl daemon-reload
sudo systemctl restart docker
```

**Windows/Mac：**
在 Docker Desktop 设置中删除 `registry-mirrors` 字段，Apply & Restart。

---

## 🎯 总结：一张图记住全部流程

```
切换 Docker 源三步走：

  ┌─────────────────────────────────┐
  │  Step 1: 编辑 daemon.json       │
  │  添加 registry-mirrors 配置      │
  └──────────────┬──────────────────┘
                 │
  ┌──────────────▼──────────────────┐
  │  Step 2: 重启 Docker 服务        │
  │  systemctl restart docker       │
  └──────────────┬──────────────────┘
                 │
  ┌──────────────▼──────────────────┐
  │  Step 3: 验证 docker info       │
  │  看到 Registry Mirrors 即成功    │
  └─────────────────────────────────┘
```

---

## 💬 留言互动

> 如果这篇博客帮到了你，欢迎点赞收藏！有任何问题欢迎在评论区留言，我会一一解答 😊