PhpStorm 2025.2 Help

Podman

Podman 是一个无守护进程的容器管理器，可以以 root 或无 root 模式运行容器。 Podman 命令与 Docker 完全兼容，因此您可以互换使用： alias docker=podman。

核心 Podman 运行环境只能在 Linux 操作系统上运行。 不过，您可以使用其他操作系统的 remote client来管理运行 Podman 的机器上的容器。 本主题描述了PhpStorm如何作为Podman的远程客户端。

启用 Docker 插件

此功能依赖于 Docker 插件，该插件在 PhpStorm 中默认捆绑并启用。 如果相关功能不可用，请确保没有禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置，然后选择 Plugins。

  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 变量，其值可用于 从 PhpStorm 或任何其他 Docker 客户端连接到 Podman。 例如：

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

从 PhpStorm 连接到 Podman

有关运行 Podman 的信息，请参见 运行 Podman。

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

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

  3. 选择 Podman ，然后在 Podman 连接 列表中选择 Podman 机器 的名称。

    如果一切正确，您应该会在页面底部看到 连接成功。

如需了解更多信息，请参阅 Docker connection settings。

排查 Podman Linux 连接错误

如果无法建立与 Podman 的连接，PhpStorm 会显示一个错误，指示找到了 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日
    Docker 排错Vagrant