### PyCharm 使用 SSH 配置远程 Docker 环境教程及解决方案 #### 1. 远程服务器准备 确保远程服务器已安装 Docker（建议版本为 19.03 或更高，以兼容 PyCharm 的 Buildx 插件）。通过以下命令检查 Docker 守护进程是否正在运行： ```bash systemctl status docker ``` 此外，确保服务器开放了 SSH 端口（默认为 22），并拥有有效的 SSH 访问权限（用户名/密码或密钥文件）[^1]。 #### 2. 创建 Docker 容器并配置端口映射和文件夹挂载 在远程服务器上启动一个带有端口映射的 Docker 容器，并将本地文件夹挂载到容器中。例如： ```bash docker run --gpus all -d -p 7004:22 -it --name scgpt -v /data/wang/scgpt:/works de606c8c8d2d /bin/bash ``` 此命令将远程服务器上的 `/data/wang/scgpt` 文件夹挂载到容器内的 `/works` 目录，并将容器内的 SSH 服务映射到主机的 7004 端口[^3]。 #### 3. 在 PyCharm 中配置 SSH 连接 在 PyCharm 中，通过 SSH 配置远程开发环境： - 打开 **File > Settings > Build, Execution, Deployment > Deployment**。 - 添加一个新的 SSH 连接，输入远程服务器的 IP 地址、SSH 端口（通常为 22）、用户名和私钥路径。 - 在 **Mappings** 中，将本地文件夹与远程服务器上的项目目录进行映射。例如，将本地的 `C:\Projects\scgpt` 映射到远程服务器的 `/data/wang/scgpt`[^5]。 #### 4. 配置 Docker 解释器 - 打开 **File > Settings > Project: <YourProject> > Python Interpreter**。 - 点击齿轮图标，选择 **Add...**，然后选择 **SSH Interpreter**。 - 指定之前配置的 SSH 连接，并选择容器内的 Python 解释器路径（例如 `/usr/bin/python`）。 - 确保 PyCharm 能够正确加载远程容器中的解释器和依赖项。 #### 5. 解决无法连接到远程 Docker 守护进程的问题 如果遇到无法连接到远程 Docker 守护进程的问题，可以按照以下方法排查： - 确保 Docker 守护进程已配置为监听 TCP 端口（如 2375）。修改 `/etc/docker/daemon.json` 文件，添加以下内容： ```json { "hosts": ["tcp://0.0.0.0:2375", "unix:///var/run/docker.sock"] } ``` 然后重启 Docker 服务： ```bash systemctl restart docker ``` - 如果使用 TLS 加密连接，确保客户端和服务器之间已交换正确的证书和密钥[^1]。 - 检查防火墙规则，确保允许入站流量到达指定的 Docker TCP 端口（如 2375）。 #### 6. 示例代码：通过 API 调用远程 Docker 守护进程 以下是一个使用 Python 和 `docker-py` 库连接远程 Docker 守护进程的示例： ```python import docker client = docker.DockerClient(base_url='tcp://<remote-ip>:2375') containers = client.containers.list() for container in containers: print(container.name) ``` #### 7. 常见问题及解决方法 - **问题：Docker 守护进程未响应。** - 检查守护进程状态：`systemctl status docker`[^1]。 - 确保配置文件 `/etc/docker/daemon.json` 中的 `hosts` 参数正确。 - **问题：SSH 连接失败。** - 确认 SSH 密钥路径是否正确。 - 检查服务器的 SSH 服务是否正常运行：`systemctl status sshd`[^5]。 ---