GoLand 2025.2 Help

Podman

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

Podman 核心运行时环境只能在 Linux 操作系统上运行。 不过，您可以在其他操作系统上使用 remote client 管理运行 Podman 的机器上的容器。 本文介绍 GoLand 如何作为 Podman 的远程客户端。

启用 Docker 插件

此功能依赖于 Docker 插件，该插件默认已在 GoLand 中捆绑并启用。 如果找不到相关功能，请确认并未禁用该插件。

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

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

从 GoLand 连接到 Podman

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

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

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

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

    如果一切设置正确，页面底部将显示 连接成功。

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

排查 Podman Linux 连接错误

如果无法建立与 Podman 的连接，GoLand 会显示一条错误，提示找到了 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 故障排查Kubernetes