Docker 安装全攻略：Windows与Linux环境部署及故障排查指南-代码聚汇网

Docker 安装全攻略：Windows与Linux环境部署及故障排查指南

lnstagram优选·2026-09-02·阅读 22 GEO检测（免费）

DockerDocker DesktopWSL2

|难度：普通|阅读约 43 分钟

去年冬天帮一个朋友装Docker，他打开安装包点了下一步，结果卡在“Docker Desktop failed to start because virtualisation support wasn’t detected”这个提示上，折腾了一晚上。后来发现只是BIOS里的虚拟化开关没打开，三秒钟就解决了。这类问题在网上特别多，但多数教程只教你怎么点下一步，不告诉你为什么装完起不来。

我写这篇文章，是想把Docker安装这件事从头到尾拆开讲清楚：Windows和Linux两条主流路径分别怎么装、安装时哪些选项是坑、装完怎么配置才能用得顺手、启动失败怎么排查。不管你是第一次接触Docker的新手，还是被各种报错折磨过的老油条，这篇都值得花十分钟读完。

1. 先搞明白：Docker装的是啥，装了之后有什么用

Docker说白了就是一个容器化平台，它能把你的应用连同环境一起打包成一个标准化的“盒子”，扔到哪台机器上都能跑起来。传统部署方式是“在服务器上装依赖、配环境、跑程序”，换一台机器就要重新折腾一遍。Docker的方式是“把环境和程序一起打包成镜像，镜像启动成容器，容器里直接跑”，一套流程到处复用。

它有三个核心概念，用生活化类比比较好理解：镜像（Image）就是一套完整的模板，相当于做蛋糕的模具；容器（Container）是镜像运行起来后的实例，相当于用模具烤出来的蛋糕；仓库（Registry）是存放镜像的地方，相当于超市货架，Docker Hub就是最大的公共货架。

明白这三个概念之后，你就知道安装这一步的份量了。装Docker不是简单地装个软件，而是选择你以后构建、分发、运行应用的底层方式。装得好不好，直接决定你后面用Docker跑MySQL、Redis、微服务时候的体验。

安装时有两个关键决策点值得提前想清楚：

操作系统的选择：Windows环境一般装Docker Desktop（带图形界面），Linux环境装Docker Engine（纯命令行）。两种装法差异很大，下面会分别讲。
虚拟化后端的取舍：Windows下Docker Desktop有两种运行模式——基于WSL2（Windows Subsystem for Linux 2）和基于Hyper-V。WSL2是现在的主流推荐，启动快、资源占用低；Hyper-V是传统方案，适合老版本Windows或者没有WSL2的环境。

说到WSL2，这里多提一句。WSL2本质上是Windows内置的一个轻量虚拟机，Docker Desktop借助它来运行Linux容器。所以Windows装Docker之前，往往要先搞定WSL2。这也是很多新手卡壳的地方——Docker Desktop装好了，但WSL2没配好，启动一样报错。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. Windows下安装Docker Desktop的完整流程

2.1 安装前的前置条件检查

Windows下装Docker Desktop，第一步不是下载安装包，而是检查你的电脑到底适不适合装。根据我处理各种安装失败案例的经验，90%的问题出在这三个前置条件没满足：

第一，系统版本。 Docker Desktop对Windows版本有硬性要求，Win10 64位需要22H2及以上版本，Win11则没什么问题。低版本Windows要么装不了新版Docker Desktop，要么装上了也跑不起来。检查方式是按下“Win + I”打开设置，进入“系统 - 关于”，查看Windows规格里的版本号。如果版本太老，先升系统再装Docker，别在旧系统上浪费时间。

第二，BIOS里必须开启虚拟化。 这一步是重灾区。很多电脑出厂默认关闭虚拟化，导致Docker Desktop启动时提示“virtualisation support wasn't detected”。检查方法很简单：打开任务管理器，切到“性能”选项卡，看CPU区域右下角的“虚拟化”一栏。如果是“已启用”，说明没问题；如果是“已禁用”，需要重启电脑，在开机时按Del或F2进入BIOS设置（不同品牌按键不一样），找到Intel Virtualization Technology（或AMD SVM）选项，设为Enabled，保存重启。

第三，WSL2环境要提前装好。 打开PowerShell（管理员模式），执行以下命令：

powershell复制wsl --status

如果提示没有安装发行版，或者WSL版本是1，需要先更新。最省事的方式是执行：

powershell复制wsl --install

这条命令会默认安装WSL2并设置好虚拟机平台，装完重启一次电脑。单独执行下面这条命令可以把默认WSL版本设置为2：

powershell复制wsl --set-default-version 2

提示：如果你执行wsl --install报错，很可能是系统更新没装全。去设置里的Windows更新，把“可选更新”里的“Windows虚拟机监控程序平台”和“适用于Linux的Windows子系统”勾上，装完重启再试。

2.2 下载安装与关键选项配置

前置条件满足后，去官网下载Docker Desktop安装包。下载地址是https://www.docker.com/products/docker-desktop/，装的时候注意页面右下角的下载按钮，别点到其他推广链接。安装包大约500MB左右，下载慢可以找个稳定的网络再拉。

双击安装程序，进入安装向导。这里有两个选项值得注意：

“Use WSL 2 instead of Hyper-V”（使用WSL 2代替Hyper-V）：建议勾选。这是Docker Desktop官方推荐的默认后端，实机体验下来，WSL2模式启动速度快，内存占用也比Hyper-V模式低不少。如果你的系统是Win11或者较新的Win10，直接勾它就行。
“Add shortcut to desktop”（在桌面创建快捷方式）：看个人习惯，我一般勾选。

接下来的安装过程不用管，等待进度条走完就行。完成后桌面会出现Docker Desktop的图标，双击启动。首次启动会弹出服务条款，点Accept同意，然后会花一点时间初始化Docker引擎。

这里要提醒一句：首次启动时右下角图标可能会一直转圈，状态栏显示“Docker Desktop is starting”。如果超过五六分钟还没起来，不要反复点重启，大概率是前置条件没满足，回到2.1节逐项排查。

2.3 验证安装与连接状态

启动完成后，验证安装是否成功。打开PowerShell或终端，执行：

powershell复制docker version

看到Client和Server两段信息都显示出来，说明Docker引擎已经正常跑了。如果Server段报错，比如提示“cannot connect to the Docker daemon”，多半是Docker Desktop后台服务没起来，去系统托盘找到Docker图标，右键选择“Restart”重启一下。

再跑一个最经典的“Hello World”命令：

powershell复制docker run hello-world

这条命令会自动从Docker Hub拉取一个最小的测试镜像并运行，如果看到“Hello from Docker!”的提示，恭喜你，Docker环境彻底跑通了。

3. Linux下安装Docker Engine：Ubuntu和CentOS两种主流方式

3.1 Ubuntu/Debian系安装（apt方式）

Linux下装Docker和Windows完全是两码事。不需要图形界面，也不用装Docker Desktop，直接装Docker Engine即可。这里以Ubuntu 20.04/22.04为例，完整走一遍安装流程。

第一步，卸载可能存在的旧版本。 有些云服务器或老系统自带旧版Docker包，先清理掉，避免依赖冲突：

bash复制sudo apt-get remove docker docker-engine docker.io containerd runc

第二步，更新apt包索引，并安装依赖包：

bash复制sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release

第三步，添加Docker官方GPG密钥和仓库。 这一步很关键，官方源里才有最新的docker-ce（Community Edition）版本：

bash复制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

添加仓库地址（假设你的Ubuntu版本代号是$(lsb_release -cs)，它自动识别）：

bash复制echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

第四步，安装Docker Engine：

bash复制sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

这里别漏了docker-compose-plugin，它提供docker compose子命令，后面编排多容器会用得上。

第五步，启动服务并设置开机自启：

bash复制sudo systemctl start docker
sudo systemctl enable docker

第六步，验证：

bash复制sudo docker run hello-world

3.2 CentOS/RHEL系安装（yum方式）

CentOS 7/8的安装流程和Ubuntu略有不同，核心差异在于仓库配置方式和依赖管理工具。CentOS 7先要装yum-utils，配置仓库时指定的是$releasever变量。

bash复制sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl start docker
sudo systemctl enable docker

注意：CentOS 8以上版本里，yum底层已经换成dnf，但yum命令依然兼容。如果你用的是CentOS Stream或Rocky Linux，上面的命令一样可以用。

3.3 极简一键安装和权限配置

如果不想一步步敲命令，Docker官方提供了一条极简安装脚本：

bash复制curl -fsSL https://get.docker.com | bash

这条命令会自动识别系统、配置源、安装最新稳定版本，适合快速上手。我本地测试环境经常用它，几秒钟就装完。但在生产环境我建议还是手动走一遍流程，因为你需要确认每个环节都是可控的。

安装完毕后还有个高频权限问题：每次执行docker命令都要加sudo，很烦人。解决办法是把自己加入docker用户组：

bash复制sudo usermod -aG docker $USER
newgrp docker

加入用户组后，重新登录终端，再执行docker ps就不需要sudo了。

注意：把用户加入docker组等同于授予该用户root级别权限，因为docker组用户可以操控容器和挂载目录。个人开发机无所谓，多用户服务器上要谨慎。

4. 安装之后必须做的三件事：镜像加速、改路径、控权限

4.1 配置镜像加速器，解决拉取慢的问题

Docker装好，第一件要做的事是配置镜像加速器。如果你直接docker pull mysql:8.0，大概率会慢到怀疑人生，甚至直接超时。原因是Docker Hub的服务器在国外，跨海访问延迟高、速度慢。

解决方案是给Docker配置镜像加速器。国内有很多公共镜像加速服务，配置方式在Windows和Linux下略有不同。

Windows下，打开Docker Desktop，点击右上角设置图标，进入“Docker Engine”选项页，在JSON配置中加入：

json复制{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com"
  ]
}

Linux下，修改/etc/docker/daemon.json（没有就新建）：

bash复制sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com"
  ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

配置完重启Docker，重新拉镜像试试，速度会有肉眼可见的提升。我实测在配置加速器之后，拉一个几百兆的镜像从原来的十几分钟降到一两分钟。

4.2 Windows下修改镜像存储路径

Docker默认把镜像和容器数据存在C盘用户目录下，用久了C盘空间会越来越少。我见过一个开发同学，Docker里跑了一堆测试环境容器，C盘直接红了。因此，建议安装后第一时间把存储路径改到其他盘。

Windows下操作很简单：打开Docker Desktop设置，进入“Resources - Advanced”，找到“Disk image location”一栏，点Browse选择新的存储目录，然后点Apply & Restart。Docker会把现有的镜像数据迁移到新路径，过程大概需要几分钟，耐心等它跑完就行。

4.3 Docker服务状态管理和资源限制

Linux下，Docker引擎是常驻后台服务的，日常维护少不了一些管理命令。最常用的几个：

bash复制sudo systemctl status docker      # 查看服务状态
sudo systemctl restart docker     # 重启Docker服务
sudo systemctl stop docker        # 停止Docker服务
sudo systemctl enable docker      # 设置开机自启（安装时已执行）

Windows下Docker Desktop没有systemctl这套，但它有自动启动机制。默认设置里，Docker Desktop会在登录Windows时自动启动，不想要的可以在Settings - General里取消勾选“Start Docker Desktop when you sign in”。

资源限制这块，Windows下Docker Desktop的默认配置不一定适合所有人。打开Settings - Resources，可以看到CPU、内存、Swap的分配，Docker Desktop默认用宿主机一半内存，如果你的电脑内存只有8G，建议手动调低到4G左右，否则跑着Docker再开几个IDE，电脑会卡到飞起。Linux下则可以通过/etc/docker/daemon.json限制容器资源，生产环境建议按需配置：

json复制{
  "default-ulimits": {
    "nofile": {
      "Name": "nofile",
      "Hard": 65536,
      "Soft": 65536
    }
  }
}

5. 第一个实操：用Docker安装MySQL 8.0并跑通连接

5.1 拉取镜像和准备数据目录

装好Docker，光跑hello-world不过瘾。拿一个真实项目练手最有价值，我建议你从MySQL 8.0开始。数据库是后端开发绕不开的基础设施，用Docker装MySQL既能练镜像拉取，又能练容器运行、端口映射、数据卷挂载这些核心操作。

先拉取MySQL 8.0的官方镜像：

bash复制docker pull mysql:8.0

拉镜像的过程中，你会看到很多层的下载进度。Docker镜像是分层存储的，每一层代表文件系统的一次变更。这也是Docker能高效复用镜像空间的原因——同一个基础层，可以被不同镜像共享。

然后准备数据目录。容器是“一次性”的，容器一删，里面的数据就没了。所以要把MySQL的数据文件挂载到宿主机目录，这样删掉容器重建，数据还在：

bash复制mkdir -p /data/mysql/{data,conf,logs}

5.2 运行MySQL容器并理解每个参数

接下来运行容器，这是关键的一步：

bash复制docker run -d \
  --name mysql8 \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -v /data/mysql/data:/var/lib/mysql \
  -v /data/mysql/conf:/etc/mysql/conf.d \
  -v /data/mysql/logs:/var/log/mysql \
  mysql:8.0

逐条解释一下这些参数，理解了它们，你基本就掌握了docker run的核心用法：

-d：后台运行容器，不会占住当前终端。
--name mysql8：给容器起个名字，后续操作都用这个名字，比如docker stop mysql8、docker logs mysql8。
-p 3306:3306：端口映射，格式是“宿主机端口:容器端口”。MySQL在容器内默认监听3306，映射到宿主机3306，这样外部才能通过宿主机IP访问数据库。
-e MYSQL_ROOT_PASSWORD=123456：设置环境变量。这个环境变量是MySQL官方镜像指定的root密码配置。生产环境不要用这么简单的密码。
-v /data/mysql/data:/var/lib/mysql：数据卷挂载，把宿主机目录挂到容器里。冒号左边是宿主机路径，右边是容器路径。这是数据持久化的核心。

等待十几秒，让MySQL完成初始化。用docker ps查看运行状态：

bash复制docker ps

看到状态是“Up”就说明容器在运行。如果容器老是自动退出，用docker logs mysql8查看日志，这是排查容器问题最直接的手段。

5.3 实战验证：连接MySQL并测试数据持久化

容器跑起来后，验证能否正常连接。宿主机上没有安装MySQL客户端也没关系，直接用容器内的客户端：

bash复制docker exec -it mysql8 mysql -uroot -p123456

看到mysql>提示符，说明数据库连接成功。先执行一条SQL测试一下：

sql复制CREATE DATABASE testdb;
USE testdb;
CREATE TABLE user (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50));
INSERT INTO user (name) VALUES ('docker');
SELECT * FROM user;

测试完退出：

sql复制EXIT;

接下来是最能体现Docker价值的操作——验证数据持久化。先把容器删掉，再重新运行一个：

bash复制docker stop mysql8
docker rm mysql8

重新执行上面那个docker run命令（参数一致），然后连进去查看：

bash复制docker exec -it mysql8 mysql -uroot -p123456 -e "SELECT * FROM testdb.user;"

如果能看到之前插入的“docker”记录，说明数据挂载生效了。容器可以随便删，数据稳稳地待在宿主机目录里。这就是用Docker跑数据库的核心价值：基础设施可以随时重建，数据永不丢失。

提示：如果你宿主机上已经装了原生MySQL，再启动容器时端口映射会冲突，提示“bind: address already in use”。解决办法是换宿主机端口，比如-p 3307:3306。

6. 日常高频率使用的容器操作和Compose编排

6.1 容器生命周期管理速查

Docker装好、第一个数据库跑起来之后，日常操作有哪些？这里整理一份高频命令速查表，都是从实际使用中提炼出来的，建议收藏：

操作场景	命令
查看运行中的容器	`docker ps`
查看所有容器（含已停止）	`docker ps -a`
停止容器	`docker stop 容器名或ID`
启动已停止的容器	`docker start 容器名或ID`
重启容器	`docker restart 容器名或ID`
删除容器	`docker rm 容器名或ID`
查看容器日志	`docker logs 容器名或ID`
进入容器交互终端	`docker exec -it 容器名或ID /bin/bash`
查看镜像列表	`docker images`
删除镜像	`docker rmi 镜像名或ID`
构建镜像	`docker build -t 镜像名:标签 .`

用多了你会发现，容器本质上就是一个隔离的进程，管理容器就是在管理进程。docker stop优雅停止，docker kill强制终止，类似服务器的kill和kill -9。

还有一个特别实用的参数，在docker run时加上--restart，可以让容器在宿主机重启后自动拉起：

bash复制docker run -d --name mysql8 --restart unless-stopped mysql:8.0

unless-stopped表示“除非手动停止，否则一直保持运行”。线上环境的数据库、缓存、消息队列，我都建议加上这个参数，省得服务器一重启，所有服务都得手动一个个拉起来。

6.2 用Docker Compose编排多容器服务

单容器用docker run就够，但实际项目往往需要多个容器配合。比如一个Web项目，要MySQL、Redis、Nginx三个服务，一个个docker run能把你累死，而且不好维护。这时候就该上Docker Compose了。

Compose的核心思想是用一个YAML文件描述所有服务，一条命令全部启动。环境准备好之后，新建一个docker-compose.yml：

yaml复制version: '3.8'

services:
  mysql:
    image: mysql:8.0
    container_name: compose-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: 123456
    ports:
      - "3306:3306"
    volumes:
      - /data/compose/mysql:/var/lib/mysql

  redis:
    image: redis:7
    container_name: compose-redis
    restart: unless-stopped
    ports:
      - "6379:6379"
    volumes:
      - /data/compose/redis:/data

启动整个环境只需要一条命令：

bash复制docker compose up -d

-d表示后台运行。查看所有服务状态：

bash复制docker compose ps

停止所有服务：

bash复制docker compose down

这个docker-compose.yml文件就是项目的“部署说明书”，提交到代码仓库里，任何人克隆下来执行docker compose up -d，就能得到一模一样的运行环境。这正是Docker容器化的一大价值：环境标准化。

6.3 把准备好的容器打包成镜像分发

如果说Compose解决的是“多容器怎么编排”的问题，那镜像构建解决的就是“应用怎么分发”的问题。当我们写好一个Spring Boot或Node.js应用后，希望把它打包成镜像，放到任何一台装有Docker的机器上都能跑。这就需要在项目根目录写一个Dockerfile。

拿最常见的Spring Boot项目举例：

dockerfile复制# 基础镜像，使用带JDK的运行环境
FROM openjdk:8-jdk-alpine

# 设置时区
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 把编译好的jar包拷贝到镜像内
COPY app.jar /app.jar

# 声明容器运行时的监听端口
EXPOSE 8080

# 容器启动后执行的命令
ENTRYPOINT ["java", "-jar", "/app.jar"]

构建镜像：

bash复制docker build -t myapp:1.0 .

跑起来：

bash复制docker run -d -p 8080:8080 myapp:1.0

这样你的应用就容器化了。以后不管部署到哪台服务器，只要有Docker环境，docker run一下就能跑起来，不需要再安装JDK、配置环境变量。这个能力在微服务架构里是标配，建议装完Docker后花时间练一练这块。

7. 安装和启动阶段的典型报错排查实录

这一节是从大量安装失败案例里汇总出来的，每一项都对应真实的报错信息，按出现频率排序，建议在看其他教程前先对照排查一遍。

7.1 报错对照速查表

报错场景	核心原因	排查路径
Docker Desktop提示virtualisation support wasn't detected	BIOS里虚拟化未开启	任务管理器查看虚拟化状态，进BIOS开启VT-x/AMD SVM
Docker Desktop一直Starting转圈	WSL2版本不兼容或未初始化	执行`wsl --status`查看状态，`wsl --update`更新内核
We've detected that you have an incompatible version of Windows	系统版本过低	升级Win10到22H2以上，或升级Win11
permission denied while trying to connect to the Docker daemon socket	当前用户不在docker组	执行`sudo usermod -aG docker $USER`，重新登录
error during connect: Failed to connect to the Docker API at npipe:////./pipe/dockerdesktop-linux-en	Docker Desktop没有启动	打开Docker Desktop，等待状态栏变绿
docker pull速度极慢或超时	默认源是Docker Hub海外节点	配置镜像加速器，参照4.1节
docker compose命令找不到	缺少compose插件	安装docker-compose-plugin，或单独下载docker-compose二进制
forman port is already allocated	宿主机端口被占用	换一个宿主机端口映射，比如3306改成3307

7.2 Windows虚拟化问题深入排查

这是一个特别高频的难点，值得展开讲。

“virtualisation support wasn't detected”这个报错，字面意思是“没有检测到虚拟化支持”，但实际触发原因有四种，只看提示很容易误判：

原因一：BIOS虚拟化没开。 在任务管理器“性能 - CPU”里看“虚拟化”状态，如果显示“已禁用”，进BIOS开启。不同主板的设置项名称不同，Intel平台常见的是“Intel Virtualization Technology”或“VT-x”，AMD平台是“SVM Mode”，部分电脑叫“Virtualization Extensions”。开启后保存退出。

原因二：Windows的虚拟机功能没启用。 如果虚拟化状态是“已启用”但Docker还是报错，试试在“启用或关闭Windows功能”里勾选“虚拟机平台”和“适用于Linux的Windows子系统”。这两个功能是WSL2运行的基础，缺一不可。开启后重启电脑。

原因三：WSL2内核版本过旧。 打开PowerShell执行wsl --update，更新到最新内核。这个问题在刚装完WSL2、之后又升级过几次系统的电脑上比较常见，旧内核和新的Docker Desktop版本可能不兼容。

原因四：电脑本身运行在虚拟机里。 如果你是在VMWare或VirtualBox里装的Windows，再往里面装Docker Desktop，虚拟机嵌套很麻烦，很可能怎么配都起不来。这种情况下建议直接在虚拟机里装Linux，再用Linux的Docker Engine，省心得多。

7.3 Docker Desktop启动失败与WSL版本冲突

Docker Desktop老是卡在Starting，这个问题在热词里也有体现，发生率极高。排查步骤按先后顺序排列：

第一步，看WSL是否正常工作。PowerShell里执行：

powershell复制wsl --status

如果提示没有安装发行版，跑一下wsl --install或者至少wsl --set-default-version 2。

第二步，检查WSL内核是否需要更新：

powershell复制wsl --update

第三步，确认Windows功能中“虚拟机平台”已经启用。在PowerShell里执行：

powershell复制Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

如果State显示Disabled，使用管理员权限启用：

powershell复制Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All

第四步，如果上面都正常，重启Docker Desktop。还是不行，就重置WSL相关组件：

powershell复制wsl --shutdown

然后重新启动Docker Desktop。这个方法能解决很多“看似正常但就是起不来”的顽固问题。

注意：wsl --shutdown会关闭WSL环境下所有正在运行的服务，如果里面有重要数据没保存，先保存再执行。

7.4 Linux权限错误与Docker服务状态异常

Linux下最常见的安装后问题是两个：一个是权限报错，一个是服务起不来。

权限报错长这样：

code复制permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock

原因就是当前用户不在docker组里。执行：

bash复制sudo usermod -aG docker $USER

然后退出终端重新登录，或者执行newgrp docker加载新的用户组。这个方法我至少讲了五遍，因为每次帮人排查，十有八九就是这个问题。

服务起不来要分情况。先看服务状态：

bash复制sudo systemctl status docker

如果显示“Active: failed”，再看详细日志：

bash复制sudo journalctl -u docker --no-pager -n 50

日志里常见的错误是iptables相关，比如Failed to start Docker Application Container Engine，原因是Docker默认需要操作iptables规则，而某些云服务器的内核模块没加载。解决办法：

bash复制sudo modprobe iptable_filter
sudo modprobe br_netfilter

然后重启docker。如果是运行在CentOS 7上还有个常见坑——系统自带的firewalld防火墙会干扰Docker的iptables规则，建议把firewalld关掉或者跟Docker和平共处（具体配置较复杂，本地开发环境直接停止firewalld）：

bash复制sudo systemctl stop firewalld
sudo systemctl disable firewalld

7.5 Vmmem内存占用过高的调优方案

Windows下装了Docker Desktop之后，任务管理器里会看到一个叫“Vmmem”的进程，内存越占越大。这个进程本质上是WSL2的虚拟机进程，因为Docker容器里的Linux系统运行在WSL2里，所有内存消耗都会算在Vmmem头上。

解决办法是限制WSL2的内存占用。在Windows用户目录下新建文件.wslconfig，内容如下：

ini复制[wsl2]
memory=4GB
processors=4
swap=2GB

然后执行wsl --shutdown让它生效。设置之后，Vmmem的内存占用会被限制在4GB以内，电脑明显没那么卡了。

我自己的电脑是16G内存，开发时跑四五个容器（MySQL、Redis、Nacos、应用镜像），.wslconfig里配的4GB，实测基本够用。如果你同时跑的服务比较多，可以酌情调到6GB或8GB，但别超过物理内存的一半，否则Windows本体会变得很卡。

7.6 容器启动失败后的三步排查法

容器层面的问题也是一大类。MySQL容器启动后总是退出，或者Web容器怎么都连不上，新手很容易一头雾水。记住这三步排查法，大部分问题都能定位：

第一步，看容器状态和退出码：

bash复制docker ps -a

第二步，看容器日志：

bash复制docker logs 容器名或ID

日志是定位问题的第一来源。MySQL起不来，日志里会直接写清楚是权限问题、配置问题还是初始化失败。

第三步，看容器的配置和挂载目录：

bash复制docker inspect 容器名或ID

这个命令会输出容器的完整配置信息，包括环境变量、挂载情况、网络模式。排查“为什么连不上”“为什么数据没生效”这类问题，基本靠它。

以我自己排查过的一个案例为例：一个开发同学用Docker跑Redis，docker run之后容器秒退，docker logs显示“Can't open the log file: Permission denied”。原因是宿主机数据目录的属主是root，而容器内Redis进程以redis用户运行，没有写权限。解决方法是chown调整目录属主，或者挂载时指定-v /宿主机目录:/data并确保目录权限正确。这种问题在docker inspect里看不出端倪，日志却能一针见血。

写在最后的一点实操体会

我在不同系统上装Docker前前后后折腾了上百次，踩过的坑比教程写出来的多得多。如果只保留几条最有价值的经验分享给刚上路的朋友，我会说：

别跳过前置检查。Windows下至少花两分钟确认三件事——系统版本、虚拟化开关、WSL2状态。这三项没问题，Docker Desktop的安装成功率能超过95%。别小看这些前置检查，我见过的安装失败案例里，九成都是前置条件不满足，而不是安装包本身有问题。

镜像拉不动的时候，先想是不是网络问题，再想是不是配置问题。很多人一遇到docker pull超时，第一反应是重试或者换镜像名，其实改一下镜像加速器配置，大概率直接解决。配置好加速器，Docker的体验会顺畅很多。

容器里跑有状态服务（数据库、缓存），一定要做数据卷挂载。这是我一直强调的习惯。没挂载的容器，删了就什么都没了；挂载之后，容器就是个可以随时替换的“壳”，数据永远在宿主机上。这个理念彻底改变了我的部署方式，希望也能改变你的。

最后，Docker安装在装完那一刻并不是结束，而是开始。后续你会发现，镜像构建、容器编排、服务扩容，每一步都值得琢磨。但这一切都建立在一个稳定运行的Docker环境之上。把环境弄好，后续的路会顺畅很多。