Pycharm连不上虚拟机时,多数问题出在VMware的网卡模式选错、虚拟机IP地址配置与Pycharm的SSH连接信息不一致,或者虚拟机的SSH服务根本没启动。这篇文章按排查顺序拆解每个环节,帮你快速定位是哪一步出了问题。
pycharm连不上虚拟机常见原因排查:先从VMware网络模式入手
Pycharm访问虚拟机的本质是走SSH协议,底层依赖虚拟机与宿主机之间的网络连通性,在绝大多数Windows环境下,虚拟机使用的是VMware Workstation,而网络连接方式的设置直接决定了虚拟机的IP地址是否能在宿主机上被访问。
NAT模式还是桥接模式:两种场景的IP地址设置差异
VMware的虚拟网络编辑器里有三种常见的网卡模式:NAT、桥接和仅主机,Pycharm远程开发用得最多的是NAT模式,这种模式下虚拟机通过宿主机共享IP上网,对外表现为一个内网设备,宿主机能访问虚拟机,虚拟机也能访问外网。
操作路径是:打开VMware → 菜单“编辑” → “虚拟网络编辑器” → 查看是否有VMnet8,VMnet8就是NAT模式的虚拟网卡,很多人在此忽略了一个细节:没勾选“使用本地DHCP服务将IP地址分配给虚拟机”,导致虚拟机开机后没有拿到合法内网IP。
如果你用的是桥接模式,虚拟机就像是局域网里的一台独立设备,IP必须和宿主机在同一个网段,比如宿主机的IP是192.168.1.10,那虚拟机应该手动配置成192.168.1.x,而且网关和DNS要和宿主机保持一致,桥接模式下常见的坑是:宿舍或办公环境的路由器开了AP隔离,即使IP设置正确,宿主机也ping不通虚拟机。
虚拟网络编辑器的还原默认设置能解决多数网络配置混乱
如果你之前多次更改过VMware的网络配置,宁愿重置再重来,点击“更改设置”获取管理员权限,然后选择“还原默认设置”,系统会重建VMnet1和VMnet8两张虚拟网卡,注意,还原之后Windows的“网络连接”里会多出两个VMware Virtual Ethernet Adapter,这是正常现象。
行业共识认为,过早修改虚拟机的静态IP但不调整VMnet8的子网段,是导致Pycharm连接失败的常见人为因素。
怎么设置虚拟机ip地址才能让Pycharm识别:手动静态IP的完整操作流程
DHCP分配IP不是不行,但有一个隐患:虚拟机的IP地址每次开机都可能变化,Pycharm的SSH配置里写死IP的话,下次启动大概率连不上,更稳定的做法是给虚拟机配置静态IP。
在Ubuntu或CentOS里配置静态IP的详细步骤
以Ubuntu 20.04及更新版本为例,系统用的是netplan配置网络,依次执行:
- 输入命令
ip addr,确认网卡名称,一般为ens33或ens160 - 编辑配置文件:
sudo vim /etc/netplan/00-installer-config.yaml如下:
network:
ethernets:
ens33:
dhcp4: no
addresses: [192.168.88.128/24]
routes:
- to: default
via: 192.168.88.2
nameservers:
addresses: [8.8.8.8, 114.114.114.114]
version: 2
这里的192.168.88.128是虚拟机的IP,192.168.88.2是网关,必须和VMware虚拟网络编辑器里VMnet8的子网网关保持一致,修改后执行sudo netplan apply让配置生效。
对于CentOS 7或旧版本,同样是vim /etc/sysconfig/network-scripts/ifcfg-ens33,重点修改BOOTPROTO=static、ONBOOT=yes、IPADDR、GATEWAY、DNS1这几项,改完执行systemctl restart network。
虚拟机IP地址设置常见错误自查清单
- 子网掩码是否对应:NAT模式下通常是255.255.255.0,对应/24前缀
- 网关是否指向VMnet8的虚拟网卡IP,不是宿主机物理网卡的IP
- 虚拟机防火墙是否拦截了Ping请求,可以先临时关闭测试
- Windows宿主机上VMware DHCP Service和NAT Service服务是否处于运行状态
在服务管理器中找到VMware NAT Service,右键启动,这个服务挂了,虚拟机的IP地址设置再正确,宿主机也无法访问。
pycharm远程开发虚拟机配置:SSH服务与端口检查不可缺少
网络层通了之后,Pycharm连接时还得依赖虚拟机内的SSH服务,不少初学者在镜像安装阶段没有勾选OpenSSH组件,导致系统根本没有sshd进程在监听端口。
检查SSH服务状态和防火墙放行规则
在虚拟机终端输入sudo systemctl status sshd或sudo systemctl status ssh,看是否显示active (running),如果是inactive状态,执行启动命令:
sudo systemctl start sshsudo systemctl enable ssh,让开机自启
如果系统提示command not found,说明没装SSH服务端,执行Ubuntu的安装命令:sudo apt install openssh-server,CentOS对应命令为:sudo yum install openssh-server。
然后检查防火墙放行22端口,Ubuntu的sudo ufw allow 22,CentOS的sudo firewall-cmd --permanent --add-port=22/tcp,之后sudo firewall-cmd --reload。
Pycharm侧Deployment和SSH Config的配置要点
打开Pycharm,进入File → Settings → Build, Execution, Deployment → Deployment,点击加号新建一个SFTP服务器,填入之前设置好的虚拟机IP、用户名和密码,建议先点击“Test Connection”按钮,Pycharm会给出明确报错提示,比如Connection refused代表SSH服务有问题,Timeout代表网络不通。
还有一种办法是在Pycharm的Terminal里直接输入ssh 用户名@虚拟机IP,如果终端能连上,Pycharm配置大概率没问题;终端也连不上的话,问题集中在网络或服务层。
排查思路归纳:宿主机与虚拟机之间的互通验证顺序
当遇到Pycharm连不上虚拟机时,按序执行以下验证步骤,能快速判断故障范围。
从Ping到端口,逐步缩小故障区域
- 第一步,在Windows命令行ping虚拟机IP,若不通,说明网络层有问题,回到VMware网络模式或虚拟机内IP配置排查
- 第二步,若Ping通了,用
telnet 虚拟机IP 22测试22端口是否开放,连接失败可确认是SSH服务或防火墙拦截 - 第三步,确认虚拟机的SSH监听地址是0.0.0.0而不是127.0.0.1,否则外部无法访问
- 第四步,检查Windows防火墙是否拦截了VMware进程的入站连接,有些安全软件会静默阻止VMware DHCP请求
据工信部数据,国内多数开发者在Windows平台进行嵌入式相关开发时会采用PyCharm远程连接虚拟机的方式,这类组合场景下配置出错的频率相对集中。
常见问题:VMware虚拟网卡在Windows中变为未识别网络
有相当一部分情况下,宿主机上右下角网络图标显示“未识别的网络”,此时VMnet8虽然存在但没有被正确分配IP段,解决方法是:进入Windows的“网络连接”面板,右键VMnet8,点击属性,找到IPv4协议,手动填写与VMware网络编辑器一致的IP地址和子网掩码,比如VMnet8的DHCP设置子网是192.168.88.0,那VMnet8本机IP可以填写192.168.88.1。
virtualbox pycharm连接不上的区别:不同虚拟化平台有所差异
如果你用的不是VMware而是VirtualBox,排查思路类似,但配置入口不同,VirtualBox默认使用NAT模式,虚拟机无法直接和宿主机互通,要使用Pycharm远程开发,需要给每个虚拟机增加一块“Host-Only”网卡,或者直接改桥接模式,让虚拟机直接获取局域网IP,VirtualBox中进入虚拟机设置 → 网络 → 连接方式选择桥接网卡,然后在虚拟机内配置静态IP,才能被Pycharm检测到,除了差异化的平台设置,Port Forwarding端口转发也是VirtualBox的另一种解决办法,但配置起来比较绕,不如直接用桥接模式简单。
Q&A模块
pycharm连接虚拟机失败,提示Connection timed out怎么办
超时说明请求发出去了但没有收到响应,集中在网络层,先确认虚拟机内的IP地址是否和Pycharm填写的完全一致,然后从Windows ping虚拟机IP看返回结果,Ping不通的话,检查VMware虚拟机网卡模式是否为NAT或桥接,以及VMware NAT Service服务状态,如果Ping得通但连接超时,多半是虚拟机内防火墙或SELinux限制了22端口访问。
虚拟机IP地址设置每次重启后都会变化,怎么固定
DHCP模式下IP租约到期后可能重新分配,最有效的办法是参考上文netplan或ifcfg文件配置手动静态IP,需要注意网关参数的来源,在VMware的网络编辑器中查看对应网卡的网关地址,确保虚拟机的路由指向正确,完成静态IP配置后,重启虚拟机验证。
Pycharm连不上虚拟机且报错“Connection refused”代表什么
IP和网络是通的,但虚拟机上没有任何服务在22端口监听,进入虚拟机终端执行ss -tlnp | grep :22,如果有信息输出说明SSH服务正常运行,如果没有任何输出,启动SSH服务或安装openssh-server组件。
整个排查流程指向一个核心结论:Pycharm连不上虚拟机时,从底层到上层依次验证VMware网卡模式、虚拟机静态IP网关指向、SSH服务状态,大多数问题都出在这三个环节,少数情况是Pycharm的SSH密钥与虚拟机不匹配,可以删除.ssh/known_hosts中的旧记录后重试,配置好一次网络环境,后续远程开发会顺畅很多。