Windows系统Docker完整下载安装配置教程

本教程适配Windows家庭版系统，全程手把手完成WSL环境部署、Docker Desktop安装、国内镜像加速配置、资源路径修改，解决安装报错、镜像加载慢等常见问题，步骤简单易落地。

一、前置环境：开启WSL与虚拟机功能

Docker Desktop Windows版本依赖WSL2（适用于Windows的Linux子系统）环境，需先开启系统对应组件：

  1. 打开电脑控制面板，依次进入【程序】-【程序和功能】；
  2. 点击左侧【启用或关闭Windows功能】，等待弹窗加载完成；
  3. 在功能列表中，勾选两项配置：【虚拟机平台】、【适用于Windows的Linux子系统】；
  4. 点击确定，等待组件安装完成，根据系统提示重启电脑，配置方可生效。

二、安装WSL2+Ubuntu子系统

2.1 常规安装步骤

  1. 鼠标右键点击开始菜单，选择【Windows终端(管理员)】或【命令提示符(CMD)】，以管理员身份运行；
  2. 输入命令 wsl --install -d Ubuntu，回车执行，系统将自动下载安装Ubuntu子系统；
  3. 安装完成后会自动弹出Ubuntu终端，根据提示自定义设置用户名和密码（密码输入时不显示，输入完成回车即可）；
  4. 账号密码设置完成后，关闭Ubuntu窗口，回到管理员CMD窗口，输入命令 wsl --update，等待WSL内核更新完成。

2.2 安装报错解决方案

若执行wsl --install出现内核版本不足、安装失败等报错，需手动安装WSL更新补丁：

浏览器访问官方补丁地址：https://wslstorestorage.blob.core.windows.net/wslblob/wsl\_update\_x64.msi，下载.msi安装包，双击默认安装即可；安装完成后重新执行 wsl --install -d Ubuntu 即可正常安装。

三、Docker Desktop下载与安装

  1. 进入Docker官方下载页面：Install Docker Desktop on Windows | Docker Docs，下载Windows版本Docker Desktop安装包；
  2. 双击安装包，默认路径安装（可后续修改资源路径），安装完成后启动Docker Desktop；
  3. 启动后弹出登录界面，直接选择跳过登录，无需注册账号即可正常使用核心功能。

四、配置国内Docker镜像加速

默认国外镜像下载速度极慢，且原大部分公共镜像已失效，下面为大家配置可稳定使用的DaoCloud镜像源，完美适配国内网络，解决拉取镜像超时、失败问题。

  1. 打开Docker Desktop，点击右上角【设置】（齿轮图标）；
  2. 左侧菜单选择【Docker Engine】，清空编辑框内所有原有默认配置；
  3. 复制粘贴以下有效可运行配置代码：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ]
}
  1. 配置粘贴完成后，点击页面右下角【Apply \& Restart】（应用并重启）；
  2. 等待Docker自动重启，重启完成后镜像加速配置生效。

镜像配置说明

经实测，原教程中1panelproxy、华为云、网易、百度、高校镜像、jsdelivr系列镜像均已解析失败/无法访问，仅DaoCloud公共镜像（https://docker.m.daocloud.io）稳定可用。该镜像支持docker.io、gcr.io、ghcr.io、k8s镜像等全品类容器镜像加速，同步及时、延迟低，适配绝大多数使用场景。

使用该镜像无需复杂配置，直接在拉取镜像时添加前缀即可，示例：docker run -d -P m.daocloud.io/docker.io/library/nginx。同时建议尽量使用明确版本号镜像标签，避开latest模糊标签，减少同步延迟问题。

五、修改Docker资源存放路径

Docker默认占用C盘空间，可手动修改路径释放C盘内存：

  1. 在Docker Desktop设置页面，左侧找到【Resources】（资源）选项；
  2. 找到文件存储路径配置项，点击【Browse】浏览；
  3. 自定义选择D盘、E盘等非系统盘路径，新建专属Docker文件夹；
  4. 选择完成后点击应用并重启，Docker后续所有镜像、容器资源将存储在新路径。

六、安装完成验证

管理员CMD中输入 docker --version，若输出版本号则代表安装成功；输入 docker run hello-world，可正常拉取镜像并运行测试容器，说明镜像加速配置生效。