Windows Server2019上Docker Desktop改镜像路径后无法重启如何解决?
Docker Desktop 4.18.0 修改存储路径后重启卡顿、设置恢复的解决方法
这大概率不是Docker Desktop的普遍Bug,旧版本能正常使用同一路径,说明问题出在新版本的配置逻辑、权限要求或Hyper-V虚拟机迁移流程上,以下是针对性的解决步骤:
解决步骤
1. 完全停止Docker相关服务与进程
打开管理员权限的命令提示符,依次执行以下命令:
net stop docker net stop com.docker.service taskkill /f /im DockerDesktop.exe taskkill /f /im Docker.Service.exe
2. 手动迁移镜像存储文件
将原路径 C:\ProgramData\DockerDesktop\vm-data 下的所有文件(包括隐藏文件)完整复制到目标路径 G:\docker_images,确保复制过程无中断、无文件缺失。
3. 修改Docker Desktop配置文件
找到用户目录下的Docker配置文件:C:\Users\<你的用户名>\.docker\desktop\settings.json,用文本编辑器打开:
- 找到
diskImagePath字段,将其值修改为"G:\\docker_images\\DockerDesktop.vhdx"(注意反斜杠需要转义); - 如果配置文件中没有该字段,直接在合适位置添加:
"diskImagePath": "G:\\docker_images\\DockerDesktop.vhdx"
保存配置文件后关闭编辑器。
4. 配置目标路径的权限
右键点击 G:\docker_images 文件夹 → 属性 → 安全 → 编辑:
- 添加
NT SERVICE\DockerDesktopService用户,授予完全控制权限; - 添加
Hyper-V Administrators用户组,授予完全控制权限;
点击确定保存权限设置。
5. 重置Hyper-V虚拟机(可选,若前几步无效)
打开Hyper-V管理器:
- 找到名为
DockerDesktopVM的虚拟机,确保其处于停止状态; - 删除该虚拟机(无需删除虚拟磁盘,因为已经迁移到G盘);
- 重新启动Docker Desktop,它会自动在新路径创建并配置虚拟机。
6. 验证配置
启动Docker Desktop后,进入资源设置页面,确认「磁盘镜像存储位置」已更新为 G:\docker_images;拉取一个测试镜像(如docker pull nginx),检查G盘目标路径下的文件是否正常更新。
注意事项
- 目标路径必须是本地磁盘,不能是网络共享驱动器或映射盘符;
- 路径名称避免包含中文、空格或特殊字符;
- 首次启动Docker Desktop时建议以管理员身份运行,确保权限生效。
内容的提问来源于stack exchange,提问作者Stefan
相关产品推荐
相关产品推荐

