MSI 常见问题

如果用户拥有旧的 Docker Desktop 安装（即 .exe），用户数据会发生什么？

如果用户拥有旧的 .exe 安装，则必须在使用新的 MSI 版本之前卸载此版本。这会删除所有本地于机器的 Docker 容器、镜像、卷和其他与 Docker 相关的数据，并删除应用程序生成的的文件。对于旧版本，用户应备份他们想要保留的任何容器。

对于 Docker Desktop 4.30 及更高版本的 exe 安装程序，可以使用 -keep-data 标志。它会删除 Docker Desktop，但保留底层数据，例如运行容器的虚拟机。

& 'C:\Program Files\Docker\Docker\Docker Desktop Installer.exe' uninstall -keep-data

如果用户的机器上有旧的 .exe 安装，会发生什么？

新的 MSI 安装程序会检查是否安装了先前版本，并且不会继续安装。相反，它会提示用户先卸载当前/旧版本，然后再尝试安装 MSI 版本。

我的安装失败了，如何找出发生了什么？

MSI 安装有时会意外失败，并且不会向用户提供有关错误原因的太多信息。

要调试失败的安装，请再次运行安装，并启用详细日志记录

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"

安装失败后，打开日志文件并搜索 value 3 的出现。这是 Windows 安装程序在失败时输出的退出代码。在该行上方，您将找到失败的原因。

为什么安装程序在每次全新安装结束时都提示重启？

安装程序提示重启，因为它假设系统已进行了需要重启才能完成配置的更改。

例如，如果您选择 WSL 引擎，安装程序会添加必需的 Windows 功能。安装这些功能后，系统会重启以完成配置，以便 WSL 引擎能够正常运行。

您可以使用 /norestart 选项从命令行启动安装程序来抑制重启

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /norestart