作为后端开发人员，我们对开发环境的稳定性和磁盘空间利用率有着极高的要求。将 Docker Desktop 安装在 C 盘，往往会导致系统盘迅速爆满，而 WSL2 虚拟磁盘、镜像缓存等文件更是“吞空间”大户。
本文将详细记录我在 Windows 系统 D 盘安装 Docker Desktop 的全过程，涵盖安装报错排查、WSL2 环境修复，以及最终如何将本地镜像推送至 AWS ECR 远程仓库 的完整实战。
一、环境准备与D盘安装命令（核心步骤）
1. 前置依赖开启
Docker Desktop 依赖 WSL2 和虚拟化技术，必须提前配置：
2. D盘专属安装命令
为了避免路径包含空格导致的兼容性问题，我将路径统一修改为 D:\\ProgramFiles\\Docker（无空格），并通过命令行直接安装：
# 确保进入安装包所在目录，或替换为你的实际路径
cd D:\\Downloads
# 一键安装命令（指定D盘路径）
start /w "" "Docker Desktop Installer.exe" install ^
–accept-license ^
—installation-dir="D:\\ProgramFiles\\Docker" ^
—wsl-default-data–root="D:\\ProgramFiles\\Docker\\wsl" ^
—windows-containers-default-data–root="D:\\ProgramFiles\\Docker\\data"
参数说明：
- –installation-dir：Docker 主程序安装目录
- –wsl-default-data-root：WSL2 虚拟磁盘（ext4.vhdx）存放目录，这是空间占用最大的部分
- –windows-containers-default-data-root：Windows 容器数据目录
二、安装报错排查与修复
安装过程中，我遇到了两个典型错误，以下是详细的排查与解决过程。
1. 错误一：Server service 未启用
报错信息：Installation failed. One prerequisite is not fulfilled. Docker Desktop requires the Server service to be enabled. 原因：Windows 的 Server（服务器）服务被禁用或无法启动，Docker 安装时依赖该服务完成网络相关初始化。 解决方法：
sc config lanmanserver start= auto
net start lanmanserver
2. 错误二：WSL2 发行版安装失败
报错信息：Docker Desktop distro installation failed，日志卡在 preparing directory "D:\\\\Program 原因：
wsl —unregister docker-desktop
wsl —unregister docker-desktop-data
三、镜像推送实战：从本地到AWS ECR
环境搭建完成后，下一步就是将开发好的本地镜像推送至远程仓库。这里以 AWS ECR 为例，仓库路径为 hebmanop-ecr-test/kkfileview/kkfileview。
1. 核心概念：镜像标签（Tag）
Docker 推送镜像前，必须为镜像打上符合远程仓库规范的标签。格式为： 远程仓库域名/仓库路径:版本号
2. 完整操作步骤
第一步：登录 AWS ECR
ECR 不支持传统的 docker login 账号密码登录，需通过 AWS CLI 获取临时授权：
第二步：给本地镜像打标签
假设本地镜像名为 kkfileview:latest，目标推送路径为 hebmanop-ecr-test/kkfileview/kkfileview:v1.0：
docker tag kkfileview:latest 123456789012.dkr.ecr.cn-north-1.amazonaws.com/hebmanop-ecr-test/kkfileview/kkfileview:v1.0
第三步：推送镜像
docker push 123456789012.dkr.ecr.cn-north-1.amazonaws.com/hebmanop-ecr-test/kkfileview/kkfileview:v1.0
3. 图形化操作（Docker Desktop）
若不想使用命令行，也可通过 Docker Desktop 完成：
四、总结与避坑指南
通过以上步骤，我成功在 Windows D 盘搭建了稳定的 Docker 环境，并实现了本地镜像到远程仓库的安全推送。希望这篇记录能帮助遇到同样问题的开发者，高效配置开发环境。
