Docker

Mac

方法一：安装 Docker Desktop (官方推荐，最标准)

这是最通用的方法，包含图形界面 (GUI) 和所有命令行工具。

1. 下载安装包

1. 访问 Docker 官网下载页：Docker Desktop for Mac
2. 关键步骤：请务必点击 "Download for Mac - Apple Chip" 按钮（不要点 Intel Chip）。

2. 安装

1. 下载完成后，双击打开 .dmg 文件。
2. 将 Docker 图标拖入 Applications (应用程序) 文件夹。

3. 启动与配置

1. 在“应用程序”中找到 Docker 并打开。
2. 系统会提示“Docker.app 是从互联网下载的...”，点击 打开。
3. 授权：Docker 需要特权访问网络组件，会提示输入 Mac 的开机密码，输入并确认。
4. 服务协议：阅读并同意服务条款。

4. 验证安装

打开终端 (Terminal)，输入以下命令：

# 查看版本
docker --version

# 运行一个测试容器
docker run hello-world

如果看到 "Hello from Docker!" 的字样，说明安装成功。

---

方法二：使用 Homebrew 安装 (命令行党推荐)

如果你安装了 Homebrew，可以用一条命令搞定：

brew install --cask docker

注意：Homebrew 会自动检测你的 M1 架构并下载对应的版本。

---

M1 用户必须知道的 3 个关键点

由于 M1 是 ARM64 架构，而很多老旧的 Docker 镜像还是 x86_64 (Intel/AMD) 架构，你需要注意以下几点：

1. 确保安装了 Rosetta 2

虽然 Docker Desktop for Apple Silicon 是原生运行的，但在 M1 上运行 x86 架构的容器（例如某些没有 ARM 版本的旧数据库）需要 Rosetta 2 转译。
在终端运行以下命令确保已安装：

softwareupdate --install-rosetta

2. 镜像兼容性与 --platform 参数

大部分主流镜像（如 Nginx, Python, Node, MySQL 8.0+）都已经支持 ARM64。Docker 会自动拉取 ARM 版本，速度极快。

但如果你必须使用一个没有 ARM 版本的镜像（报错 exec user process caused: exec format error），你需要强制使用 amd64 架构运行：

# 强制使用 x86 架构运行容器
docker run --platform linux/amd64 [镜像名]

注意：强制转译运行会比原生慢，且可能不稳定，尽量寻找支持 ARM64 的镜像。

3. 内存占用问题

Docker Desktop 在 Mac 上底层其实是跑了一个 Linux 虚拟机。在 M1 上，它有时会占用较多内存。如果你觉得 Docker Desktop 太卡，可以尝试下面的轻量级替代方案。

---

替代方案：OrbStack (强烈推荐给 M1 开发者的神器)

如果你觉得 Docker Desktop 启动慢、耗电、且占用大量内存，强烈建议尝试 OrbStack。

• 特点：专为 macOS 设计，启动只需 2 秒，内存占用极低，且完全兼容 Docker 命令（它是 Drop-in replacement，安装后直接用 docker 命令，不用改习惯）。
• 安装方法：

1. 官网下载：orbstack.dev
2. 或者用 Homebrew：

brew install --cask orbstack

• 切换：安装 OrbStack 后打开，它会提示你接管 Docker 命令，确认即可。以后你就不用开 Docker Desktop 了。