容器与云原生 / 系统课时
在 macOS 上安装 Docker
在 macOS 上安装 Docker
本课完成 macOS 上的 Docker Desktop 安装,并验证主机芯片架构与容器镜像架构是否匹配。最终结果是 Docker 服务可用、测试容器能运行,并且你知道何时需要关注 arm64 与 amd64 的兼容问题。
学习目标
- 识别 Mac 使用 Apple 芯片还是 Intel 芯片
- 安装与芯片架构匹配的 Docker Desktop
- 验证 Docker 服务和容器架构
确认芯片架构
在终端执行:
uname -m预期输出。Apple 芯片 Mac 通常输出:
arm64Intel 芯片 Mac 通常输出:
x86_64也可以在“关于本机”中查看芯片或处理器信息。下载 Docker Desktop 时应选择与本机芯片匹配的安装包,避免安装错误架构的版本。
安装 Docker Desktop
从 Docker 官方页面下载 macOS 安装包。Apple 芯片选择 Apple silicon 版本,Intel 芯片选择 Intel 版本。
打开下载的 DMG 文件,将 Docker 拖入 Applications,然后从应用程序目录启动 Docker。首次启动可能要求确认权限或输入管理员凭据,按系统提示完成即可。
Docker Desktop 会在 macOS 的虚拟化环境中运行 Linux 虚机,再由其中的 Docker Engine 启动 Linux 容器。等待菜单栏中的 Docker 状态显示为可用后,再执行命令验证。
验证 Docker 服务
执行以下命令,只输出服务端版本,便于判断 CLI 是否已连接到 Docker Daemon。
docker version --format '{{.Server.Version}}'预期输出
<DOCKER_SERVER_VERSION>实际版本号取决于安装版本。如果命令返回 Daemon 连接错误,先启动 Docker Desktop 并等待初始化完成,而不是重新安装命令行工具。
验证容器架构
使用多架构的 Alpine 镜像启动一次性容器,并在容器中查看内核报告的机器架构:
docker run --rm alpine uname -m预期输出。Apple 芯片原生运行 ARM64 镜像时通常输出:
aarch64Intel 芯片运行 AMD64 镜像时通常输出:
x86_64首次执行会先拉取镜像。主机的 arm64 与 Alpine 容器中的 aarch64 表示同一类 64 位 ARM 架构,只是命名方式不同。
理解多架构镜像
许多常用镜像同时提供 linux/arm64 和 linux/amd64 版本。执行 docker pull 或 docker run 时,Docker 会优先选择与当前环境匹配的镜像变体。
如果某个镜像只提供 AMD64 版本,Apple 芯片 Mac 可能通过模拟方式运行,但速度和兼容性不一定与原生 ARM64 相同。此时应优先寻找多架构镜像,或明确指定平台后进行测试。
不要把镜像标签当成架构保证。同一个标签可以关联多个平台变体,真正部署前应确认目标服务器与镜像支持的平台一致。
典型失败处理
如果 macOS 阻止应用启动,应在系统设置的隐私与安全页面确认来源和权限,不要从不可信站点重新下载安装包。
如果命令提示找不到 docker,先确认 Docker Desktop 已完成启动,并重新打开终端,使命令行路径配置生效。
如果出现平台不匹配警告,检查镜像是否支持当前架构。模拟运行可以用于临时验证,但生产构建应尽量使用目标架构的原生镜像。