Windows 11下安装Docker并修改安装位置至非C盘教程

一、安装前准备

1.1 检查系统要求

在安装Docker前，需确保Windows 11系统满足以下条件：

  • 系统版本：Windows 11 64位专业版、企业版或教育版（家庭版需通过WSL 2支持）。

  • 硬件要求：支持硬件虚拟化技术（VT-x/AMD-V），并在BIOS/UEFI中启用。

  • WSL 2要求：已安装并启用Windows Subsystem for Linux 2，且内核版本更新至最新。

  • 存储空间：非C盘预留至少20GB空闲空间（用于Docker安装及镜像存储）。

1.2 启用必要功能

打开“控制面板”→“程序”→“程序和功能”→“启用或关闭Windows功能”，勾选以下选项并点击“确定”，等待系统配置完成后重启电脑：

  • Hyper-V（全部组件）

  • 容器

  • Windows虚拟机监控程序平台

若为Windows 11家庭版，需先安装WSL 2：以管理员身份打开PowerShell，输入命令 wsl --install，重启电脑后完成WSL 2安装。

二、下载Docker安装程序

访问Docker官方网站（https://www.docker.com/products/docker-desktop/），点击“Download for Windows”下载最新版Docker Desktop安装包（.exe文件），保存至非C盘的临时文件夹（如D:\Temp）。

三、修改安装位置（已有安装程序时）

3.1 解压安装程序（可选）

若已下载Docker安装包，可通过以下方式查看安装文件结构（非必需步骤）：

  1. 以管理员身份打开PowerShell，切换至安装包所在目录，例如：cd D:\Temp。

  2. 输入命令解压安装包：Docker Desktop Installer.exe extract --destination D:\DockerTemp，将安装文件提取至D:\DockerTemp文件夹。

3.2 通过命令行指定安装路径

这是修改Docker安装位置的核心步骤，需通过命令行参数指定非C盘安装目录：

  1. 以管理员身份打开PowerShell，切换至Docker安装包所在目录（如D:\Temp）。

  2. 输入以下命令，将安装位置指定为非C盘路径（以D:\Docker为例）：
    .\Docker Desktop Installer.exe install --installation-dir=D:\Docker --windows-containers=false --wsl2=true

  3. 命令参数说明：

     `--installation-dir=D:\Docker`：指定Docker主程序安装目录（非C盘路径）。

  4. --windows-containers=false：默认启用Linux容器（如需Windows容器可改为true）。

  5. --wsl2=true：强制使用WSL 2作为容器运行时（推荐）。

  6. 执行命令后，等待安装进度完成，期间可能会提示重启电脑，点击“确定”即可。

若之前已安装过Docker并默认在C盘，需先卸载旧版本：打开“设置”→“应用”→“应用和功能”，找到“Docker Desktop”，点击“卸载”，并删除残留文件后再执行上述命令。

四、验证安装结果

4.1 启动Docker Desktop

安装完成后，在开始菜单中找到“Docker Desktop”并启动，首次启动可能需要几分钟时间（初始化WSL 2环境）。启动成功后，任务栏右下角会显示Docker图标（蓝色鲸鱼图标）。

4.2 检查安装路径

打开文件资源管理器，导航至之前指定的安装目录（如D:\Docker），可看到Docker的主程序文件及相关组件，确认安装位置正确。

4.3 测试Docker功能

以管理员身份打开PowerShell，输入以下命令测试Docker是否正常工作：

  1. 查看Docker版本：docker --version，若输出类似“Docker version 26.1.4, build 5650f9b”则说明版本查询正常。

  2. 运行Hello World镜像：docker run hello-world，若输出“Hello from Docker!”等信息，说明Docker已成功拉取并运行镜像，功能正常。

五、后续配置（可选）

5.1 修改镜像存储位置

默认情况下，Docker镜像存储在WSL 2分发版的虚拟磁盘中（通常位于C盘），可通过以下步骤迁移至非C盘：

  1. 关闭Docker Desktop：右键任务栏Docker图标，点击“Quit Docker Desktop”。

  2. 导出WSL 2分发版：在PowerShell中输入wsl --export docker-desktop-data D:\Docker\wsl\data\docker-desktop-data.tar。

  3. 注销现有分发版：wsl --unregister docker-desktop-data。

  4. 重新导入分发版至非C盘：wsl --import docker-desktop-data D:\Docker\wsl\data D:\Docker\wsl\data\docker-desktop-data.tar --version 2。

  5. 重启Docker Desktop，镜像存储位置即迁移至D:\Docker\wsl\data。

5.2 配置国内镜像源

为加快镜像拉取速度，可配置国内镜像源：打开Docker Desktop，点击“Settings”→“Docker Engine”，在JSON配置中添加镜像源，例如：

1
2
3
4
5
6
7

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker-0.unsee.tech"
  ]
}

点击“Apply & Restart”保存配置并重启Docker。

六、常见问题解决

  • 问题1：安装时提示“Hyper-V未启用”：重新检查“启用或关闭Windows功能”中Hyper-V组件是否全部勾选，若已勾选仍报错，可能是BIOS中虚拟化未启用，需重启电脑进入BIOS开启VT-x/AMD-V。

  • 问题2：Docker启动卡在“Starting…”：关闭Docker后，在PowerShell中输入wsl --shutdown关闭WSL 2，再重新启动Docker。

  • 问题3：命令行输入docker命令提示“command not found”：检查系统环境变量PATH中是否包含Docker安装目录（如D:\Docker\resources\bin），若未包含需手动添加后重启PowerShell。