mac 上无法单独安装 docker engine，因其依赖 linux 内核特性，官方仅通过 docker desktop（含虚拟机与代理机制）提供完整集成方案；正确路径是下载对应芯片的 .dmg 安装、授权启动，并配置国内镜像加速器。

在 mac 上，docker engine 不单独安装——它已完整集成在 docker desktop for mac 中。官方不提供 macos 独立的 docker engine 二进制包（如 linux 那样），所有命令行工具（docker、dockerd、docker-compose）和后台服务均由 docker desktop 统一管理并自动部署。

为什么不能单独装 Docker Engine？

Mac 是基于 Darwin 内核的操作系统，不原生支持 Linux 容器运行时所需的命名空间、cgroups 等内核特性。Docker Desktop 实际通过轻量级虚拟机（HyperKit 或虚拟化框架）在 macOS 上模拟 Linux 运行环境，并在其中托管完整的 Docker Engine。因此：

• 你执行的 docker 命令，本质是通过 gRPC 代理到虚拟机内的 dockerd 进程；
• 没有“手动启动 dockerd”或“systemctl enable docker”这类操作；
• 试图绕过 Docker Desktop 直接运行引擎会失败，也不被支持。

正确安装方式：只装 Docker Desktop

这是唯一官方支持、稳定可用的路径，分三步完成：

Crawl4ai Docker Skill

Docker化网页爬虫服务，支持REST API，可进行网页爬取与抓取，智能内容提取（基于 L...）

下载

• 确认系统与芯片：macOS ≥ 12.0（Monterey），芯片为 Intel 或 Apple Silicon（M1/M2/M3）；
• 下载并安装应用：访问 Docker 官网下载页，自动识别芯片后下载对应 .dmg 文件，双击拖入 Applications；
• 首次启动授权：打开 Docker Desktop，输入管理员密码，允许加载内核扩展（如 com.docker.driver.amd64-linux 或 ARM 版本）。

验证 Engine 是否真正就绪

图标出现 ≠ Engine 启动成功。必须终端验证：

• 运行 docker --version → 看到版本号（如 Docker version 24.0.7）；
• 运行 docker info → 输出中包含 Server Version: 和 Kernel Version: 字段；
• 运行 docker run hello-world → 成功拉取镜像并打印 “Hello from Docker!”。

国内用户必配：加速器让 Engine 拉镜像不卡住

默认连 Docker Hub 极慢，常卡在 Pulling fs layer。需配置镜像加速器：

• 点击菜单栏鲸鱼图标 → Settings → Docker Engine；
• 在 JSON 编辑框中添加或修改 "registry-mirrors"，例如：

{"registry-mirrors": ["https://hub-mirror.c.163.com", "https://mirror.ccs.tencentyun.com"]}

• 点击 Apply & Restart，等待重启完成后再测试拉取镜像。