Docker环境搭建:Windows/macOS/Linux全平台教程
上一章我们搞懂了Docker的核心价值——用容器化解决环境难题。这一章,咱们直接上手实操:如何在自己的电脑上安装Docker?不管你用的是Windows、macOS还是Linux,跟着步骤走,5-10分钟就能搞定!
本文会详细拆解各系统的安装步骤,附带国内镜像加速配置(解决拉取镜像慢的问题),以及安装后的验证方法。最后还整理了新手最常踩的坑和解决方案,放心跟着操作~
一、先搞懂:Docker版本怎么选? 🤔
Docker有两个主要版本:
- 社区版(Docker CE):免费开源,适合个人开发者和小团队,功能完全能满足日常使用(我们选这个!)。
- 企业版(Docker EE):收费,提供官方技术支持,适合大型企业,个人学习用不上。
结论:直接安装Docker CE(社区版)即可,本章所有步骤均基于CE版。
二、Windows系统安装:注意版本和Hyper-V 🔍
Windows用户需要注意:Docker在Windows上的运行依赖Hyper-V虚拟化技术,而Windows家庭版默认不支持Hyper-V,需要额外配置。
适用系统:
- Windows 10 专业版/企业版/教育版(Build 16299+)
- Windows 11 专业版/企业版/教育版
- Windows 10/11 家庭版(需手动开启Hyper-V,步骤见下文)
步骤1:开启Hyper-V(家庭版必看,专业版可能已开启)
- 新建一个文本文件,复制以下代码并保存为
Hyper-V.bat(注意后缀是.bat):pushd "%~dp0" dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i" del hyper-v.txt Dism /online /enable-feature /featurename:Microsoft-Hyper-V -All /LimitAccess /ALL pause - 右键文件,选择“以管理员身份运行”,等待命令执行完成(期间可能会提示重启电脑,选“是”)。
步骤2:下载并安装Docker Desktop
- 访问Docker官网下载:Docker Desktop for Windows(如果官网慢,可搜“阿里云Docker镜像”找国内下载源)。
- 双击安装包,勾选以下选项(默认已勾选,确认即可):
- Use WSL 2 instead of Hyper-V(推荐用WSL2,启动更快,兼容更好)
- Add shortcut to desktop(桌面快捷方式)
- 点击“OK”,等待安装完成,完成后会提示重启电脑,按提示重启。
步骤3:验证安装是否成功
- 重启后,桌面会出现Docker图标,双击启动(首次启动可能需要几分钟,状态栏出现鲸鱼图标即启动成功)。
- 打开Windows终端(或CMD、PowerShell),输入以下命令:
docker --version # 查看版本,出现版本号说明安装成功 docker run hello-world # 运行测试容器,出现"Hello from Docker!"说明正常工作
三、macOS系统安装:区分芯片型号很重要 🍎
macOS用户需要注意自己的芯片类型:Intel芯片和Apple Silicon(M1/M2/M3等) 对应的Docker版本不同,下载时要选对。
步骤1:确认芯片型号
点击左上角苹果图标 → “关于本机” → 查看“芯片”信息(如“Apple M1”或“Intel Core i5”)。
步骤2:下载并安装Docker Desktop
- 访问官网下载对应版本:Docker Desktop for Mac
- Intel芯片选“Mac with Intel chip”
- Apple Silicon选“Mac with Apple chip”
- 下载后得到
.dmg文件,双击打开,将Docker图标拖到“应用程序”文件夹中。
步骤3:启动并验证
- 打开“应用程序”,找到Docker并启动(首次启动会提示“是否打开”,点“打开”)。
- 启动成功后,顶部状态栏会出现鲸鱼图标。
- 打开终端(Terminal),输入命令验证:
docker --version # 显示版本号 docker run hello-world # 运行测试容器,成功会输出欢迎信息
四、Linux系统安装:以Ubuntu和CentOS为例 🐧
Linux是Docker的原生环境,安装步骤更简单,这里以最常用的Ubuntu 20.04+ 和CentOS 7+ 为例。
4.1 Ubuntu系统安装
- 卸载旧版本(如果之前装过):
sudo apt-get remove docker docker-engine docker.io containerd runc - 安装依赖包:
sudo apt-get update sudo apt-get install ca-certificates curl gnupg lsb-release - 添加Docker官方GPG密钥:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg - 设置Docker仓库(国内用户推荐用阿里云镜像仓库,速度更快):
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null - 安装Docker CE:
sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io - 验证安装:
sudo docker --version # 显示版本号 sudo docker run hello-world # 运行测试容器(注意加sudo,后续可配置免sudo)
4.2 CentOS系统安装
- 卸载旧版本:
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine - 安装依赖:
sudo yum install -y yum-utils - 设置阿里云镜像仓库:
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo - 安装Docker CE:
sudo yum install docker-ce docker-ce-cli containerd.io - 启动Docker并设置开机自启:
sudo systemctl start docker # 启动服务 sudo systemctl enable docker # 开机自启 - 验证安装:
sudo docker --version sudo docker run hello-world
五、必做:配置国内镜像加速,解决拉取慢的问题 🚀
Docker默认镜像源在国外,拉取镜像(比如Nginx、MySQL)可能很慢,甚至失败。配置国内镜像源(如阿里云、网易云)能大幅提速。
配置方法(全平台通用):
- 打开Docker Desktop(Windows/macOS点击状态栏鲸鱼图标 → “Settings”/“偏好设置”;Linux直接修改配置文件)。
- 找到“Docker Engine”(Windows/macOS在设置里),或编辑Linux配置文件
/etc/docker/daemon.json(如果没有就新建)。 - 在配置中添加国内镜像源,示例:
{"registry-mirrors": ["https://registry.docker-cn.com", // 官方中国镜像"https://mirror.aliyuncs.com", // 阿里云镜像(推荐,可登录阿里云获取专属加速地址)"http://hub-mirror.c.163.com" // 网易云镜像] } - 保存配置,重启Docker(Windows/macOS点击“Apply & Restart”;Linux执行
sudo systemctl restart docker)。
六、新手常踩的5个坑及解决方案 ❌→✅
-
Windows家庭版安装失败:提示“Hyper-V未开启”
→ 解决方案:按上文步骤运行Hyper-V.bat开启,或升级到专业版(不推荐)。 -
启动Docker时提示“WSL 2安装不完整”(Windows)
→ 解决方案:打开PowerShell输入wsl --install,按提示安装WSL2,重启后再启动Docker。 -
Linux执行docker命令提示“权限不够”
→ 解决方案:将当前用户加入docker组:sudo usermod -aG docker $USER # 加入组 newgrp docker # 刷新组权限(无需重启) -
拉取镜像时一直卡住,最后超时
→ 解决方案:检查是否配置了国内镜像加速,或暂时关闭VPN(部分VPN会影响)。 -
macOS M1芯片运行某些镜像报错“no matching manifest”
→ 原因:部分旧镜像不支持ARM架构。
→ 解决方案:在docker run命令后加--platform linux/amd64,如docker run --platform linux/amd64 hello-world。
七、总结:环境搭好了,下一步学什么? 🎯
恭喜你!到这里,你的Docker环境已经搭建完成,并且通过了hello-world测试。从现在开始,你可以用Docker运行各种应用容器了~
下一章,我们会深入讲解Docker的三大核心概念:镜像(Image)、容器(Container)、仓库(Repository),搞懂这三个概念,你就真正入门Docker了。
如果安装过程中遇到其他问题,欢迎在评论区留言,我会逐一解答~
小练习:试着拉取一个Nginx镜像并运行(命令:docker run -d -p 8080:80 --name mynginx nginx),然后在浏览器访问localhost:8080,看看会出现什么?
