前言:前面我们已经吃透了Linux系统(CentOS/Ubuntu)Docker的安装流程,现在聚焦Mac系统——作为开发者常用的桌面系统,Mac的Docker安装和Linux有本质区别(依赖虚拟化技术),且需要区分Intel和Apple Silicon(M1/M2/M3)芯片,新手稍不注意就会下载错误版本导致安装失败。

本文全程新手友好,分芯片类型拆解安装步骤,从版本选择、下载安装到验证使用、优化配置,一步到位,同时补充常见报错解决方法,让你不管是Intel还是Apple芯片的Mac,都能一次安装成功!

建议收藏+关注,跟着Docker系列教程,从Linux到Mac,覆盖主流系统的Docker安装实操,彻底打通“多系统容器化”的落地闭环!

一、安装前必看:核心准备(Intel/Apple芯片通用)

安装前先确认2个关键信息,避免走弯路:

  1. 确认Mac芯片类型(必做):

  1. 点击屏幕左上角「苹果图标」→「关于本机」,查看“芯片”栏:

    • 显示「Intel Core i5/i7/i9」等:Intel芯片;

    • 显示「Apple M1/M2/M3」等:Apple Silicon芯片。

  1. 确认macOS系统版本

      低于上述版本需先升级系统,否则无法安装最新版Docker Desktop。

    1. Intel芯片:要求macOS ≥10.14(Mojave);

    2. Apple Silicon芯片:要求macOS ≥11.0(Big Sur);

  2. 版本选型:新手/个人学习直接选「Docker Desktop for Mac(CE社区版)」,免费且功能全,无需考虑EE企业版(仅企业生产环境需要)。

二、Apple Silicon芯片(M1/M2/M3)Docker安装全流程

Apple芯片是目前新款Mac的主流,Docker官方已推出原生适配版本,安装流程最简单,步骤如下:

步骤1:下载适配版本的Docker Desktop

  1. 打开Docker官方下载页:https://www.docker.com/products/docker-desktop/

  2. 页面会自动识别Apple Silicon芯片,显示「Download for Mac (Apple Silicon)」,点击下载(约500MB);

  1. ✅ 备用下载地址(国内加速):https://mirrors.aliyun.com/docker-toolbox/mac/docker-desktop/

  1. 下载完成后,得到「Docker.dmg」安装包。

步骤2:安装Docker Desktop

  1. 双击「Docker.dmg」,弹出安装窗口;

  2. 将左侧「Docker」图标拖拽到右侧「Applications」文件夹(macOS标准安装方式);

  3. 等待复制完成后,右键「Applications」中的「Docker」,选择「打开」(首次打开需确认,避免系统拦截);

  4. 首次启动会弹出「Docker Service Agreement」,点击「Accept」接受协议;

  5. 等待Docker启动(状态栏会出现鲸鱼图标,从“加载中”变为“稳定状态”,约1-2分钟)。

步骤3:验证安装是否成功

无需复杂命令,2步验证:

  1. 图形化验证

  1. 启动后自动打开Docker Dashboard,左侧显示「Containers」「Images」等菜单,无报错即启动成功;

  1. 命令行验证(终端执行):

    
      

    # 查看Docker版本 docker --version # 运行hello-world镜像(验证功能) docker run hello-world

      ✅ 成功标志:

    1. docker --version输出类似「Docker version 25.0.3, build 4debf41」;

    2. docker run hello-world输出「Hello from Docker!」等提示,说明镜像拉取、容器运行正常。

步骤4:安装后优化(国内用户必做)

默认镜像源在国外,拉取镜像速度慢,配置阿里云镜像加速器:

  1. 点击状态栏「Docker鲸鱼图标」→「Settings」(设置);

  2. 左侧选择「Docker Engine」,在右侧配置框中添加镜像加速器地址:

    
      

    { "registry-mirrors": [ "https://你的阿里云加速器地址.mirror.aliyuncs.com", "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com" ] }

      ✨ 阿里云加速器地址获取:登录阿里云控制台→「容器镜像服务」→「镜像加速器」,复制专属地址;

    1. 点击「Apply & Restart」,Docker会重启并应用配置,验证是否生效:

      
        

      docker info # 输出中找到Registry Mirrors,显示配置的地址即成功

      三、Intel芯片Mac Docker安装全流程

      Intel芯片Mac的安装流程和Apple Silicon几乎一致,仅下载版本不同,步骤如下:

      步骤1:下载适配版本的Docker Desktop

      1. 打开Docker官方下载页:https://www.docker.com/products/docker-desktop/

      2. 页面自动识别Intel芯片,显示「Download for Mac (Intel Chip)」,点击下载;

      3. 下载完成后得到「Docker.dmg」安装包(Intel版本约600MB)。

      步骤2:安装Docker Desktop

      和Apple Silicon芯片完全一致:

      1. 双击「Docker.dmg」,拖拽「Docker」到「Applications」;

      2. 首次打开需确认“来自未知开发者”(系统设置→隐私与安全性→允许Docker运行);

      3. 接受协议后等待启动,状态栏出现鲸鱼图标即启动成功。

      步骤3:验证安装

      和Apple Silicon芯片一致,执行以下命令:

      
      

      docker --version docker run hello-world

      ✅ 成功标志相同,不再赘述。

      步骤4:安装后优化

      同样配置镜像加速器,步骤和Apple Silicon芯片完全一致,核心是修改「Docker Engine」的registry-mirrors配置。

      四、Mac Docker安装常见报错及解决(新手必看)

      报错1:「Docker无法打开,因为来自未知开发者」

      解决:

      1. 右键「Applications」中的Docker→「显示简介」;

      2. 勾选「覆盖恶意软件保护」(macOS 13+),或点击「打开」(macOS 12-);

      3. 若仍无法打开,进入「系统设置→隐私与安全性」,底部会显示「Docker被阻止」,点击「允许」即可。

      报错2:「Docker启动失败,提示“Virtualization framework not available”」

      原因:macOS版本过低或虚拟化未开启(Intel芯片)。

      解决:

      1. Intel芯片:重启Mac,开机按「Command+R」进入恢复模式→「实用工具→终端」,执行csrutil disable关闭SIP,重启后重新启动Docker;

      2. 确认macOS版本达标(Intel≥10.14,Apple≥11.0),低于则升级系统。

      报错3:「docker run hello-world 拉取镜像超时」

      原因:未配置镜像加速器,国外源访问慢。

      解决:按前文步骤配置阿里云/网易云加速器,重启Docker后重试。

      报错4:Apple Silicon芯片安装Intel版本Docker,启动闪退

      原因:版本不兼容(Intel版本无法在Apple芯片运行)。

      解决:删除当前Docker,重新下载「Download for Mac (Apple Silicon)」版本安装。

      五、Mac vs Linux Docker安装核心差异(新手对比记忆)

      为了方便你对比记忆,整理核心差异表:

      对比维度

      Mac系统

      Linux系统(CentOS/Ubuntu)

      安装方式

      图形化安装包(.dmg)

      命令行安装(yum/apt)

      依赖技术

      虚拟化(HyperKit/Apple虚拟化)

      原生支持(Linux内核)

      启动方式

      图形化启动(鲸鱼图标)

      命令行启动(systemctl start)

      配置方式

      图形化设置+配置文件

      仅配置文件(/etc/docker/daemon.json)

      权限管理

      默认免sudo(桌面版特性)

      需要sudo或加入docker组

      总结

      核心安装步骤回顾

      1. Apple Silicon芯片:下载Apple版Docker.dmg→拖拽安装→启动验证→配置加速器;

      2. Intel芯片:下载Intel版Docker.dmg→拖拽安装→启动验证→配置加速器;

      3. 通用优化:配置国内镜像加速器,解决拉取镜像慢的问题。

      关键避坑点

      1. 务必下载和芯片匹配的版本(Apple/Intel),否则启动失败;

      2. macOS版本需达标(Apple≥11.0,Intel≥10.14);

      3. 国内用户必配镜像加速器,避免镜像拉取超时。

      后续我会更新Docker核心操作(镜像/容器管理)、Docker Compose实战,关注我,从安装到实战,一步步吃透Docker,不管是Mac还是Linux,都能轻松上手容器化开发!

      觉得有用的话,收藏+关注,评论区扣“Mac Docker安装”,免费领取《Mac Docker避坑手册+镜像加速器配置清单》,助力你一次安装成功,少走弯路~

      Logo

      魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

      更多推荐