# Docker 拉取超时 / 配置镜像加速

国内环境从 Docker Hub 拉取镜像常超时，需在 Docker 中配置镜像加速。

## Docker Desktop（macOS / Windows）

1. 打开 **Docker Desktop**
2. **Settings** → **Docker Engine**
3. 在 JSON 中增加 `registry-mirrors`（若已有其他配置，只需合并进该字段）：

```json
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run"
  ]
}
```

4. 点击 **Apply & Restart**
5. 重新执行：`docker compose up -d --build`

## 备选镜像源

可替换或补充到 `registry-mirrors` 中：

- `https://docker.m.daocloud.io`（DaoCloud）
- `https://docker.1ms.run`
- `https://docker.rainbond.cc`（好雨科技）
- 阿里云 / 腾讯云等：在对应云控制台的「容器镜像服务」中获取个人专属加速地址
