Mac 系统 Docker 安装教程:Intel 与 Apple Silicon 芯片适配
前言:前面我们已经吃透了Linux系统(CentOS/Ubuntu)Docker的安装流程,现在聚焦Mac系统——作为开发者常用的桌面系统,Mac的Docker安装和Linux有本质区别(依赖虚拟化技术),且需要区分Intel和Apple Silicon(M1/M2/M3)芯片,新手稍不注意就会下载错误版本导致安装失败。
本文全程新手友好,分芯片类型拆解安装步骤,从版本选择、下载安装到验证使用、优化配置,一步到位,同时补充常见报错解决方法,让你不管是Intel还是Apple芯片的Mac,都能一次安装成功!
建议收藏+关注,跟着Docker系列教程,从Linux到Mac,覆盖主流系统的Docker安装实操,彻底打通“多系统容器化”的落地闭环!
一、安装前必看:核心准备(Intel/Apple芯片通用)
安装前先确认2个关键信息,避免走弯路:
-
确认Mac芯片类型(必做):
-
点击屏幕左上角「苹果图标」→「关于本机」,查看“芯片”栏:
-
显示「Intel Core i5/i7/i9」等:Intel芯片;
-
显示「Apple M1/M2/M3」等:Apple Silicon芯片。
-
-
确认macOS系统版本:
低于上述版本需先升级系统,否则无法安装最新版Docker Desktop。
-
Intel芯片:要求macOS ≥10.14(Mojave);
-
Apple Silicon芯片:要求macOS ≥11.0(Big Sur);
-
-
版本选型:新手/个人学习直接选「Docker Desktop for Mac(CE社区版)」,免费且功能全,无需考虑EE企业版(仅企业生产环境需要)。
二、Apple Silicon芯片(M1/M2/M3)Docker安装全流程
Apple芯片是目前新款Mac的主流,Docker官方已推出原生适配版本,安装流程最简单,步骤如下:
步骤1:下载适配版本的Docker Desktop
-
打开Docker官方下载页:https://www.docker.com/products/docker-desktop/
-
页面会自动识别Apple Silicon芯片,显示「Download for Mac (Apple Silicon)」,点击下载(约500MB);
-
✅ 备用下载地址(国内加速):https://mirrors.aliyun.com/docker-toolbox/mac/docker-desktop/
-
下载完成后,得到「Docker.dmg」安装包。
步骤2:安装Docker Desktop
-
双击「Docker.dmg」,弹出安装窗口;
-
将左侧「Docker」图标拖拽到右侧「Applications」文件夹(macOS标准安装方式);
-
等待复制完成后,右键「Applications」中的「Docker」,选择「打开」(首次打开需确认,避免系统拦截);
-
首次启动会弹出「Docker Service Agreement」,点击「Accept」接受协议;
-
等待Docker启动(状态栏会出现鲸鱼图标,从“加载中”变为“稳定状态”,约1-2分钟)。
步骤3:验证安装是否成功
无需复杂命令,2步验证:
-
图形化验证:
-
启动后自动打开Docker Dashboard,左侧显示「Containers」「Images」等菜单,无报错即启动成功;
-
命令行验证(终端执行):
# 查看Docker版本 docker --version # 运行hello-world镜像(验证功能) docker run hello-world✅ 成功标志:
-
docker --version输出类似「Docker version 25.0.3, build 4debf41」; -
docker run hello-world输出「Hello from Docker!」等提示,说明镜像拉取、容器运行正常。
-
步骤4:安装后优化(国内用户必做)
默认镜像源在国外,拉取镜像速度慢,配置阿里云镜像加速器:
-
点击状态栏「Docker鲸鱼图标」→「Settings」(设置);
-
左侧选择「Docker Engine」,在右侧配置框中添加镜像加速器地址:
{ "registry-mirrors": [ "https://你的阿里云加速器地址.mirror.aliyuncs.com", "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com" ] }✨ 阿里云加速器地址获取:登录阿里云控制台→「容器镜像服务」→「镜像加速器」,复制专属地址;
-
点击「Apply & Restart」,Docker会重启并应用配置,验证是否生效:
docker info # 输出中找到Registry Mirrors,显示配置的地址即成功
三、Intel芯片Mac Docker安装全流程
Intel芯片Mac的安装流程和Apple Silicon几乎一致,仅下载版本不同,步骤如下:
步骤1:下载适配版本的Docker Desktop
-
打开Docker官方下载页:https://www.docker.com/products/docker-desktop/
-
页面自动识别Intel芯片,显示「Download for Mac (Intel Chip)」,点击下载;
-
下载完成后得到「Docker.dmg」安装包(Intel版本约600MB)。
步骤2:安装Docker Desktop
和Apple Silicon芯片完全一致:
-
双击「Docker.dmg」,拖拽「Docker」到「Applications」;
-
首次打开需确认“来自未知开发者”(系统设置→隐私与安全性→允许Docker运行);
-
接受协议后等待启动,状态栏出现鲸鱼图标即启动成功。
步骤3:验证安装
和Apple Silicon芯片一致,执行以下命令:
docker --version docker run hello-world
✅ 成功标志相同,不再赘述。
步骤4:安装后优化
同样配置镜像加速器,步骤和Apple Silicon芯片完全一致,核心是修改「Docker Engine」的registry-mirrors配置。
四、Mac Docker安装常见报错及解决(新手必看)
报错1:「Docker无法打开,因为来自未知开发者」
解决:
-
右键「Applications」中的Docker→「显示简介」;
-
勾选「覆盖恶意软件保护」(macOS 13+),或点击「打开」(macOS 12-);
-
若仍无法打开,进入「系统设置→隐私与安全性」,底部会显示「Docker被阻止」,点击「允许」即可。
报错2:「Docker启动失败,提示“Virtualization framework not available”」
原因:macOS版本过低或虚拟化未开启(Intel芯片)。
解决:
-
Intel芯片:重启Mac,开机按「Command+R」进入恢复模式→「实用工具→终端」,执行
csrutil disable关闭SIP,重启后重新启动Docker; -
确认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组 |
总结
核心安装步骤回顾
-
Apple Silicon芯片:下载Apple版Docker.dmg→拖拽安装→启动验证→配置加速器;
-
Intel芯片:下载Intel版Docker.dmg→拖拽安装→启动验证→配置加速器;
-
通用优化:配置国内镜像加速器,解决拉取镜像慢的问题。
关键避坑点
-
务必下载和芯片匹配的版本(Apple/Intel),否则启动失败;
-
macOS版本需达标(Apple≥11.0,Intel≥10.14);
-
国内用户必配镜像加速器,避免镜像拉取超时。
后续我会更新Docker核心操作(镜像/容器管理)、Docker Compose实战,关注我,从安装到实战,一步步吃透Docker,不管是Mac还是Linux,都能轻松上手容器化开发!
觉得有用的话,收藏+关注,评论区扣“Mac Docker安装”,免费领取《Mac Docker避坑手册+镜像加速器配置清单》,助力你一次安装成功,少走弯路~











