WebStorm 2025.2 Help

Podman

Podman 是一款无守护进程的容器管理器,可在特权或非特权模式下运行容器。 Podman 命令与 Docker 完全兼容,因此可以相互替换: alias docker=podman

Podman 的核心运行环境只能在 Linux 操作系统上运行。 不过,您可以在其他操作系统上使用 远程客户端 来管理运行 Podman 的设备上的容器。 本文将介绍 WebStorm 如何作为 Podman 的远程客户端运行。

启用 Docker 插件

此功能依赖于 Docker 插件,默认情况下 WebStorm 会捆绑并启用该插件。 如果相关功能不可用,请确保未禁用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Docker 插件,并勾选插件名称旁边的复选框。

运行 Podman

从 Podman 3.2.0 版本开始,您可以使用 podman machine 命令集来运行包含 Podman 的虚拟机。

  1. 安装 Podman

  2. 初始化新虚拟机:

    podman machine init --rootful=true

    如需了解详细信息,请参阅 podman machine init

  3. 启动 Podman 虚拟机:

    podman machine start

    如需了解详细信息,请参阅 podman machine start

如果成功,输出中将包含 Podman API 的 URL 和 DOCKER_HOST 变量,您可以使用该变量 从 WebStorm 或其他 Docker 客户端连接到 Podman。 例如:

unix:///var/folders/3p/qnvz_wss4g32qcwxcmvsk70c0000gp/T/podman/podman-machine-default-api.sock

从 WebStorm 连接到 Podman

有关运行 Podman 的信息,请参见 运行 Podman

  1. Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | Docker

  2. 点击 添加按钮 添加 Docker 配置。

  3. 选择 Podman ,然后在 Podman 连接 列表中选择 Podman machine 的名称。

    如果一切正确,您将在页面底部看到 连接成功

如需了解更多信息,请参阅 Docker 连接设置

排查 Podman Linux 连接错误

如果无法连接到 Podman,WebStorm 将显示错误,指出已找到 Podman 可执行文件,但无法连接到 Podman 套接字。

您可以参考 Podman 文档 以获取更多详细信息,并使用以下步骤排查问题:

配置 systemd 套接字,使其在重启后自动启动,并以指定用户身份运行:

systemctl --user enable podman.socket loginctl enable-linger <USER>

以 root 身份启动服务的 systemd 套接字:

sudo systemctl start podman.socket

配置套接字使其在重启后自动启动:

sudo systemctl enable podman.socket
    最后修改日期: 2025年 9月 26日