Docker 连接设置

为从 PyCharm 访问 Docker Engine API 指定设置。 有关在 PyCharm 中使用 Docker 集成的更多信息，请参阅 Docker。

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

PyCharm 应能够在默认安装位置自动检测到 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 与 docker compose。

您可以添加多个 Docker 配置，每个配置表示与单独的 Docker 守护进程的连接：

Docker

添加新的 Docker 配置。

删除 Alt+Delete

移除所选 Docker 配置。

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

Docker 适用于 Windows

在 Windows 上使用 Docker Desktop 时，建议使用此选项。

适用于 Mac 的 Docker

在 macOS 上使用 Docker Desktop 时，建议使用此选项。

Unix Socket

在 Linux 上使用 Docker Desktop 时，建议使用此选项。

TCP 套接字

手动配置 Docker Engine API 的 URL。

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

默认情况下，在 macOS 和 Linux 上，Docker 守护进程会在位于 unix:///var/run/docker.sock 的 Unix 套接字上侦听 Docker Engine API 请求。

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

您也可以连接到 Podman ，其 API 与 Docker Engine API 等效。 更多信息请参阅 Podman。

SSH

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

WSL

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

Minikube 中文版

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

如果 PyCharm 无法检测到 minikube，或它在远程运行，请运行 minikube docker-env 命令以获取必要的连接信息，并在 TCP 套接字 下设置以下内容：

• 引擎 API URL： DOCKER_HOST 的值（将协议设为 https ，而非 tcp）

• 证书文件夹： DOCKER_CERT_PATH 的值

虚拟机路径映射

使用 Docker 连接配置选项下方的表来配置本地文件系统与运行 Docker 引擎的虚拟机之间的映射，从而使这些文件可以在容器中作为卷挂载使用。

添加 Alt+Insert

添加新的映射。

移除 Ctrl+Y

移除所选映射。

编辑 Enter

编辑所选映射。

虚拟机路径

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

本地路径

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

PyCharm 仅在 Windows 和 macOS 主机上应用这些映射。独立开发者版本不允许使用此功能。请升级许可证。 默认情况下，该表在 Windows 上将 C:\Users 映射到 /c/Users ，并在 macOS 上将 /Users 映射到 /Users 。 在 服务 工具窗口中为容器配置绑定挂载时，主机路径的文件选择器仅显示此表中的本地文件夹，并且 PyCharm 会将本地路径替换为相应的虚拟机路径。 如果该表为空，PyCharm 会要求先在 Docker 设置中配置路径映射。

添加路径映射

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

1. 在 Docker 连接选项下方的表中，点击 （Alt+Insert）。

2. 在 虚拟机路径 字段中，指定运行 Docker Engine 的虚拟机看到该文件夹时所用的路径。

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

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

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

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

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

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