Docker 连接设置

指定从 WebStorm 访问 Docker Engine API 的设置。 有关将 Docker 集成与 WebStorm 搭配使用的更多信息，请参阅 Docker。

您可以为 WebStorm 与 Docker 守护进程交互时使用的 Docker CLI 可执行文件指定路径。

WebStorm 应能够自动检测默认安装位置中的 Docker CLI 可执行文件。 但是，如果您将 Docker 安装在自定义位置，则可能需要手动指定路径。

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 配置。

删除 Alt+Delete

移除所选 Docker 配置。

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

Docker for Windows

如果使用 Windows 的 Docker Desktop ，这是推荐选项。

Docker for Mac

如果使用 macOS 的 Docker Desktop ，这是推荐选项。

Unix 套接字

如果使用 Linux 的 Docker Desktop ，这是推荐选项。

TCP 套接字

手动配置 Docker Engine API 的 URL。

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

默认情况下，在 macOS 和 Linux 上，Docker 守护进程在 unix:///var/run/docker.sock 处监听来自 Docker Engine API 的请求。

如果使用 Windows 的 Docker Desktop ，可以通过位于 npipe:////./pipe/docker_engine 的命名管道或位于 tcp://localhost:2375 的 TCP socket 连接到 Docker Engine。

您也可以连接到 Podman ，它的 API 与 Docker Engine API 等效。 。

SSH

通过现有的 SSH configuration 来连接远程 Docker 守护进程，或者创建一个新的。

WSL

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

Minikube

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

如果 WebStorm 无法检测到 minikube 或其在远程运行，请运行 minikube docker-env 命令获取所需的连接信息，并在 TCP socket 下设置以下内容：

• 引擎API URL： DOCKER_HOST 的值（协议使用 https ，而不是 tcp）

• 证书文件夹： DOCKER_CERT_PATH 的值

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

Docker Engine 原生运行在 Linux 上，因此可以将 Linux 主机上的目录和文件直接挂载到容器中。 Windows 或 macOS 上的 Docker 主机使用带有 Linux 的轻量级虚拟机来运行 Docker Engine。 请使用 Docker 连接配置选项下方的表格来配置本地文件系统与运行 Docker Engine 的虚拟机之间的路径映射。

添加 Alt+Insert

添加新映射。

移除 Ctrl+Y

移除所选映射。

编辑 Enter

编辑所选映射。

虚拟机路径

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

本地路径

要映射到虚拟机中对应目录的本地文件夹路径。 您将无法将此文件夹以外的任何内容绑定挂载到由此 Docker 引擎运行的容器中。

例如，假设您将所有要绑定挂载到 Docker 容器的文件保存在 /Users/jsmith/docker-share 中。 您可以将该目录映射到 Docker 引擎连接所使用虚拟机上的 /dockerShare 。 此 Docker 引擎会从 /dockerShare 绑定挂载文件到容器中，因为它只能从该路径访问您从 /Users/jsmith/docker-share 映射的文件。

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

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

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