目录
推荐方案：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
方案对比与注意事项
| 工具 | 优势 | M1/M2 注意事项 |
|---|---|---|
| Colima | ✅ 原生支持 Apple Silicon<br/>✅ 自动配置 DNS 和挂载路径 | 如遇镜像兼容问题，运行命令添加 --platform linux/arm64 指定架构 |
| Minikube | ❌ 复杂且主要用于 Kubernetes | 需通过 minikube start --driver=docker --container-runtime=containerd 手动适配 |
常见陷阱
-
镜像架构不匹配问题
默认镜像可能为x86_64，需显式选择linux/arm64架构：docker pull --platform linux/arm64 nginx:alpine # 或直接运行时指定 docker run --platform linux/arm64 nginx:alpine -
挂载目录权限修复
若遇到文件挂载权限问题，通过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
