跳转到主内容

Windows 上 Podman 的故障排除

你可以在这里找到针对 Windows 特定问题的故障排除帮助。

删除损坏的 Podman Machine​

问题​

  1. 你无法停止你的 Podman Machine。

    $ podman machine stop

  2. 日志包含此错误

    Error: Error stopping sysd: exit status 1

权宜之计​

  1. 要显示活动的 Windows Subsystem for Linux (WSL) 发行版列表：在终端中，运行

    $ wsl --list

  2. 该命令返回活动的 WSL 发行版列表。在列表中识别你的 Podman Machine，例如 podman-machine-default。

  3. 要停止并卸载你的 Podman Machine：在终端中，将 podman-machine-default 替换为你的 Podman Machine 名称，然后运行

    $ wsl --unregister podman-machine-default

其他资源​

从命令行启动时，终端会话会附加到 Podman Desktop​

问题​

  1. 当你在 Windows 中从命令行启动 Podman Desktop 时，终端会话会附加到它上面。
  2. 当你退出终端时，它会终止 Podman Desktop。

解决方法​

  • 在启动 Podman Desktop 之前，将环境变量 ELECTRON_NO_ATTACH_CONSOLE 设置为 true。

当主机位于 VPN 后面时，Podman 无法访问网络资源​

当主机位于 VPN 后面时，Podman 可能无法访问网络资源，并显示诸如“名称解析暂时失败” (Temporary failure in name resolution) 之类的错误。

解决方案​

请参阅在 Windows 上使用 Podman 访问 VPN 后的资源。

较旧的 WSL 版本可能导致网络问题​

较旧版本的 WSL 可能会导致网络问题，例如 Get-NetTCPConnection 错误，这表明 WSL 环回转发功能未正常工作。最新版本的 WSL 没有此问题。

解决方案​

  1. 将 Windows 更新到 Windows 10 的 21H1、21H2 或 22H2 版本，或者 Windows 11 的 21H1 或更高版本。

  2. 更新 WSL

    wsl --update

  3. 或者，删除你的 Podman machine，然后创建一个新的。

Windows 10 Enterprise LTSC 21H2 版本：Podman Desktop 无法检测到 WSL2 machine​

在 Windows 10 LTSC 版本上，运行 wsl --install --no-distribution 命令不起作用，并且 Podman Desktop 安装过程不顺畅。

你必须安装一个特定的 Windows Subsystem for Linux (WSL) 发行版，以使 Podman Desktop 安装过程能够顺利运行。设置好 Podman Desktop 后，你可以卸载该 WSL 发行版。

解决方案：使 Podman Desktop 安装过程顺利运行​

Windows 11 或更高版本

  1. 运行 wsl --update 命令更新 WSL 内核。
  2. 运行 wsl --install --no-distribution 命令，不安装任何 WSL 发行版。
  3. 重启你的机器。

Windows 10 LTSC 版本

  1. 运行 wsl --update 命令。
  2. 运行 wsl --install -d <distro> 命令安装一个特定的 WSL 发行版。
    • 将 distro 替换为任何官方 WSL 发行版，例如 ubuntu-24.04。
  3. 重启你的机器。
  4. （可选）：运行 wsl --unregister <distro> 卸载 WSL 发行版。

由于证书签名失败，无法在 Windows 上安装 Compose 扩展 2.33.x​

安装 Compose 扩展 2.33.x 版本失败，并收到错误消息：Unable to fetch the available extensions: certificate signature failure（无法获取可用扩展：证书签名失败）。

解决方法​

失败的原因可能是 Windows 证书存储区加载企业证书链不当。通常，所有证书都放在一个位置，即 TrustedRootCA，这导致无法将证书导入到 Podman Desktop 应用程序中。

要使根 CA 自签名证书正常工作，你可以确定这些证书在 Windows 证书存储区中的位置。然后，你可以清理存储区，以确保这些证书位于其正确的位置。