开门见山这应该是每个用 VS Code 连服务器、连虚拟机的人都会撞上的墙好不容易配好了 Remote-SSH点击连接结果终端窗口直接弹出一句Host key verification failed然后连接被掐断。我第一次踩这个坑是在帮同事调试一台 VMware 里的 Ubuntu 虚拟机时。当时项目急着提交我以为是网络问题重启了虚拟机、重装了插件折腾了半小时最后才发现是 SSH 密钥指纹这个机制在起作用。今天把完整解决步骤和背后的原理一次性讲清楚争取让后来人少走弯路。1. 问题本质SSH 客户端在认生1.1 Host key verification failed 到底在说什么先理解这句话的含义。当你用 SSH 协议连接一台从未连过的机器时客户端会要求服务器出示一个身份证明也就是主机密钥Host Key。这个密钥是一串很长的非对称加密公钥服务器每次连接都会用它来确认我就是我。客户端拿到这串公钥后会把它存放在本地的一个文件里这个文件叫known_hosts。下次再连接同一台机器时客户端会把服务器再次出示的公钥和known_hosts里存的那个进行比对。一旦发现对不上客户端会立刻拒绝建立连接并报出Host key verification failed。那为什么不直接弹窗问用户要不要信任这个新密钥因为 SSH 的默认安全策略是对于已经记录过的 IP 或域名如果密钥变了就意味着两种可能一是服务器重装系统了二是有人在你和服务器之间搞了中间人攻击。在拿不准的情况下客户端选择宁可断连也不冒险。1.2 为什么偏偏是虚拟机最容易触发这个问题我在实际排障中总结虚拟机场景触发这个错误的概率远高于云服务器原因不外乎这几个虚拟机被重装系统或重置快照/etc/ssh/ssh_host_*下的主机密钥全部重新生成。VMware 的克隆功能。如果你对一台虚拟机做了克隆克隆体和源机会生成各自不同的主机密钥但你的known_hosts里记录的还是旧的那个。IP 地址复用。今天这台虚拟机坏了你重新建了一台恰好 DHCP 分配了相同的 IP。你连的还是那个 IP但机器已经换了一台密钥自然对不上。端口转发规则变了。NAT 模式下虚拟机的 SSH 端口映射改了VS Code 连接时经过的主机身份验证也随之失效。换句话说这个错误并不一定说明有人攻击你更大概率是你连接的机器换了个身份而你本地的记录没跟上。2. 从根源下手处理 known_hosts 的几种姿势2.1 手动清理 known_hosts 文件最简单直接的办法就是把 known_hosts 里对应那台主机的记录手动删掉。具体操作如下。打开终端Windows 下是 PowerShellmacOS/Linux 下直接开 Terminal输入ssh-keygen -R 192.168.1.100这里的192.168.1.100要换成你连接失败的虚拟机 IP 或域名。运行完后SSH 客户端就会忘记这台机器下次连接时会重新询问是否信任选择 yes 即可。如果你想彻底清空所有主机的记录也可以直接编辑这个文件。路径如下WindowsC:\Users\你的用户名\.ssh\known_hostsmacOS / Linux~/.ssh/known_hosts用文本编辑器打开找到目标 IP 对应的一行删掉保存退出。这种做法适合记录太多、想一次性整理的情况。但注意别把整个文件删了尤其是如果你平时还用 VS Code 连很多生产环境服务器那里面存的可都是你信任过的机器删干净反而增加了后续被提示的风险。2.2 验证是否真正恢复连接清理完known_hosts后先在独立终端里手动测一次 SSH 连接ssh 用户名192.168.1.100如果你的虚拟机上 SSH 服务正常运行终端会显示类似这样的内容The authenticity of host 192.168.1.100 (192.168.1.100) cant be established. ED25519 key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxx. Are you sure you want to continue connecting (yes/no)?输入yes回车此时系统会把这台虚拟机的新公钥写入 known_hosts并继续要求输入密码或验证密钥。如果能走到这一步说明 SSH 层已经畅通回到 VS Code 里重新连接一般就没问题了。2.3 批量清理局域网内变动的主机如果你像我一样每天在多个虚拟机之间切换可能会遇到一个更麻烦的情况好几台虚拟机的 IP 都变了known_hosts 里积累了一堆僵尸记录。逐条用ssh-keygen -R删太慢可以这样批量处理# 备份现有文件 cp ~/.ssh/known_hosts ~/.ssh/known_hosts.bak # 只保留非注释且有效的主机记录 ssh-keygen -R 192.168.1.0/24注意ssh-keygen -R并不支持 CIDR 网段形式要真正批量删除同一网段的记录可以临时换个思路直接编辑文件用grep反选过滤掉目标网段生成新文件再替换回去grep -v ^192.168.1. ~/.ssh/known_hosts ~/.ssh/known_hosts.tmp mv ~/.ssh/known_hosts.tmp ~/.ssh/known_hosts这个做法适合能熟练操作命令行的读者如果只是偶发一次报错手动单条删就够了。3. 快速恢复连接的五步操作3.1 完整操作流程基于上面的原理我为你整理了一套完整可复用的排障步骤按顺序执行即可。第一步确认虚拟机的 SSH 服务是否正常运行。在虚拟机上执行sudo systemctl status sshd或sudo service ssh status。第二步检查本机和虚拟机之间的网络连通性。执行ping 虚拟机IP如果 ping 不通先解决网络问题这不是 SSH 的锅。第三步在本地终端执行ssh-keygen -R 虚拟机IP清理旧的密钥记录。第四步手动执行一次ssh 用户名虚拟机IP根据提示输入yes重新记录主机密钥。第五步回到 VS Code打开 Remote-SSH 插件重新连接目标主机。正常情况下就能进入远程终端了。整个流程耗时不超过三分钟比盲目重启大法高效得多。3.2 不同操作系统下的命令差异上面这套流程在 Windows/macOS/Linux 下都能用但有几个细节需要区分。Windows 下如果你沿用的是 OpenSSH 客户端Win10 1809 以上版本自带ssh-keygen命令直接可用。如果你以前安装过 PuTTY可能会混淆因为 PuTTY 用的是另一套puttygen和pageant机制VS Code Remote-SSH 默认走的是 OpenSSH 协议所以记住统一用ssh-keygen就好。macOS 自带 OpenSSH无需额外安装但提醒一句macOS 下 known_hosts 的路径同样是~/.ssh/known_hosts不要被网上的老教程误导去了/etc/ssh/。如果你的本地机器是 Linux最常见的坑是你用了sudo去跑 VS Code导致 known_hosts 分别存在于~/.ssh/和/root/.ssh/两个位置。此时用普通用户清理完再用 sudo 打开 VS Code 仍然可能报错。稳妥的办法是两个位置都清理一遍ssh-keygen -R 192.168.1.100 sudo ssh-keygen -R 192.168.1.1004. 进阶排查VS Code Remote-SSH 特有的问题源4.1 Remote-SSH 日志怎么查如果按上面的步骤操作完VS Code 仍然连接失败这时候就要考虑 Remote-SSH 插件自身的状态了。VS Code 的 Remote-SSH 会在连接时启动一个远程服务器组件这个组件安装在虚拟机的用户目录下。如果之前连接中断或者组件文件损坏同样会导致连接失败。查看日志的方法是在 VS Code 中按下CtrlShiftP输入Remote-SSH: Show Log回车。日志文件里的Remote-SSH输出窗口会显示详细的连接过程。常见的报错除了 Host key verification failed还有根据 log 提示找到是哪一步出的问题。另外提一个操作如果你怀疑远程服务器组件损坏可以在虚拟机上执行一条命令把 VS Code Server 的目录删掉下次连接时插件会自动重新下载rm -rf ~/.vscode-server这条命令只影响 VS Code 远程组件不影响虚拟机上你自己的代码和文件可以放心执行。4.2 SSH 配置文件里的三个关键参数VS Code Remote-SSH 实际上读取的是本地~/.ssh/config文件Windows 下是C:\Users\你的用户名\.ssh\config。检查一下你的配置里是否包含以下内容。Host my-vm HostName 192.168.1.100 User ubuntu Port 2222 StrictHostKeyChecking no UserKnownHostsFile /dev/null这里有几个参数需要注意。StrictHostKeyChecking no可以临时禁用严格的主机密钥检查它和UserKnownHostsFile /dev/null配合使用效果是每次连接都不检查、不记录主机密钥。这两行配置可以解决所有因为密钥变更导致的连接失败但我不建议长期保留因为它会降低 SSH 的安全性。正确姿势是确认这台虚拟机的网络环境是隔离的、可信的才这样配如果是公网服务器绝不要这么做。我的做法是在排障阶段临时加这两行问题解决后马上删掉恢复默认安全策略。4.3 确认你连的是不是墙内的 VS Code Server 下载问题有同学会遇到一种情况本地网络没问题SSH 也通了但 VS Code Remote-SSH 一直卡在 Setting up SSH Host 或 Downloading VS Code Server 这步。这是因为 VS Code Server 需要从微软的 CDN 下载网络状况不好时确实会失败。这时可以手动下载 VS Code Server把压缩包放到虚拟机上。具体版本号的获取方式是在本地 VS Code 的 about 页面查看 commit id然后去对应地址下载。不过这个话题展开又是一篇文章这次先点一句如果你卡在这一步优先检查能否在虚拟机的浏览器里正常打开微软官网。5. 避坑总结那些网上没说明白的细节5.1 常见问题速查表现象根因解决方案连接时报 Host key verification failedknown_hosts 中记录过期ssh-keygen -R清理记录后重连清理后手动 SSH 正常VS Code 仍失败VS Code 加载的是旧配置文件或远程组件损坏检查~/.ssh/config或删除~/.vscode-server重试几台虚拟机轮番改 IP老是报错known_hosts 中脏数据太多备份后批量清理 known_hosts提示 WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED虚拟机重装过系统或克隆过确认是本人操作后清理密钥记录不要贸然连接连接超时虚拟机防火墙或 NAT 端口转发未配在虚拟机内检查 sshd 服务状态和防火墙放行 22 端口输错密码反复提示known_hosts 正常但密码错误用ssh -v查看详细认证过程确认认证方式5.2 一条命令看清连接全过程如果上面的表格还解决不了你的问题你需要的是一把放大镜。在终端里执行ssh -v 用户名虚拟机IP-v参数会打印整个 SSH 连接过程IP 解析、TCP 握手、密钥交换、认证方式、最终会话建立。重点看两处一是在早期阶段有没有出现Host key verification failed的字样二是认证阶段是走的password还是publickey。排障的基本思路是先看报错在流程的哪个阶段再针对性地解决。-v输出的最后几行通常就是最关键的线索。5.3 分场景的快速处理建议场景一你只是临时连一次虚拟机以后可能还会重装。建议每次报错后用ssh-keygen -R清理保留严格检查机制。场景二虚拟机是你日常开发的主力环境经常重装、换 IP。建议在~/.ssh/config中给这台虚拟机指定一个固定的别名并把StrictHostKeyChecking设为accept-new。这是 OpenSSH 7.6 之后支持的一个折中选项对于第一次连接的机器自动接受密钥但如果发现已记录密钥变了仍然会拒绝连接。场景三多人共用同一台虚拟机且经常重置。建议在团队文档里加一条重置虚拟机后需执行ssh-keygen -R 目标IP从源头减少沟通成本。6. 最后聊聊我的使用心得踩过这么多次坑之后我现在的工作习惯是凡是新配虚拟机和 VS Code Remote-SSH都会按固定顺序做三件事。第一件事先在纯终端里跑一次ssh 用户名IP确认 SSH 层完全没问题再打开 VS Code 连接。这一步能天然区分SSH 问题和VS Code 问题避免在 VS Code 的图形界面里瞎猜。第二件事每台虚拟机在~/.ssh/config里都固定一个 Host 别名例如vm-dev、vm-test而不是每次手敲 IP。这样即使之后虚拟机重装导致 IP 变了只要改配置文件一处即可VS Code 里的 Remote 列表也不需要重新配置。第三件事known_hosts 文件定期做备份。虚拟机一多这个文件会越来越长里面混杂着很多已经不存在的旧机器。我通常每个月月初备份一次并把不再使用的机器记录清理掉保持文件干净。说回这次报错Host key verification failed 本质上不是 VS Code Remote-SSH 的 bug而是 OpenSSH 安全机制在帮你把关。理解了这一层你只要把 known_hosts 配合ssh-keygen -R清理干净就能轻松恢复。下次再看到这行红字不用慌三步走确认虚拟机身份变化是否是自己操作的清理本地记录重新信任连接。问题就解决了。