在mac中安装Colima使用docker（替代Docker Desktop）

目录

推荐方案：Colima + Docker CLI（原生 ARM 支持）

步骤 1: 安装必需工具

步骤 2: 启动 Colima (优化 ARM 虚拟机)

步骤 3: 绑定 Docker CLI 到 Colima

步骤 4: 验证 Docker 运行

方案对比与注意事项

常见陷阱

卸载残留配置（可选）

推荐方案：Colima + Docker CLI（原生 ARM 支持）

步骤 1: 安装必需工具

# 安装 Homebrew（若尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Colima 和 Docker CLI（原生支持 Apple Silicon）
brew install colima docker docker-compose

步骤 2: 启动 Colima (优化 ARM 虚拟机)

# 为 Apple Silicon 启动轻量级 ARM 虚拟机（默认使用 containerd 运行时）
colima start --arch aarch64 --runtime containerd \
  --cpu 4 --memory 8 --disk 20 # 根据需求调整 CPU/内存/磁盘

• --arch aarch64: 明确指定 ARM 架构，适配 Apple Silicon。
• -runtime containerd: 使用更轻量的 containerd（或手动替换为 docker 运行时）。

步骤 3: 绑定 Docker CLI 到 Colima

docker context use colima

步骤 4: 验证 Docker 运行

# 运行 ARM 架构的测试容器（自动拉取适配镜像）
docker run --rm --platform linux/arm64 hello-world

• --platform linux/arm64: 强制使用 ARM 架构容器（避免 x86 镜像兼容问题）。

后续每次启动docker之前，需要先启动Colima

启动Colima命令

Colima start

停止Colima命令

stop Colima

方案对比与注意事项

常见陷阱

1. 镜像架构不匹配问题
   默认镜像可能为 x86_64，需显式选择 linux/arm64 架构：

   docker pull --platform linux/arm64 nginx:alpine
   # 或直接运行时指定
   docker run --platform linux/arm64 nginx:alpine
   

2. 挂载目录权限修复
   若遇到文件挂载权限问题，通过 colima 调整挂载的 UID/GID：

   colima stop
   colima start --mount-type=9p --mount-ownership [$UID]:$(id -g)
   

卸载残留配置（可选）

colima delete -f        # 删除 Colima 虚拟机
docker context rm colima # 删除 Docker 上下文
brew uninstall colima   # 卸载 Colima