GoLand 2026.3 Help

Docker 连接设置

指定从 GoLand 访问 Docker Engine API 的设置。 有关使用 Docker 集成 GoLand 的更多信息,请参阅 Docker。

启用 Docker 插件

此功能依赖于 Docker插件,该插件默认在 GoLand 中捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

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

  2. 找到 Docker 插件并点击 启用。

您可以指定 GoLand 用于与 Docker 守护进程交互的 Docker CLI 可执行文件的路径。

GoLand 应该能够自动检测到默认安装位置的 Docker CLI 可执行文件。 但是,如果您在自定义位置安装了 Docker,您可能需要手动指定路径。 如果未安装 Docker CLI,可以 直接从 GoLand 下载。

Docker 可执行文件

指定 Docker CLI 可执行文件的基本路径。 默认位置:

macOS 和 Linux

/usr/local/bin/docker

Windows

C:\Program Files\Docker\Docker\resources\bin\docker.exe

Docker Compose 可执行文件

指定 Docker Compose 独立可执行文件的路径。 默认情况下,Compose V2 集成到 Docker CLI 平台中,并通过 docker compose 命令使用相同的可执行文件进行 Docker Compose。

如果您使用的是 Compose V1,主要的 Docker 可执行文件将无法用于 Docker Compose。 在这种情况下,您需要指定 docker-compose 的路径。 欲了解更多信息,请参见 docker-compose vs docker compose。

您可以添加多个 Docker 配置,每个配置代表与单独的 Docker 守护进程的连接:

添加按钮Docker

添加新的 Docker 配置。

"移除"按钮Delete Alt+Delete

删除所选的 Docker 配置。

对于每个 Docker 配置,请指定一个名称,并根据操作系统选择连接类型:

Docker 适用于 Windows ●

当您在 Windows 上使用 Docker Desktop时,这是推荐的选项。

Docker 适用于 Mac ●

这是在 macOS 上使用 Docker Desktop 时的推荐选项。

Unix 套接字

在 Linux 上使用 Docker Desktop 时,这是推荐的选项。

TCP 套接字

手动配置 Docker Engine API 的 URL。

在 引擎 API URL 字段中,您可以指定到远程 Docker 守护进程的 TCP 连接或任何 Docker 套接字路径,包括自定义本地套接字。 例如,在 rootless mode ,Docker daemon 通过具有唯一标识符的 systemd 用户服务运行,因此 socket path 将类似于 unix:///run/user/1000/docker.sock。

默认情况下,在 macOS 和 Linux 上,Docker 守护程序会在 Unix 套接字 unix:///var/run/docker.sock 上监听 Docker Engine API 请求。

如果您使用 Docker Desktop for Windows,您可以通过命名管道在 npipe:////./pipe/docker_engine 或 TCP 套接字在 tcp://localhost:2375 连接到 Docker Engine。

您还可以连接到 Podman ,其 API 等同于 Docker Engine API。 如果您习惯使用特定的配色方案,可以从一个安装中导出该方案,并将其导入到另一个安装中。您还可以与其他开发人员共享配色方案。

SSH

通过现有的 SSH 配置 连接到远程 Docker daemon 或创建一个新的连接。

WSL

连接到在 Windows Subsystem for Linux (WSL) 中运行的 Docker 守护进程。

Minikube

如果您正在运行 minikube ,请选择此选项以自动检测并连接到 minikube 的 Docker Engine 环境。

如果 GoLand 无法检测到 minikube 或者它在远程运行,请运行 minikube docker-env 命令以获取必要的连接信息,并在 TCP socket 下设置以下内容:

  • 引擎 API URL: DOCKER_HOST 的值(使用 https 作为协议而不是 tcp)

  • 证书文件夹},{: DOCKER_CERT_PATH 的值

从 IDE 下载 Docker CLI

GoLand 需要本地 Docker CLI 来构建镜像并运行 Docker Compose,即使连接到远程 Docker 引擎时也是如此。

如果 GoLand 在计算机上找不到 Docker CLI,IDE 会显示 Docker CLI 未安装 通知,并提供下载选项。 相同警告会显示在 Docker 设置页面的顶部。

GoLand 会下载 Docker 提供的以下工具:

  • Docker 命令行界面 29.6.2

  • Docker Buildx 0.35.0

  • Docker Compose 5.3.1

下载的工具不包含 Docker 引擎。 要运行容器,请连接到远程 Docker 引擎,或在计算机上安装一个。

下载的工具存储在 docker-cli 目录中:

macOS

~/Library/Application Support/JetBrains/docker-cli

Windows

%APPDATA%\JetBrains\docker-cli

Linux

~/.local/share/JetBrains/docker-cli

Windows 和 macOS 主机的虚拟机路径映射

Docker 引擎在 Linux 上可以原生运行。 在 Windows 和 macOS 上,Docker 在一个轻量级的 Linux 虚拟机中运行,因此容器只能访问存在于该虚拟机内的文件。

请使用 Docker 连接配置选项下方的表格来配置本地文件系统和运行 Docker 引擎的虚拟机之间的映射,使它们可用于容器中的卷挂载。

添加按钮添加 Alt+Insert

添加新的映射。

"移除"按钮移除 Ctrl+Y

删除所选映射。

Edit 按钮编辑 Enter

编辑所选映射。

虚拟机路径

用于运行此 Docker Engine 的虚拟机中目录的路径。

本地路径

您要映射到虚拟机中相应目录的本地文件夹路径。 您将无法将此文件夹外的任何内容绑定到此 Docker Engine 运行的容器上。

GoLand 仅在 Windows 和 macOS 主机上应用这些映射。 默认情况下,此表在 Windows 上将 C:\Users 映射到 /c/Users ,在 macOS 上将 /Users 映射到 /Users 。 在 服务 工具窗口中为容器配置绑定挂载时,主机路径的文件选择器仅显示此表中的本地文件夹,GoLand 会将本地路径替换为对应的虚拟机路径。 如果此表为空,GoLand 会要求先在 Docker 设置中配置路径映射。

添加路径映射

如果需要从现有映射未涵盖的本地文件夹绑定挂载文件,请添加映射。

  1. 在 Docker 连接选项下方的表中,点击 添加按钮 (Alt+Insert)。

  2. 在 虚拟机路径 字段中,指定运行 Docker 引擎的虚拟机用于查看该文件夹的路径。

  3. 在 本地路径 字段中,指定本地文件夹。

  4. 应用更改并关闭对话框。

假设将绑定挂载到 Docker 容器的所有文件都保存在 /Users/jsmith/docker-share 中。 您可以将此目录映射到虚拟机上的 /dockerShare 以进行 Docker Engine 连接。 此 Docker 引擎会将 /dockerShare 中的文件绑定挂载到容器,因为它可以在此处访问从 /Users/jsmith/docker-share 映射的文件。

这不会对您作为运行容器的用户产生影响,因为您仍然可以配置绑定挂载和卷,作为主机机器上的某些路径与容器内部某些路径之间的映射。 但是,无法挂载映射到虚拟机的目录之外的任何内容。

假设运行一个容器,并将主机上包含应用程序制品的目录 /Users/jsmith/docker-share/out 挂载到容器中的 /usr/local/tomcat/webapps 。 在这种情况下,Docker 引擎实际挂载的是 /dockerShare/out ,因为它可以通过虚拟机映射在此处访问你的文件。

虚拟机运行 Docker Engine 的路径映射

有关卷和绑定挂载的更多信息,请参阅 在 Docker 中管理数据。

2026年 11月 9日