从 Colima 迁移到 Docker Desktop 完整指南

前言

在 macOS 上运行 Docker 容器有多种选择，Colima 是一个轻量级的开源替代方案，而 Docker Desktop 则是官方提供的完整解决方案。本文将详细介绍如何从 Colima 平滑迁移到 Docker Desktop。

为什么选择 Docker Desktop？

虽然 Colima 轻量且开源，但 Docker Desktop 提供了更完善的功能：

图形化界面，易于管理容器和镜像
更好的系统集成和稳定性
官方支持和及时更新
内置 Kubernetes 支持
更完善的网络和存储管理

迁移步骤

第一步：卸载 Colima

首先需要停止并删除 Colima 虚拟机：

停止 Colima 服务
colima stop
删除 Colima VM 和所有设置
colima delete

当系统提示确认删除时，输入 y 确认。你会看到类似以下的输出：

time="2025-12-10T19:26:18+08:00" level=info msg="deleting colima"
time="2025-12-10T19:26:18+08:00" level=info msg=done

接下来卸载 Colima 应用程序：

使用 Homebrew 卸载 Colima
brew uninstall colima

这个命令会同时卸载 Colima 及其依赖的 Lima：

Uninstalling /opt/homebrew/Cellar/colima/0.9.1... (11 files, 6.2MB)
Autoremoving 1 unneeded formula:
lima
Uninstalling /opt/homebrew/Cellar/lima/2.0.2... (116 files, 77.5MB)

第二步：安装 Docker Desktop

#### 方法一：使用 Homebrew（推荐）如果网络条件良好，可以直接使用 Homebrew 安装：

brew install --cask docker

#### 方法二：从阿里云镜像下载（国内用户推荐）

如果从 Docker 官方服务器下载速度慢或超时，可以使用阿里云镜像：

下载 Docker Desktop（适用于 Apple Silicon）
curl -L -o ~/Downloads/Docker.dmg \
  "https://mirrors.aliyun.com/docker-toolbox/mac/docker-for-mac/stable/arm64/Docker.dmg"

下载完成后，你会看到类似的输出：

100  558M  100  558M    0     0  27.8M      0  0:00:20  0:00:20 --:--:-- 28.6M

注意：如果你使用的是 Intel 芯片的 Mac，请将 URL 中的 arm64 改为 amd64。

#### 安装 Docker Desktop

如果是从镜像下载的 DMG 文件，执行以下命令安装：

挂载 DMG 文件
hdiutil attach ~/Downloads/Docker.dmg
复制到 Applications 文件夹
cp -R /Volumes/Docker/Docker.app /Applications/
卸载 DMG 镜像
hdiutil detach /Volumes/Docker

第三步：启动并验证

启动 Docker Desktop：

open /Applications/Docker.app

等待几秒钟让 Docker 完全启动，然后验证安装：

检查 Docker 版本
docker --version
输出：Docker version 29.1.2, build 890dcca877
检查 Docker 守护进程状态
docker info

如果看到类似以下输出，说明安装成功：

Client: Docker Engine - Community
 Version:    29.1.2
 Context:    default
 Debug Mode: false

配置建议

1. 设置镜像加速（国内用户）

打开 Docker Desktop，进入 Settings → Docker Engine，添加以下配置：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}

2. 资源限制

在 Settings → Resources 中可以调整：

CPU 核心数
内存大小
磁盘空间
Swap 大小

建议根据你的实际需求和机器配置进行调整。

3. 开机自启动

在 Settings → General 中，可以勾选 "Start Docker Desktop when you log in" 选项。

常见问题

Q: 迁移后原有的容器和镜像怎么办？

A: Colima 和 Docker Desktop 使用不同的存储位置，原有的容器和镜像不会自动迁移。你需要：

在卸载 Colima 前，使用 docker save 导出需要保留的镜像
在 Docker Desktop 中使用 docker load 导入镜像
重新创建容器

Q: Docker Desktop 占用资源太多怎么办？

A: 可以在 Settings → Resources 中降低分配的 CPU 和内存。对于日常开发，2-4 核 CPU 和 4-8GB 内存通常足够。

Q: 如何完全卸载 Docker Desktop？

A: 运行以下命令：

使用 Homebrew 卸载
brew uninstall --cask docker
或手动删除
rm -rf /Applications/Docker.app
rm -rf ~/Library/Group\ Containers/group.com.docker
rm -rf ~/Library/Containers/com.docker.docker

总结

从 Colima 迁移到 Docker Desktop 的过程非常简单：

停止并卸载 Colima
下载并安装 Docker Desktop（推荐使用国内镜像）
启动并验证安装

整个过程大约需要 5-10 分钟（取决于网络速度）。迁移后，你将获得更好的用户体验和更完善的功能支持。

参考资源

[Docker Desktop 官方文档](https://docs.docker.com/desktop/mac/install/)
[阿里云 Docker 镜像](https://mirrors.aliyun.com/docker-toolbox/mac/docker-for-mac/)
[Docker 镜像加速器配置](https://yeasy.gitbook.io/docker_practice/install/mirror)

---

*本文基于 macOS 14.3 (Apple Silicon) 和 Docker Desktop 29.1.2 编写，最后更新于 2025-12-10。*