Docker 安装不占 C 盘:自定义路径安装完整教程(含 WSL2)

张开发
2026/4/13 1:12:15 15 分钟阅读

分享文章

Docker 安装不占 C 盘:自定义路径安装完整教程(含 WSL2)
文章目录前言一、安装前准备二、使用步骤1. 启用 WSL 组件并升级2. 准备安装目录3. 将 Ubuntu 安装到自定义文件夹下4. 下载 Docker Desktop 安装器5. 安装 Docker Desktop6. 验证安装结果三、常见问题1. 进入 WSL 出现 localhost 代理提示2. docker 命令找不到3. 数据仍写到 C 盘四、一键命令汇总总结前言本文记录一套在 Windows 11/10 下从零安装 WSL2 和 Docker Desktop 的完整流程。适合人群希望避免 C 盘占满、同时做后端开发如 Node.js/Nest PostgreSQL Docker Compose的同学。文中的路径配置可以根据自己电脑情况动态调整一、安装前准备先用管理员 PowerShell 检查虚拟化支持是否已开启。代码如下systeminfo|findstr/iHyper-V Requirements如果虚拟化相关项显示为 Yes即可继续。如果不是 Yes请先在 BIOS 中开启 Intel VT-x 或 AMD-V。二、使用步骤1. 启用 WSL 组件并升级管理员 PowerShell 执行dism/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart dism/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart执行后重启系统然后继续wsl--install--no-distribution wsl--update wsl--set-default-version 2 wsl--status2. 准备安装目录因为Docker的安装包直接安装不能够自定义安装信息所以我们使用命令行安装。提前准备好对应的文件夹可以根据自己电脑情况动态调整。手懒的可以执行在power shell中执行这个根据自己情况调整文件组织即可New-Item-ItemType Directory-Force E:\VMs\WSL\Ubuntu-24.04|Out-NullNew-Item-ItemType Directory-Force E:\Docker\DockerDesktop|Out-NullNew-Item-ItemType Directory-Force E:\Docker\wsl|Out-NullNew-Item-ItemType Directory-Force E:\Docker\hyperv|Out-NullNew-Item-ItemType Directory-Force E:\Docker\windows-containers|Out-Null3. 将 Ubuntu 安装到自定义文件夹下去官方地址找自己想要的系统版本 官方下载地址# wsl --import Ubuntu-24.04 想要安装的路径 系统安装包所在路径 --version 2wsl--import Ubuntu-24.04 E:\VMs\WSL\Ubuntu-24.04 E:\VMs\WSL\Ubuntu2404-240425.AppxBundle--version 2验证启动wsl-d Ubuntu-24.04然后在 Windows 侧执行wsl--shutdown wsl-d Ubuntu-24.044. 下载 Docker Desktop 安装器代码如下Invoke-WebRequest-Urihttps://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe-OutFileE:\Docker\Docker Desktop Installer.exe5. 安装 Docker Desktop代码如下Start-Process-Wait-FilePathE:\Installers\Docker Desktop Installer.exe-ArgumentList (install,# 执行安装命令--accept-license,# 自动接受许可协议跳过确认步骤--backendwsl-2,# 指定使用 WSL 2 作为容器后端而非 Hyper-V--installation-dirE:\Apps\DockerDesktop,# Docker Desktop 应用程序安装路径--wsl-default-data-rootE:\Docker\wsl,# WSL 2 后端数据存储路径镜像、容器、卷等--hyper-v-default-data-rootE:\Docker\hyperv,# Hyper-V 后端数据存储路径备用--windows-containers-default-data-rootE:\Docker\windows-containers# Windows 容器数据存储路径)注意安装向导中不勾选 Allow Windows Containers只跑 Linux 容器时启动 Docker DesktopStart-ProcessE:\Apps\DockerDesktop\Docker Desktop.exe图形界面建议检查Settings - General勾选 Use the WSL 2 based engineSettings - Resources - WSL Integration开启 Ubuntu-24.046. 验证安装结果代码如下wsl-l-v docker version docker compose version docker info docker run--rmhello-world如果能看到版本信息且 hello-world 正常运行就表示安装成功。三、常见问题1. 进入 WSL 出现 localhost 代理提示提示示例检测到 localhost 代理配置但未镜像到 WSL。这是告警不是报错。可以按需选择忽略多数开发场景可用开启 mirrored 网络关闭 autoProxy 注入示例配置C:\Users\你的用户名.wslconfig[wsl2] networkingModemirrored dnsTunnelingtrue autoProxytrue修改后执行wsl--shutdown2. docker 命令找不到常见原因Docker Desktop 尚未启动或者当前 PowerShell 窗口环境未刷新。处理方式先启动 Docker Desktop再开一个新的 PowerShell 窗口重试。3. 数据仍写到 C 盘重点排查安装命令是否包含 --wsl-default-data-rootDocker Desktop 设置中的磁盘路径是否已应用四、一键命令汇总下面给一份实操版汇总建议分段执行# 1) 启用 WSL 组件dism/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart dism/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart# 2) 安装 WSL 基础能力wsl--install--no-distribution wsl--update wsl--set-default-version 2# 3) 准备目录New-Item-ItemType Directory-Force E:\VMs\WSL\Ubuntu-24.04|Out-NullNew-Item-ItemType Directory-Force E:\Docker\DockerDesktop|Out-NullNew-Item-ItemType Directory-Force E:\Docker\wsl|Out-NullNew-Item-ItemType Directory-Force E:\Docker\hyperv|Out-NullNew-Item-ItemType Directory-Force E:\Docker\windows-containers|Out-Null# 4) 导入 Ubunturootfs 路径按实际文件调整wsl--import Ubuntu-24.04 E:\VMs\WSL\Ubuntu-24.04 C:\Temp\ubuntu-24.04-rootfs.tar.gz--version 2# 5) 下载并安装 Docker DesktopInvoke-WebRequest-Urihttps://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe-OutFileE:\Docker\Docker Desktop Installer.exeStart-Process-Wait-FilePathE:\Docker\Docker Desktop Installer.exe-ArgumentList (install,--accept-license,--backendwsl-2,--installation-dirE:\Docker\DockerDesktop,--wsl-default-data-rootE:\Docker\wsl,--hyper-v-default-data-rootE:\Docker\hyperv,--windows-containers-default-data-rootE:\Docker\windows-containers)总结以上就是 Windows 下安装 WSL2 Docker Desktop并将程序与数据迁移到 E 盘的完整流程。核心点是两条安装 Docker Desktop 时带上路径参数首次启动后检查 WSL Integration 和磁盘设置按本文步骤执行后基本可以避免 C 盘被 Docker 持续占用后续直接进入项目执行 Docker Compose 即可。

更多文章