Pycharm远程连接Linux服务器上的Docker项目进行开发调试-详细教程

目录

一、Docker端

1.1 添加端口

首先通过

​​​​​sudo docker ps

查看你的容器是否正在运行
如果你的容器正在运行中并且在启动时并未添加 2222:22的端口映射，
则需要停止，删除容器实例（建议先通过

docker commit <container_id_or_name> <repository_name>:<tag>

提交保存，以免造成内容丢失），然后重新创建容器实例

sudo docker run --name <container_id_or_name> -p 2222:22 <Image_name>

1.2 安装依赖

进入容器的交互式命令行

sudo docker exec -it <container_id_or_name> /bin/bash

，安装所需的包

apt-get update
apt-get install vim
apt-get install openssh-server

1.3 修改配置文件

为root用户设置密码

passwd root

修改配置文件

vim /etc/ssh/sshd_config

确保配置文件中有以下配置，如果没有则添加进去

PermitRootLogin yes
PasswordAuthentication yes

然后重启服务

service ssh restart

二、服务器端

服务器是指运行Docker容器的宿主服务器

2.1 测试连接

ssh root@<服务器IP> -p 2222

成功连接

2.2 配置 Docker 守护进程通过 TCP 进行通信

默认情况下，Docker 只监听 Unix 套接字文件 (

/var/run/docker.sock

)。我们需要配置 Docker 使其通过 TCP 进行监听，这样 PyCharm 才能连接到 Docker 守护进程

sudo vim /lib/systemd/system/docker.service

找到 ExecStart 所在行，修改为

ExecStart=/usr/bin/dockerd -H fd:// -H tcp://0.0.0.0:2375

这里我们添加了

-H tcp://0.0.0.0:2375

以使 Docker 守护进程监听所有接口上的 2375 端口。

重新加载配置

sudo systemctl daemon-reload
sudo systemctl restart docker

二、Pycharm端

2.1 在 PyCharm 中配置 Docker

在 PyCharm 中配置 Docker 连接（Professional版本）：

• 打开 Settings 或 Preferences
• 导航到 Build, Execution, Deployment -> Docker
• 点击加号 + 添加一个新的 Docker 服务器

2.2 配置 TCP 连接信息

• 添加 TCP 连接点击加号 +，选择 TCP socket。
• 填写 TCP 连接信息- Engine API URL: tcp://<your_server_ip>:2375，注意这里的端口好和之前配置信息的里要对应- Certificates folder: 如果你没有配置 TLS，可以留空

可以从最下面看到，Connection successful,表示连接成功了

2.3 添加SSH解释器

点击更多，添加已经存在的ssh server

输入Host(Docker宿主的服务器ip)，username就是root，Port和1.1里暴露的宿主机的端口对应，本文中为'2222'，密码是之前设置的root密码，然后点击Apply -> OK

然后依次点击Next，到了3/3步骤，这里非常关键，会有一点复杂，建议自己实际动手在Docker里看一下项目路径。
我用的是Minconda环境，但是右边不选Conda Environment， 要选第一个Virtual Environement
选择Existing，Interpreter选到Docker容器里的conda虚拟环境里bin目录下的python
建议勾上'Excute code with root privileges via sudo'，以sudo权利执行代码（笔者截图时忘了打勾）

    然后是设置Sync folders：Sync folders中填写本地的文件夹（或者新建一个临时文件夹）和docker容器中哪个文件夹建立联系，因为pycharm远程的原理是将远程的Py文件下载到本地修改，然后在运行和调试时发送到远程去执行。注意，这里的远程和本地分别置docker容器和宿主机。

我这里在本地新建了临时文件夹，用于同步Docker容器上的项目文件夹

设置完成之后就能看见远程的解释器了

2.4 打开远程项目

远程环境至此已经配置好了，在状态栏中选择Tools->Deployment->Browse Remote Host
绿色的文件夹则表示建立联系的项目文件夹，可以右键选择'下载到本地'或者'与本地同步'。

如果点开正确的路径，发现文件夹没有变成绿色，那可能是因为你重新打开一个Pycharm window，需要在Mappings里面设置一下Docker 容器的项目路径即可