Docker Desktop Windows安装后如何修改默认的容器存储路径？

Question

在Docker Desktop for Windows安装后，默认的容器存储路径位于C盘的用户目录下（如 C:\Users\<用户名>\AppData\Local\Docker）。然而，当磁盘空间有限时，可能需要修改默认存储路径。如何更改这一路径成为许多用户常见的技术问题。 解决方法如下：首先关闭Docker Desktop，然后通过WSL2子系统手动调整Docker的镜像存储位置。编辑WSL配置文件（/etc/wsl.conf），添加`[wsl2]`部分并指定新的存储路径，例如`storageAccount = D:\WSL2\docker-data`。之后重启WSL2子系统以应用更改。注意，此操作需确保新路径已存在且具备写入权限。此外，另一种方式是通过迁移Docker Desktop的数据目录实现，但过程较复杂，需备份和恢复数据。

Answer 1

1. 问题背景与分析

Docker Desktop for Windows 安装后，默认的容器存储路径位于 C 盘的用户目录下（如 C:\Users\<用户名>\AppData\Local\Docker）。然而，C 盘通常是系统盘，磁盘空间有限，可能导致存储不足的问题。因此，许多用户需要修改默认存储路径。

为解决这一问题，我们可以从以下两个方面进行分析：

• WSL2 子系统的配置调整：Docker Desktop 使用 WSL2 作为后端运行环境，因此可以通过修改 WSL2 的存储路径来间接改变 Docker 的镜像存储位置。
• 迁移 Docker Desktop 数据目录：直接将 Docker Desktop 的数据目录迁移到其他磁盘或分区。

2. 解决方案一：通过 WSL2 调整存储路径

以下是基于 WSL2 子系统的解决方案步骤：

1. 关闭 Docker Desktop，确保其完全停止运行。
2. 打开 PowerShell 或命令提示符，输入以下命令以编辑 WSL 配置文件：

notepad.exe %UserProfile%\.wslconfig

如果文件不存在，请手动创建并添加以下内容：

[wsl2]
storageAccount = D:\WSL2docker-data
    

确保新路径 D:\WSL2docker-data 已经存在，并且具备写入权限。

重启 WSL2 子系统以应用更改：

wsl --shutdown

3. 解决方案二：迁移 Docker Desktop 数据目录

另一种方式是通过迁移 Docker Desktop 的数据目录实现存储路径的更改。此方法较为复杂，具体步骤如下：

步骤	操作说明
1	关闭 Docker Desktop 并备份当前数据目录（如 C:\Users\<用户名>\AppData\Local\Docker）。
2	在目标磁盘上创建新的数据目录（如 D:\DockerDesktopData）。
3	使用符号链接将旧路径指向新路径：
mklink /J "C:\Users\<用户名>\AppData\Local\Docker" "D:\DockerDesktopData"

4. 技术流程图

以下是两种解决方案的技术流程图：

或者使用 Mermaid 格式表示：

graph TD;
    A[开始] --> B{选择方案};
    B -->|方案一| C[修改 WSL2 配置];
    B -->|方案二| D[迁移 Docker 数据目录];
    C --> E[编辑 wsl.conf 文件];
    D --> F[创建符号链接];
    E --> G[重启 WSL2 子系统];
    F --> H[完成迁移];