macOS 安装 Docker 完整教程:Docker Desktop、Homebrew 与 Colima 三种方式
在 Mac 上用 Docker,先要接受一个事实:Docker 引擎只能运行在 Linux 内核上,macOS 没有原生支持。所有 Mac 上的 Docker 方案本质都是「启动一个轻量 Linux 虚拟机,在虚拟机里跑 Docker 引擎,再把 docker 命令行透传到 Mac 终端」。理解这一点,后面很多现象就都解释得通了:为什么 Docker 占内存、为什么容器里看到的内核是 Linux、为什么文件挂载比 Linux 上慢。
本文给出三条安装路线:官方的 Docker Desktop(最省心,但对大企业收费)、Homebrew 安装 Docker Desktop(适合喜欢命令行的同学)、以及完全免费开源的 Colima(无图形界面,资源占用更低)。三条路线装完后的 docker 命令完全一致,按需求选一条即可,不要混装。
一、安装前确认:芯片架构与系统版本
Mac 分两种芯片:2020 年后的 Apple Silicon(M1/M2/M3/M4,架构 arm64)和之前的 Intel(架构 x86_64)。下载安装包必须与芯片对应,下错了要么装不上,要么靠转译跑得极慢。先在终端确认:
# 查看芯片架构:arm64 = Apple Silicon,x86_64 = Intel
uname -m
# 查看 macOS 版本(Docker Desktop 当前版本要求 macOS 13 及以上)
sw_vers
# 查看可用磁盘(Docker 镜像很吃空间,建议预留 30GB 以上)
df -h /
如果系统版本低于 Docker Desktop 的要求,又不方便升级系统,有两个选择:装旧版 Docker Desktop(官网保留历史版本下载),或直接用下文的 Colima 方案——Colima 对系统版本的要求宽松得多。
二、方式一:Docker Desktop 官网安装(推荐新手)
打开 Docker 官网下载页(docker.com/products/docker-desktop),页面会按芯片提供两个下载按钮:Mac with Apple chip 和 Mac with Intel chip,按第一步确认的架构下载对应的 .dmg 文件(约 600MB)。
下载完成后双击打开 dmg,把 Docker 图标拖进 Applications 文件夹,然后从启动台或应用程序里打开 Docker。首次启动会依次出现:服务条款确认、请求管理员密码(安装特权辅助进程,用于创建网络与挂载)、推荐设置选择。建议保持默认的推荐设置(使用 Rosetta、VirtioFS 等选项都在里面),点 Finish 后等待右上角鲸鱼图标停止闪烁——图标稳定不再动画,就表示引擎启动完成。
许可要单独说明:Docker Desktop 个人使用、教育、小型企业(少于 250 名员工且年收入低于 1000 万美元)免费;超过这个规模的企业使用需要付费订阅。公司配发的 Mac 上长期使用,先确认公司的订阅情况,避免合规问题——这也是很多公司转向 Colima 方案的原因。
三、方式二:Homebrew 安装 Docker Desktop
已经装了 Homebrew 的同学,一条命令就能装好 Docker Desktop,升级也统一由 brew 管理。注意装的是 cask(图形应用),不是 formula:
# 安装 Docker Desktop(cask)
brew install --cask docker
# 安装后首次仍需手动打开一次完成初始化
open /Applications/Docker.app
# 后续升级
brew upgrade --cask docker
顺手把命令行补全配上,docker 子命令和容器名都能 Tab 补全:
# zsh 补全(Docker Desktop 自带补全文件,软链到 zsh 补全目录)
ln -s /Applications/Docker.app/Contents/Resources/etc/docker.zsh-completion \
/usr/local/share/zsh/site-functions/_docker 2>/dev/null || \
ln -s /Applications/Docker.app/Contents/Resources/etc/docker.zsh-completion \
/opt/homebrew/share/zsh/site-functions/_docker
# 重新打开终端生效
docker --version
四、方式三:Colima(免费开源,无界面)
Colima 基于 Lima 虚拟机,完全开源免费,没有许可限制,资源占用也比 Docker Desktop 小一截,代价是没有图形界面、全部靠命令行管理。它的工作方式是:装 colima 本体 + docker 命令行客户端,colima start 拉起虚拟机后,docker 命令自动连到虚拟机里的引擎。
# 安装 colima 与 docker 客户端、compose 插件
brew install colima docker docker-compose
# 启动虚拟机(首次会下载镜像,耗时几分钟)
# 按机器配置给资源:下面是 4 核 8G 内存 60G 磁盘
colima start --cpu 4 --memory 8 --disk 60
# 查看状态
colima status
# 停止 / 删除虚拟机
colima stop
colima delete
docker-compose 装完后如果 docker compose 子命令找不到,是因为 brew 装的 compose 插件不在 Docker 的插件搜索路径里,把它软链过去:
mkdir -p ~/.docker/cli-plugins
ln -sfn $(brew --prefix)/opt/docker-compose/bin/docker-compose \
~/.docker/cli-plugins/docker-compose
docker compose version
Colima 的参数在首次 start 后会被记住,后续直接 colima start 即可;要改配置用 colima start --edit 修改 YAML,或删掉虚拟机重新 start。需要 Kubernetes 时还可以 colima start --kubernetes 一并拉起单节点集群。
五、验证安装
无论哪条路线,装完都跑一遍下面的验证:引擎版本、服务端信息、hello-world 容器三件套。hello-world 能跑通,说明拉镜像、建容器、挂网络整条链路都正常。
# 客户端与引擎版本
docker version
# 引擎信息(能看到 Server 段才说明引擎已连上)
docker info | head -20
# 官方验证容器
docker run --rm hello-world
# compose 版本
docker compose version
如果 docker version 只输出 Client 段、Server 段报错 Cannot connect to the Docker daemon,说明引擎还没起来:Docker Desktop 看鲸鱼图标状态,Colima 就 colima start 再等一分钟。
六、配置国内镜像加速
在国内直接从 Docker Hub 拉镜像经常超时或龟速,装好后第一件事就是配镜像加速。Docker Desktop 在 Settings → Docker Engine 里直接改 JSON 配置,加上 registry-mirrors 后点 Apply & Restart:
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB"
}
},
"experimental": false,
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://docker.1ms.run"
]
}
Colima 没有图形界面,改它的虚拟机配置:colima start --edit,在 provision 或 docker 配置段写入同样的 registry-mirrors;或者进虚拟机改 /etc/docker/daemon.json 后重启。配完统一用 docker info 验证 Mirrors 是否生效:
# 看 Registry Mirrors 一段是否出现配置的地址
docker info | grep -A3 "Registry Mirrors"
# 实测拉一个稍大的镜像感受速度
docker pull nginx:alpine
docker pull mysql:8.0
注意镜像站地址时效性很强,某个地址失效就换下一个;公司有自建镜像仓库或云厂商专属加速地址(阿里云、腾讯云控制台里能领)时优先用专属地址,最稳定。
七、Apple Silicon 跑 x86 镜像
M 系列芯片的 Mac 上,如果镜像只有 amd64 版本,docker run 时会警告 The requested image's platform does not match,或者直接报错 exec format error。解决办法是显式指定平台,用模拟方式跑 x86 镜像(性能有损耗,开发调试够用):
# 单个容器指定平台
docker run --platform linux/amd64 --rm -it ubuntu:22.04 bash
# compose 里给服务加 platform
# services:
# app:
# platform: linux/amd64
# image: some-legacy-image:latest
想让模拟更快,开启 Rosetta 转译:Docker Desktop 在 Settings → General 里勾选 Use Rosetta for x86_64/amd64 emulation;Colima 在 start 时加参数重建虚拟机:colima delete 后执行 colima start --arch aarch64 --vm-type=vz --vz-rosetta。Rosetta 比默认的 QEMU 模拟快数倍,老镜像跑起来基本无感。
反过来,自己构建镜像发布给团队时,建议直接构建多架构镜像一次到位:
# 同时构建 amd64 与 arm64 并推送
docker buildx build --platform linux/amd64,linux/arm64 \
-t yourname/yourimage:latest --push .
八、资源与常用设置
Docker 在 Mac 上跑在虚拟机里,资源上限直接决定容器性能。Docker Desktop 在 Settings → Resources 里调:CPU 建议留一半给宿主机,内存按工作集给(跑 MySQL + 应用一般 6~8GB 起步),磁盘镜像上限在 Images location 处查看和迁移。Colima 对应的是 start 时的 --cpu/--memory/--disk 参数,改完要 colima delete 重建才生效(数据盘里的镜像会丢,重建前先导出重要镜像)。
两个实用提醒:一是挂载宿主机目录时用 VirtioFS(Desktop 默认已开),比旧的 gRPC FUSE 快很多,代码目录频繁读写尤其明显;二是长期不用时及时 docker system prune 清理悬空镜像和停止的容器,Mac 磁盘寸土寸金,一个月不清攒出几十 GB 很常见。可以给自己留一条定期执行的清理命令:
# 看 Docker 占用了多少磁盘
docker system df
# 清理未使用的数据(镜像、停止的容器、网络、构建缓存)
docker system prune -f
# 连未被引用的镜像一并清(更狠,确认没有要留的镜像再用)
docker system prune -a -f
九、常见问题
Q:docker 命令找不到。Docker Desktop 装完要打开一次应用完成初始化,命令行才会被链到 /usr/local/bin;Colima 路线确认 brew install docker 已装客户端。
Q:拉镜像一直超时。先按第六节配镜像加速,再检查公司 VPN/代理:Docker Desktop 的代理在 Settings → Resources → Proxies 里单独配,它不自动跟随系统代理,这一点最容易踩。
Q:容器里时间不对。Mac 休眠唤醒后虚拟机时钟会漂移,重启 Docker Desktop 或 colima restart 即可恢复。
Q:端口被占用(port is already allocated)。多半是宿主机上已有服务占了同端口,lsof -i :端口号 查出来关掉,或给容器换一个宿主机端口映射。
Q:怎么彻底卸载。Docker Desktop:应用菜单里 Troubleshoot → Uninstall,或命令 brew uninstall --cask docker 后再清理残留目录 ~/Library/Containers/com.docker.docker、~/.docker;Colima:colima delete 后 brew uninstall colima docker docker-compose。卸载会删掉所有镜像与容器数据,先导出要保留的东西。
十、小结
Mac 装 Docker 先分清芯片再选路线:新手和怕麻烦的用 Docker Desktop(注意大企业许可),喜欢命令行的用 brew 装 Desktop,想完全免费、占用低的用 Colima。装完固定三步走:hello-world 验证链路、配国内镜像加速、按需要开 Rosetta 跑 x86 镜像。这三步做完,日常的 docker 与 compose 工作流就和 Linux 上没有区别了。







