macos上用homebrew安装docker本质是安装docker desktop(含图形界面与docker、docker-compose等命令行工具),需先装homebrew,再执行brew install --cask --appdir=/applications docker,验证docker --version及镜像加速配置。
macos 上用 homebrew 安装 docker,本质是安装 docker desktop(含完整图形界面 + 命令行工具),不是纯 cli 工具。docker desktop 自带 docker、docker-compose、docker buildx 等命令,全部可直接在终端调用,无需额外安装独立的“命令行管理工具”。
确认系统前提
确保你的 Mac 满足基本要求:
- macOS 12.6(Monterey)或更高版本(Apple Silicon 或 Intel 芯片均支持)
- 至少 4 GB 内存,推荐 8 GB 以上
- 启用虚拟化支持(默认开启,无需手动操作)
- 已安装 Xcode Command Line Tools(终端执行
xcode-select --install可快速安装)
安装 Homebrew(如未安装)
打开终端,粘贴并运行官方安装命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按提示完成安装后,执行 brew --version 验证是否成功。若报错权限问题,可能需先运行 sudo chown -R $(whoami) /usr/local/bin(仅限旧版 macOS 且必要时)。
用 Homebrew 安装 Docker Desktop
Homebrew Cask 已原生支持 Docker Desktop,一条命令即可完成安装:
brew install --cask --appdir=/Applications docker
该命令会自动下载最新稳定版(截至 2026 年 7 月为 v4.35+),解压并移入 /Applications,同时软链接 docker、docker-compose 等二进制文件到 /usr/local/bin,使命令全局可用。
安装完成后终端会显示 ? docker was successfully installed!。
启动并验证命令行可用性
首次使用需启动图形应用:
- 前往
/Applications,双击Docker Desktop - 输入管理员密码授权内核扩展(仅首次)
- 等待右上角出现鲸鱼图标,状态变为绿色即代表后台服务就绪
然后打开新终端窗口,运行以下命令验证:
docker --version # 输出类似:Docker version 24.0.7, build 11f1a56
docker info | head -n 5 # 查看基础运行状态(应无 permission denied 错误)
若提示 Cannot connect to the Docker daemon,说明 Docker Desktop 还未完全启动,稍等几秒再试,或点击菜单栏鲸鱼图标 → Restart。
配置镜像加速(国内用户必备)
默认拉取镜像极慢,建议配置国内镜像源(如网易、阿里云):
- 点击菜单栏鲸鱼图标 → Settings → Daemon → Registry mirrors
- 添加一行:
https://hub-mirror.c.163.com(网易)或https://registry.cn-hangzhou.aliyuncs.com(阿里云) - 点击 Apply & Restart
重启后执行 docker info,检查输出中是否有 Registry Mirrors: 及你填写的地址,确认生效。
可选:启用 BuildKit 加速构建
提升 docker build 性能,推荐开启:
export DOCKER_BUILDKIT=1 # 永久生效可加到 ~/.zshrc: echo 'export DOCKER_BUILDKIT=1' >> ~/.zshrc source ~/.zshrc
之后所有构建将默认使用现代构建引擎,支持并发、缓存优化和更清晰的进度提示。











