Docker安装

安装前必看:系统要求

  • Windows 10 21H2及以上版本 / Windows 11 所有版本
  • CPU至少2核4G内存,推荐8G以上内存
  • 必须开启CPU虚拟化(下文会教怎么看)

一、第一步:开启CPU虚拟化(不开启直接报错)

Docker依赖虚拟机技术,必须先确认CPU虚拟化已开启,否则安装完也启动不了:

  1. Ctrl + Shift + Esc 打开任务管理器
  2. 切换到【性能】→【CPU】,看右侧是否显示虚拟化:已启用

在这里插入图片描述

  • ✅ 已启用:直接进入下一步
  • ❌ 已禁用:重启电脑,开机时按对应快捷键进入BIOS开启VT/虚拟化技术
  1. 不同品牌电脑进入BIOS快捷键:

    品牌 快捷键 品牌 快捷键
    联想(台式/笔记本) F12 / F2 惠普 F10 / Esc
    戴尔 F2 华硕/微星 Del / F2
    华为/荣耀 F2 其他品牌 开机看屏幕提示,一般是F2/F10/Del
  2. 进入BIOS后找到「VT-x」「Virtualization Technology」「SVM Mode」选项,设置为Enabled,保存重启即可。

额外前置:开启WSL2功能(没开的必做)

Docker Desktop 默认用WSL2作为底层,比Hyper-V速度快30%以上,兼容性更好,先手动开启系统功能:

  1. Win + X 选择Windows终端(管理员) / PowerShell(管理员)
  2. 执行以下命令,执行完会提示重启电脑:
1
2
3
# 开启WSL和虚拟机平台功能
wsl --install
运行项目并下载源码powershell12

如果命令执行失败,也可以手动开:控制面板→程序→启用或关闭Windows功能→勾选「适用于Linux的Windows子系统」和「虚拟机平台」,确定后重启电脑。


二、下载并安装Docker Desktop

1. 官方下载地址(附国内加速镜像)

Docker官网下载速度很慢,推荐用阿里云镜像站下载,速度拉满:

下载渠道 地址 适用场景
官方地址 https://www.docker.com/products/docker-desktop/ 网络好的用户(可迅雷加速)
  1. 选择对应架构的安装包:
    • 普通Intel/AMD电脑:选 Docker Desktop Installer.exe(amd64版本)
    • 新款ARM架构轻薄本(比如华为MateBook E、高通CPU笔记本):选arm64版本
    • 不确定架构?按 Win + X → 系统 → 查看【系统类型】,显示基于x64的处理器就选amd64。
      在这里插入图片描述

2. 安装步骤(避坑重点)

  1. 双击下载好的安装包,首先会让你选安装路径:不要默认装C盘,改成D盘路径比如D:\Docker,避免后续占C盘空间。
  2. 到关键配置页面,必须勾选:
    • Use WSL 2 instead of Hyper-V(必选,Win11家庭版没有Hyper-V,选这个才不会报错)
    • ❌ 不要勾选「使用Windows容器」,兼容性很差
      在这里插入图片描述
  3. 等待安装完成,按照提示重启电脑
  4. 社区版以上是默认选项,可跳过此步骤直接安装。

三、首次启动与WSL升级

重启后打开Docker Desktop,首次启动会初始化1-2分钟:

  1. 首先弹出用户协议,勾选同意后下一步,遇到登录页面直接点右上角叉号跳过,本地使用完全不需要注册Docker账号,不要浪费时间。
  2. 如果弹出「WSL 2版本过低,请升级」的提示:
    • 重新打开管理员PowerShell,执行命令:wsl --update
    • 等待更新完成后重启Docker即可
    • 如果在线更新失败,去下载微软官方WSL2内核安装包手动安装:https://github.com/microsoft/WSL
  3. 验证是否安装成功:打开PowerShell执行 docker --version,返回版本号说明安装成功,再执行 docker run hello-world,如果输出欢迎信息说明Docker可以正常拉取镜像运行。

四、Docker Desktop 汉化(英文界面救星)

Docker默认全英文界面对新手很不友好,我们可以用开源汉化补丁替换实现中文界面,完全免费无广告:

  1. 完全退出Docker:右下角托盘找到小鲸鱼图标→右键→Quit Docker Desktop,一定要完全退出再操作,否则替换失败。
  2. 下载对应版本的汉化补丁:
  3. 解压汉化包:解压后,你会得到一个文件夹,里面包含app.asarapp.asar.unpackedDocker Desktop.exe三个文件
  4. 找到Docker安装目录:右键桌面Docker图标→属性→打开文件所在位置,默认路径是C:\Program Files\Docker\Docker\resources(如果装在D盘就是对应路径的resources目录)
  5. 找到目录里原来的app.asar文件,先重命名为app原文件.asar备份,万一汉化失败可以改回来还原。
  6. 备份并替换三个文件:导航到C:\Program Files\Docker\Docker\frontend\resources目录,将原版的app.asarapp.asar.unpacked备份。然后,将汉化包里的这三个文件,分别覆盖到对应的位置
    • app.asar -> frontend\resources\app.asar
    • app.asar.unpacked -> frontend\resources\app.asar.unpacked
    • Docker Desktop.exe -> Docker\Docker Desktop.exe (即上一级目录)
  7. 重新启动Docker,界面就变成中文了。

五、配置数据目录,完全不占C盘

Docker默认把镜像、容器、虚拟磁盘全部存在C盘,用一段时间可能占几十G,按照下面两步彻底迁移到D盘:

第一步:修改Docker磁盘镜像位置(适用于刚下载)

  1. 打开Docker→右上角点击【设置】(齿轮图标)
  2. 进入【资源】→【高级】,找到【磁盘镜像位置】
  3. 在D盘新建一个文件夹,比如D:\docker_data\docker-desktop
  4. 选择这个路径,点击【应用并重启】,等待Docker自动迁移数据,不要中途关闭。

第二步:迁移WSL虚拟磁盘(可选,彻底解决C盘占用)

很多用户改了上面的设置还是发现C盘变小,是因为WSL的默认虚拟磁盘还在C盘,按照下面步骤迁移:

关闭Docker,打开管理员PowerShell,执行以下命令查看WSL列表:

1
wsl --list --verbose

导出WSL镜像到D盘:

1
wsl --export docker-desktop-data D:\docker_data\docker-desktop-data.tar

注销原来的WSL镜像:

1
wsl --unregister docker-desktop-data

重新导入镜像到D盘:

1
wsl --import docker-desktop-data D:\docker_data\wsl D:\docker_data\docker-desktop-data.tar --version 2

重启Docker即可,以后所有数据都存在D盘,完全不占C盘空间。


六、配置国内镜像源 ,下载速度拉满

Docker官方镜像源在国外,国内下载镜像经常几KB/s甚至失败,必须配置国内镜像源,2026年最新可用的镜像源整理如下:

  1. 打开Docker设置→选择【Docker引擎】,在配置文件中添加镜像地址,完整配置如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn", // 中科大镜像
"https://hub-mirror.c.163.com", // 网易镜像
"https://mirror.baidubce.com", // 百度镜像
"https://你的阿里云加速地址.mirror.aliyuncs.com" // 推荐加自己的阿里云加速器,速度最快
]
}
运行项目并下载源码json123456789101112131415
  1. 阿里云加速器获取方式:打开https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors,登录阿里云账号就能拿到专属的加速地址,免费不限速。
  2. 点击【应用并重启】,重启后执行 docker info,看输出里的Registry Mirrors部分有没有你加的地址,有就说明配置生效了。

七、Docker 基础使用(以运行n8n自动化工具为例)

学会下面几步,几乎所有Docker镜像你都能跑起来,再也不用看复杂的部署文档。

核心概念30秒搞懂

  • 镜像(Image):相当于软件安装包,比如n8n、MySQL的安装包
  • 容器(Container):运行起来的软件实例,相当于安装好启动的软件
  • 卷(Volume):数据持久化目录,把容器内的数据映射到本地电脑,删除容器数据不会丢

图形化运行n8n示例

  1. 在Docker顶部搜索框输入n8n,选择官方镜像n8nio/n8n,点击【运行】
  2. 配置参数:
    • 容器名称:自定义,比如n8n
    • 端口映射:本地端口填5678,容器端口填5678
    • 卷:本地文件夹选D:\docker_data\n8n,容器路径填/home/node/.n8n(数据存在本地,不会丢失)
  3. 点击运行,等待1分钟启动完成,浏览器打开http://localhost:5678就能进入n8n面板了。

命令行运行(更快捷,复制就能用)

直接打开PowerShell执行以下命令,和图形化操作效果一样:

1
2
3
4
5
6
docker run -d \
--name n8n \
-p 5678:5678 \
-v D:/docker_data/n8n:/home/node/.n8n \
n8nio/n8n
运行项目并下载源码bash12345

常用基础命令(收藏备用)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 查看所有运行中的容器
docker ps
# 查看所有容器(包括停止的)
docker ps -a
# 停止容器
docker stop 容器名/容器ID
# 启动已停止的容器
docker start 容器名/容器ID
# 删除容器
docker rm 容器名/容器ID
# 下载镜像
docker pull 镜像名
# 查看本地所有镜像
docker images
# 删除本地镜像
docker rmi 镜像名
运行项目并下载源码bash12345678910111213141516

八、2026最新常见问题解决方案

1. Docker启动报错/闪退(尤其是Win11家庭版)

  • 首先检查虚拟化是否开启,WSL2是否安装正确
  • 执行wsl --update升级WSL内核到最新版
  • 打开Docker设置→资源→WSL集成,确保Ubuntu的开关是打开的
  • 还是闪退的话,卸载重装WSL:wsl --unregister Ubuntu然后重新安装

2. 镜像拉取慢/报错connection reset

  • 检查镜像源是否配置正确,执行docker info确认镜像源生效
  • 不要开全局代理,Docker走系统代理会导致拉取失败,要么关代理,要么在Docker设置里配置代理地址
  • 换个镜像源试试,优先用自己的阿里云加速器

3. 端口被占用报错

  • 执行netstat -ano | findstr "端口号"找到占用端口的进程ID
  • 打开任务管理器→详细信息,找到对应ID的进程杀掉,或者换个本地端口

4. Docker占用内存/CPU太高

  • 在用户目录(C:\Users\你的用户名)新建.wslconfig文件,写入以下配置限制WSL内存:
1
2
3
4
5
[wsl2]
memory=4GB # 最多用4G内存,根据自己电脑配置改
processors=2 # 最多用2核CPU
swap=2GB
运行项目并下载源码ini1234
  • 保存后执行wsl --shutdown重启WSL即可生效

5. 汉化后启动失败

  • 把之前备份的app.asar改回app.asar替换回去,说明汉化补丁版本和Docker版本不匹配,下载对应版本的补丁即可。