服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-18 简米科技 4,510 字 11 分钟阅读

Pycharm连不上虚拟机怎么办,IP配置哪里出错?

导读Pycharm连不上虚拟机时,多数问题出在VMware的网卡模式选错、虚拟机IP地址配置与Pycharm的SSH连接信息不一致,或者虚拟机的SSH服务根本没启动,这篇文章按排查顺序拆解每个环节,帮你快速定位是哪一步出了问题,pycharm连不上虚拟机常见原因排查:先从VMware网络模式入手Pycharm访问虚……

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 ssh
  • sudo 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中的旧记录后重试,配置好一次网络环境,后续远程开发会顺畅很多。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱