Apple Silicon Mac用户应下载Docker官方ARM64版.dmg包或用Homebrew Cask安装，验证docker --version和docker run hello-world成功后，配置国内镜像加速器，并优先选用支持arm64的镜像以避免架构错误。
如果您使用的是搭载 Apple M1/M2/M3 芯片的 Mac，尝试安装 Docker 时遇到启动失败、架构不兼容或“exec format error”等错误，则很可能是下载了 Intel 版本安装包或未满足 ARM64 原生运行条件。以下是针对 Apple Silicon 芯片的多种可靠安装方法：
一、通过官方 .dmg 包安装（图形化推荐）
此方法直接使用 Docker 官方为 Apple Silicon 构建的原生 ARM64 应用，无需 Rosetta 2 转译，性能最优且兼容性最稳定。
1、点击屏幕左上角「苹果图标」→「关于本机」，确认芯片显示为Apple M1/M2/M3；同时确认 macOS 版本 ≥11.0 (Big Sur)。
2、打开 Docker 官网下载页：https://www.docker.com/products/docker-desktop/，页面将自动识别并显示「Download for Mac (Apple Silicon)」按钮，点击下载（文件名为 Docker.dmg，约 500MB）。
3、双击打开下载的 Docker.dmg，将左侧「Docker」图标拖拽至右侧「Applications」文件夹中完成安装。
4、前往「应用程序」文件夹，右键「Docker Desktop」→「打开」；首次运行时系统弹出安全提示，需在「系统设置 → 隐私与安全性 → 安全性」中点击「仍要打开」。
5、输入管理员密码授权内核扩展加载，勾选「使用推荐设置」，等待菜单栏出现稳定常亮的鲸鱼图标（非旋转或灰显状态）。
二、通过 Homebrew Cask 命令行安装（开发者首选）
该方式支持版本追踪、一键升级与脚本化部署，避免图形界面反复授权，适合持续集成环境或批量配置。
1、若未安装 Homebrew，先在终端执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、安装完成后，执行：brew install --cask --appdir=/Applications docker。
3、等待终端输出"docker was successfully installed!"提示；安装过程自动完成权限注册与 LaunchAgent 配置。
4、执行open -a Docker启动应用，或直接在 Spotlight 搜索「Docker Desktop」打开。
三、验证安装是否成功
仅图标显示不代表 Docker 引擎已就绪；必须通过 CLI 确认守护进程响应能力，否则后续所有容器操作均会失败。
BlessAI
Bless AI 提供五个独特的功能：每日问候、庆祝问候、祝福、祷告和名言的文本生成和图片生成。
下载
1、等待菜单栏鲸鱼图标变为稳定常亮状态（通常需 60–90 秒）。
2、打开终端，执行：docker --version，应返回类似 Docker version 24.0.7, build afdd... 的输出。
3、执行：docker run hello-world，终端须完整打印包含"Hello from Docker!"及多段说明文本的输出。
四、配置国内镜像加速器（中国大陆用户必做）
Docker 默认从境外 docker.io 拉取镜像，在无加速器状态下极易卡在 Pulling fs layer 或超时失败，严重影响开发效率。
1、点击菜单栏右上角鲸鱼图标 →「Settings」→ 左侧选择「Docker Engine」。
2、在右侧 JSON 编辑框中，插入或修改 "registry-mirrors" 字段，填入至少一个可用镜像地址，例如："https://hub-mirror.c.163.com" 或 "https://mirrors.aliyun.com/docker-ce"。
3、点击「Apply & Restart」，等待 Docker 服务重启完成，鲸鱼图标恢复常亮状态。
五、处理常见 ARM64 兼容性问题
部分旧版镜像未提供 linux/arm64 架构 manifest，导致拉取后运行报错 "no matching manifest for linux/arm64" 或 "exec format error"。
1、临时启用 Rosetta 2 兼容层（仅限调试）：在终端执行：softwareupdate --install-rosetta，随后重启 Docker Desktop。
2、强制拉取 x86_64 镜像并运行（不推荐长期使用）：执行 docker run --platform linux/amd64 hello-world。
3、优先选用已明确声明支持 arm64 的镜像，如官方 nginx:alpine、redis:alpine 等，或查看镜像详情页的「Supported platforms」字段。
