macOS 上为 Colima 配置 Docker 国内镜像源

背景

在国内使用 Docker 时，由于网络原因，从 Docker Hub 拉取镜像往往速度很慢甚至失败。通过配置国内镜像源，可以大幅提升镜像下载速度，改善开发体验。本文将介绍如何在 macOS 系统上为 Colima（一个轻量级的 Docker 运行环境）配置国内镜像源。

什么是 Colima

Colima 是一个在 macOS 和 Linux 上运行容器的轻量级工具，它使用 Lima（Linux virtual machines）来提供容器运行时环境。相比 Docker Desktop，Colima 更加轻量、开源且免费。

配置步骤

1. 确认 Colima 状态

首先，检查 Colima 是否正在运行：

colima status

你应该能看到类似以下的输出：

INFO[0000] colima is running using macOS Virtualization.Framework
INFO[0000] arch: aarch64
INFO[0000] runtime: docker
INFO[0000] mountType: virtiofs

2. 定位配置文件

Colima 的配置文件位于：

~/.colima/default/colima.yaml

这个文件包含了虚拟机的所有配置，包括 CPU、内存、磁盘以及 Docker daemon 的配置。

3. 修改配置文件

打开配置文件，找到 docker: 配置项（大约在第 135 行）：

Colima default behaviour: buildkit enabled
Default: {}
docker: {}

将其修改为：

Colima default behaviour: buildkit enabled
Default: {}
docker:
  registry-mirrors:
    - https://docker.m.daocloud.io
    - https://docker.1panel.live
    - https://hub.rat.dev

这里配置了三个国内镜像源：

DaoCloud 镜像源：由 DaoCloud 提供的公共镜像加速服务
1Panel 镜像源：开源面板 1Panel 提供的镜像加速
Rat.dev 镜像源：社区维护的镜像加速服务

4. 重启 Colima

配置修改后，需要重启 Colima 使配置生效：

colima restart

重启过程大约需要 10-20 秒，你会看到 Colima 停止并重新启动的日志输出。

5. 验证配置

重启完成后，验证镜像源配置是否生效：

docker info | grep -A 10 "Registry Mirrors"

如果配置成功，你应该能看到：

 Registry Mirrors:
  https://docker.m.daocloud.io/
  https://docker.1panel.live/
  https://hub.rat.dev/

6. 测试镜像拉取

现在可以测试一下镜像拉取速度：

docker pull nginx

你会发现镜像下载速度明显提升。

配置说明

registry-mirrors 工作原理

当你执行 docker pull 命令时，Docker 会按照配置的镜像源顺序依次尝试：

首先尝试从第一个镜像源（docker.m.daocloud.io）拉取
如果第一个失败，尝试第二个镜像源（docker.1panel.live）
如果都失败，最后从官方 Docker Hub 拉取

这种机制确保了即使某个镜像源不可用，也能从其他源或官方源获取镜像。

其他可用的国内镜像源

除了上述三个镜像源，还有一些其他可选的国内镜像源：

docker:
  registry-mirrors:
    - https://docker.m.daocloud.io
    - https://docker.1panel.live
    - https://hub.rat.dev
    - https://dockerproxy.com
    - https://docker.nju.edu.cn

注意：镜像源的可用性可能会随时间变化，建议配置多个镜像源作为备份。

常见问题

Q: 配置后仍然很慢怎么办？

A: 可以尝试以下方法：

更换其他镜像源
检查网络连接
使用 docker pull 时添加 --platform 参数指定架构

Q: 如何恢复默认配置？

A: 将 docker: 配置项改回 docker: {}，然后重启 Colima：

colima restart

Q: 配置对已有镜像有影响吗？

A: 不会。镜像源配置只影响新拉取的镜像，已经下载的镜像不受影响。

Q: 如何查看当前使用的镜像源？

A: 使用以下命令：

docker info | grep -A 10 "Registry Mirrors"

总结

通过配置国内镜像源，可以显著提升 Docker 镜像的下载速度，改善开发体验。Colima 作为 Docker Desktop 的轻量级替代方案，配置简单且资源占用少，非常适合 macOS 用户使用。配置完成后，你就可以愉快地使用 Docker 了，不用再为镜像下载速度慢而烦恼。

参考资料

[Colima 官方文档](https://github.com/abiosoft/colima)
[Docker 官方文档 - daemon.json](https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file)
[DaoCloud 镜像加速](https://www.daocloud.io/mirror)

---

*最后更新时间：2025-12-10*