從 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。*