1. 从"在我这儿能跑"说起：Docker到底在解决什么问题
做开发这些年，几乎每个人都被同一句话折磨过："代码我这边跑得好好的，你那儿怎么就不行？"环境不一致带来的问题，远比代码本身多得多。某个服务在A机器上是Python 3.8，在B机器上是3.10；某个依赖库版本不同导致接口行为不一致；数据库版本、系统库缺失、环境变量没配齐……每一样都能让"正常跑通"变成玄学。
Docker解决的就是这件事。它把应用代码连同运行环境、依赖、配置一起打包成一个镜像，再以容器的形式运行。容器里的进程看到的是一个独立的小世界，它包含了应用所需的全部运行环境，却和宿主机共享内核资源。说白了，Docker把一个应用最脆弱的部分——"环境依赖关系"——变成了可以复制、可以分发、可以版本管理的文件产物。你不需要再写一长串"安装步骤文档"，只需要一条命令，就能在任何装了Docker的机器上把这个应用拉起来。
所以Docker适合谁？不只是后端工程师。前端要跑Node环境、测试要搭数据库、算法要跑模型推理、运维要部署服务，所有人都会遇到环境隔离的需求。装上Docker之后，最直观的体验就是：再也没有"为某个项目单独装一套依赖到系统里"的负担，项目用完，容器删掉，环境干干净净。
这篇教程我会按照Windows、Mac、Linux三个平台分别给出安装配置方案，不只要告诉你敲什么命令，更重要的是把每个平台容易踩的坑、安装背后的原理讲清楚。文章基于我安装配置Docker的实践经验整理，覆盖从下载到配置镜像加速、再到验证安装的完整链路，希望能让初学者少走弯路。
2. 准备工作：不管哪个平台，先搞懂Docker几个核心概念
动手之前，几个基础概念必须先理清，否则配置过程中你会被各种术语绕晕。镜像是只读的模板，定义了容器的文件系统、启动命令和运行环境；容器是镜像运行的实例，可以启动、停止、删除；Dockerfile是用来构建镜像的脚本。这三个概念对应到实际工作中，就是"下载一个模板 - 用模板开一个实例 - 想改模板就写脚本重新构建"。
还有一个容易搞混的点：Docker有两种不同的运行模式。一种是Docker Engine，它是真正负责构建和运行容器的后台服务；另一种是Docker Desktop，它是带图形界面的客户端工具，内置了Engine，并提供了菜单栏/托盘管理、可视化监控、一键配置等功能。在Windows和Mac上，官方主推的是Docker Desktop；在Linux上，由于没有完整的桌面版支持，通常直接安装Docker Engine，再用命令行或第三方图形工具管理容器。
另外要注意的是，Docker容器和虚拟机是两回事。虚拟机里运行一个完整的客户操作系统，需要单独分配CPU、内存、磁盘；容器则直接复用宿主机内核，通过Linux内核的命名空间和控制组机制实现隔离。正因如此，容器启动速度极快，资源占用也小得多，一台8GB内存的笔记本跑五六个容器完全没问题。但也因为共享内核，容器内不能运行与宿主机内核版本不兼容的软件，这是后续选镜像版本时需要考虑的约束。
在正式安装之前，我还建议先确认自己要装的方向：
- 只做本地开发、调试，需要图形化管理界面，选Docker Desktop。
- 服务器部署、追求最小占用，或者想省内存，直接装Docker Engine。
- 如果是老机器、低配机器，或者只想跑轻量服务，也可以考虑用Podman这类替代方案，但不在本教程范围内。
明确了目标，下面分平台安装。
3. Windows平台安装：WSL2是绕不开的核心步骤
Windows上装Docker，最稳的路径就是Docker Desktop + WSL2。WSL2相当于Windows内置的一个轻量Linux子系统，Docker Desktop在Windows上默认会调用WSL2作为后端来运行Linux容器。这一组合的好处是：内核由微软统一管理，兼容性好，性能和资源占用也明显优于早期的Hyper-V方案。
3.1 Windows Home/Pro版本的前置检查
先确认Windows版本。Docker Desktop要求Windows 10 64位版本2004及以上，或者Windows 11。老版本系统建议先升级系统再装Docker，硬装容易遇到内核不支持的问题。
前置步骤依次为：
- 控制面板 - 程序和功能 - 启用或关闭Windows功能，勾选"适用于Linux的Windows子系统"和"虚拟机平台"。
- 以管理员身份打开PowerShell，执行
wsl --update更新WSL内核。 - 执行
wsl --set-default-version 2将默认版本设为2。
很多人在这一步卡住，因为根本没有安装任何Linux发行版。建议执行wsl --list --online查看可用发行版，然后执行wsl --install -d Ubuntu-22.04安装一个Ubuntu，后续Docker Desktop会借这个发行版跑后端服务。装完后用wsl --status检查版本是否为2，如果显示Version 1，用wsl --set-version Ubuntu-22.04 2切换。
3.2 Docker Desktop安装与首次启动
到官网下载Docker Desktop安装包，双击安装。安装过程中有一个关键勾选项——"Use WSL 2 based engine"，新版默认勾选，保持勾选即可。这里不要改成Hyper-V模式，除非你有特殊原因必须用Hyper-V，否则WSL2模式在资源占用和启动速度上都要舒服得多。
安装完需要重启电脑，然后启动Docker Desktop。首次启动会看到WSL数据迁移或初始化过程，耐心等它跑完。启动后在Windows命令行里执行：
docker version docker run hello-worlddocker version需要能看到client和server两段信息，如果只有client没有server，说明引擎没启动，回到Docker Desktop看托盘图标是否变成绿色。docker run hello-world能打印出一段欢迎信息，说明整个链路已经通了。
3.3 Windows平台最容易踩的坑
坑一：启动报"error during connect"或daemon没有运行。这种情况90%是WSL2发行版没设置好，或者Docker Desktop还在启动中。先看托盘图标状态，再确认WSL发行版是否正常：wsl --shutdown后重新启动Docker Desktop。
坑二：WSL2模式下磁盘占用膨胀。Docker Desktop默认把镜像数据放在WSL的虚拟磁盘里，这个虚拟磁盘文件会只增不减。新版Docker Desktop里可以通过Settings - Resources - Disk 调整上限，建议设置了之后定期执行docker system prune清理悬空镜像和停止的容器。
坑三：公司电脑受限，无法打开虚拟化。进BIOS开启Intel VT-x或AMD SVM，然后再启用Windows功能。这一步不解决，Docker Desktop是跑不起来的。
提示：尽量不要同时启用Hyper-V、WSL2、Android模拟器等多套虚拟化方案，它们有时候会互相抢占资源，导致启动异常。开发机上保持WSL2一个方案最省心。
4. Mac平台安装：芯片不同，安装路径完全不同
Mac上装Docker，首先搞清楚芯片架构。2020年以后的M系列芯片是arm64架构，之前的Intel芯片是x86_64架构，两者的镜像在不同平台上有兼容性问题。好在Docker Desktop会自动识别芯片类型并作适配，但镜像拉取时还是要注意选择对应的平台版本。
4.1 Apple Silicon机器：下载arm64版本
对M1/M2/M3机型，直接访问Docker官网下载Apple Silicon版DMG安装包，拖动到应用程序文件夹即完成安装。启动Docker Desktop后，右上角菜单栏出现小鲸鱼图标，说明引擎已在运行。
需要注意，很多早期镜像没有arm64版本，直接运行会报exec format error。解决办法有两个：一是找镜像的multi-arch版本，官方镜像一般都有；二是临时用模拟方式运行x86镜像，在Docker Desktop的Settings - General里勾选"Use Rosetta for x86/amd64 emulation on Apple Silicon"，但这样做性能损耗明显，不适合生产环境。
4.2 Intel Mac：安装与资源设置
Intel Mac上安装的DMG包和苹果芯片版不同，不要混用。装完之后运行同样没问题，但需要重点观察资源占用。Docker Desktop默认分配的内存可能偏大，在Intel芯片上容易造成风扇狂转。建议在Settings - Resources中把内存限制在4GB以内，CPU限制在4核以内，本地开发够用。
如果你习惯用Homebrew管理软件，也可以通过命令行直接安装：
brew install --cask docker这个命令安装的同样是Docker Desktop，管理起来会更方便，升级时brew upgrade --cask docker即可。要注意，Homebrew还有一个命令行版的docker工具包，那个只有client没有图形界面和引擎，装完还得另配引擎，新手直接用--cask版本更省事。
4.3 Mac平台的镜像加速与清理技巧
Mac版Docker Desktop默认从官方Docker Hub拉取镜像，国内网络环境下经常超时。在Settings - Docker Engine里编辑daemon配置，加入镜像加速地址，之后重启Docker Desktop生效。后面第6章我会统一给出配置模板，这里先不展开。
清理方面，Mac版没有Windows那种虚拟磁盘膨胀的问题，但同样会积累大量悬空镜像。建议定期执行：
docker system prune -a --volumes这条命令会删除所有未使用的镜像、容器、网络和数据卷，执行前建议确认没有需要保留的中间产物。我在实际使用中发现，Mac平台上Docker Desktop的菜单栏图标可以快速查看容器CPU和内存占用，排查资源异常时比命令行直观得多。
5. Linux平台安装：一条命令之外，还有很多细节
Linux上装Docker没有图形界面版，装的是Docker Engine + CLI工具。官方推荐使用安装脚本一键安装，但对自定义程度高的用户，逐条执行apt/yum命令更稳妥。
5.1 Ubuntu/Debian系安装步骤
Ubuntu上安装可以走官方apt源，先在终端执行一系列准备命令：
sudo apt update sudo apt install ca-certificates curl gnupg sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg然后添加软件源并安装：
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin如果嫌麻烦，也可以用一条脚本装：
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh但脚本方式不会区分发行版细节，在特殊定制的系统上可能出现源不匹配的问题，所以我的建议是：临时环境用脚本，生产服务器用逐条命令安装，逐条方式能清楚知道每一步做了什么。
5.2 CentOS/RHEL系与国产Linux发行版的差异
CentOS/RHEL系的安装逻辑相似，但包管理工具是yum/dnf，且需要先配置Docker官方仓库。在CentOS 7这类老系统上，还要注意内核版本不能太低，否则部分网络功能不可用。这里不展开每个发行版的命令，核心思路是：先配仓库，再装docker-ce三个套件，最后启用服务。
国产Linux发行版，包括基于CentOS的和基于Debian的各类系统，安装方式主要看它的软件源里是否自带docker包。有些自带旧版docker.io，功能上够用但版本较老，建议优先从官方源安装。
5.3 免sudo运行Docker的用户配置
Linux上刚装完Docker，执行任何docker命令都需要加sudo，这是新手最烦的一点。原因是docker守护进程默认绑定在Unix socket上，只有root用户和docker组内的用户才有权限访问。解决办法：
sudo usermod -aG docker $USER执行完这条命令，需要注销并重新登录，或者执行newgrp docker刷新组权限。之后执行docker version就不再需要sudo了。这里提醒一下：把用户加入docker组相当于赋予了该用户等同于root的容器管理权限，在多人共用的服务器上要谨慎，不要图方便把所有账号都加进去。
5.4 开机自启与基础配置
Linux上Docker不会自动启动，需要手动设置：
sudo systemctl enable docker sudo systemctl start dockerenable设置开机启动，start在当前会话立即启动。如果后续修改了daemon配置，用sudo systemctl restart docker重启服务，不能只关掉再开，有些配置在重启后才会重新加载。
6. 三平台通用配置：镜像加速、资源限制与验证脚本
安装完成只是开始，Docker装好之后有三件事建议立刻做，否则后面用起来会频繁遇到拉镜像超时、资源占满、权限报错这些问题。
6.1 配置镜像加速源
默认从Docker Hub拉取镜像，在国内网络环境下确实不稳定。配置镜像加速是在daemon.json中添加registry-mirrors字段。Windows和Mac在Docker Desktop的Settings - Docker Engine中编辑；Linux直接编辑/etc/docker/daemon.json（不存在则新建）：
{ "registry-mirrors": [ "https://docker.m.daocloud.io", "https://dockerproxy.com", "https://docker.nju.edu.cn" ] }配置完成后重启Docker，执行docker info查看Registry Mirrors字段是否包含上述地址。如果还是超时，可以多试几个可用源。个人经验是，加速源可用性随时间变动，不要长期依赖某一个，定期用docker pull实测速度最靠谱。
注意：如果你所在企业内网有自建Registry，可以直接把内网地址放在最前面，这样拉取内部镜像时会优先命中内网。
6.2 限制容器资源与日志大小
容器默认不限制资源，一个写崩溃的死循环容器可能把宿主机CPU打满。通过daemon.json统一控制更省心：
{ "max-concurrent-downloads": 5, "log-driver": "json-file", "log-opts": { "max-size": "10m", "max-file": "3" } }这里max-size和max-file的组合能限制单个容器日志文件的大小和数量，否则长时间运行的服务日志可能膨胀到GB级，占满磁盘。max-concurrent-downloads控制并发拉取数量，避免同时拉多个大镜像时带宽被占满。
6.3 验证安装的完整检查清单
装完Docker后，我建议按下面这套顺序做一次整体验证，确认没问题再开始用，省得后面排查环境问题：
docker version：client和server都正常返回版本号。docker info：确认Storage Driver、镜像加速地址、容器运行数量。docker run hello-world：验证能否从远端拉取镜像并运行容器。docker ps：能看到hello-world容器短暂出现过并退出。- 手动启动一个正式服务测试，比如：
docker run -d --name nginx-test -p 8080:80 nginx curl localhost:8080curl返回nginx默认页面说明端口映射、网络都正常。这套检查做过一次，基本上可以确定Docker环境没有配置层面的问题。
7. 安装后的常见故障排查：从现象到根因
安装过程中遇到错误是必然的，关键是要有排查的思路。下面几个场景是我在实际使用中高频遇到的，每个都给出从现象到根因的排查链路。
7.1 Windows下daemon启动失败
现象：Docker Desktop图标一直是橙黄色或红色，命令行执行docker ps报cannot connect to the Docker daemon。
排查步骤：先看WSL是否正常。终端执行wsl -l -v，确认发行版状态。如果显示发行版是Stopped，执行wsl --shutdown再启动Docker Desktop。如果显示Version 1，执行wsl --set-version <名称> 2切换到WSL2。
再看Docker Desktop的Settings - Troubleshoot，里面有日志导出功能，导出日志后搜索error关键词，通常能直接看到WSL启动失败或虚拟化不可用的具体报错。之前遇到过一例，原因是Windows更新后WSL组件被重置，重新执行wsl --update解决。
7.2 Mac下容器启动超时
现象：M系列芯片上容器一直处于Created状态，日志里出现exec format error或operation not permitted。
根因：多半是镜像架构与当前系统不匹配，或者是文件权限问题。第一个局面看镜像是否支持arm64，Docker Hub的镜像详情页会标注Architecture，支持列表里没有arm64就要换镜像源或模拟运行。权限问题常见于挂载宿主机目录的场景，容器内进程和宿主机文件的UID/GID不一致导致无权访问，排查时用docker logs看具体哪一层报错，再决定是否调整挂载目录的权限。
7.3 Linux下网络无法访问外网
现象：容器内ping baidu.com不通，但宿主机网络正常。
根因：Docker默认使用bridge网络，容器通过NAT访问外网。导致不通的原因通常是宿主机防火墙对iptables的规则干扰，或者docker服务启动时iptables被其他服务清空。快速排查方法：
sudo iptables -L -n | grep DOCKER sudo systemctl restart docker如果重启后恢复，说明是其他程序（如ufw、firewalld）与Docker的网络规则冲突。解决办法是把Docker的网段加入防火墙白名单，或者调整防火墙规则顺序。这个问题的表现形式很多，核心思路是先确认iptables规则是否存在，再确认容器IP转发是否开启：sudo sysctl net.ipv4.ip_forward，输出为1才正常。
7.4 磁盘空间被Docker占满
现象：df -h显示根分区满了，但查文件发现都是正常文件。
根因：容器日志、悬空镜像层、数据卷占用都在被忽略的位置。先看各部分占用：
docker system df输出会列出Images、Containers、Local Volumes各自的占用空间。定位到大头之后，用docker system prune -a清理悬空产物，用docker volume prune清理无用卷，日志文件在Linux下通常在/var/lib/docker/containers/<容器ID>/*-json.log，按容器逐个清理。Docker Desktop则通过界面Settings - Resources直接管理。
8. 给新人的几条实操建议
最后从我自己的使用体验出发，讲几个不是教程里常提、但实际影响很大的细节。
第一，尽量保持Docker版本更新到最新。Docker的镜像格式、网络管理、安全补丁都在持续演进，老版本遇到新镜像拉取失败的概率很高。Windows和Mac用Docker Desktop自带的自动更新即可，Linux上装了新版本后，命令行的自补全功能也更完善。
第二，不要把所有服务都容器化。Docker适合的是无状态、可替换的应用，数据库这类有状态服务容器化后数据持久化需要额外挂载卷，复杂度明显上升。本地开发阶段我用Docker跑MySQL、Redis、Nginx都很顺手，但涉及重要数据的场景，我更倾向于把数据目录明确挂载到宿主机，并定期备份。
第三，Dockerfile写得好不好，决定镜像后续好不好维护。不要什么都塞进一层，RUN命令尽量合并精简，构建缓存要善用。这些一开始不注意，后续构建镜像会越来越慢，构建出的镜像体积也水涨船高。建议新手先从官方镜像的自带仓库里抄几个优秀Dockerfile，对照着学，比自己从零摸索效率高得多。
Docker这套工具链，装好只是第一步，真正把它用起来需要的是对各种报错的应对能力。希望这份安装配置教程能让你把起步阶段的障碍一次清完。环境搭好之后，Docker带给你的效率提升，会让你觉得这些折腾完全值得。
