VS Code 远程连接错误排查与解决：Host key verification failed

在使用 Visual Studio Code 的 Remote - SSH 扩展连接到远程 Ubuntu 设备时，遇到 “Host key verification failed. 过程试图写入的管道不存在。” 错误是一个常见的问题。本指南将详细分析此错误的原因，并提供一个安全、高效的排查和解决步骤。

一、错误原因分析

这个复合错误信息实际上由两个部分组成，它们之间存在因果关系：

1. 核心错误：Host key verification failed

这是标准的 SSH（Secure Shell）协议 错误。

主机密钥验证失败 意味着您的本地计算机（SSH 客户端）在尝试连接远程服务器时，发现远程服务器提供的公钥与本地存储的公钥不匹配 [2] [8]。

SSH 客户端如何工作：
当您首次通过 SSH 连接一个新服务器时，服务器会向客户端发送一个 主机公钥（Host Key）。客户端会将这个公钥的指纹记录在本地的 known_hosts 文件中（通常位于 ~/.ssh/known_hosts）。在后续连接中，客户端会检查服务器发送的公钥是否与记录中的一致，以防止 中间人攻击（Man-in-the-Middle Attack） [9]。

导致验证失败的常见原因：

1. 远程服务器重装或 SSH 服务重置： 这是最常见的原因。如果远程 Ubuntu 系统被重装、克隆或 SSH 服务被重新配置，它会生成一个新的主机密钥，导致与本地记录不符 [4] [9]。
2. IP 地址或主机名被重用： 如果您的远程服务器 IP 地址或主机名现在指向了另一台不同的机器，也会导致密钥不匹配 [9]。
3. 本地 known_hosts 文件损坏： 极少数情况下，本地存储的密钥文件可能损坏。

2. 伴随错误：过程试图写入的管道不存在。

这个错误（英文为 “The process tried to write to a nonexistent pipe.”）是 VS Code Remote - SSH 扩展 在 Windows 环境下经常出现的伴随错误 [11]。

错误关系：
当 Host key verification failed 发生时，SSH 连接会立即终止。VS Code 扩展在后台通过一个 管道（Pipe） 与 SSH 进程通信。由于 SSH 进程意外终止，管道被关闭，当 VS Code 试图通过这个管道发送后续指令时，就会收到“管道不存在”的错误 [13]。

结论： 解决 Host key verification failed 错误，通常也会自动解决 过程试图写入的管道不存在 的问题。

二、排查与解决步骤

解决问题的核心是 从本地的 known_hosts 文件中删除旧的、冲突的密钥记录。

步骤一：定位 known_hosts 文件

known_hosts 文件的位置取决于您的操作系统：

操作系统	默认路径
Windows	%USERPROFILE%\.ssh\known_hosts (例如：C:\Users\YourName\.ssh\known_hosts)
macOS/Linux	~/.ssh/known_hosts

步骤二：删除冲突的主机密钥记录

我们推荐使用 ssh-keygen 命令行工具来安全地删除记录，而不是手动编辑文件。

推荐方法：使用 ssh-keygen -R 命令

打开本地终端（Windows 用户可以使用 PowerShell 或 Git Bash），执行以下命令，将 hostname_or_ip 替换为您连接的远程设备的实际主机名或 IP 地址：

ssh-keygen -R [hostname_or_ip]

示例：

• 如果连接 IP 地址 192.168.1.100：

  ssh-keygen -R 192.168.1.100
  

• 如果连接主机名 ubuntu-server：

  ssh-keygen -R ubuntu-server
  

执行此命令后，系统会提示已从 known_hosts 文件中移除旧的密钥。

备用方法：手动编辑文件

如果您无法使用命令行工具，可以手动编辑 known_hosts 文件：

1. 使用文本编辑器打开 known_hosts 文件。
2. 找到包含您的远程服务器 IP 地址或主机名 的那一行。
3. 删除整行 [3]。
4. 保存并关闭文件。

步骤三：重新连接

完成上述步骤后，返回 VS Code 尝试重新连接您的远程设备。

此时，您应该会看到一个提示，询问您是否信任此主机并接受新的主机密钥指纹。请仔细检查指纹（如果可能），然后选择 “Continue” 或 “Yes”。

The authenticity of host '[hostname_or_ip]' can't be established.
...
Are you sure you want to continue connecting (yes/no/[fingerprint])?

接受新密钥后，VS Code 应该能够成功建立 SSH 连接，并继续安装远程扩展服务。

三、高级排查（如果问题仍未解决）

如果清理 known_hosts 文件后问题依然存在，请检查以下配置：

1. 检查 VS Code SSH 配置

确保您的 VS Code SSH 配置文件（通常通过 Ctrl+Shift+P 搜索 “Remote-SSH: Open Configuration File…” 打开）中的配置是正确的。

配置项	描述
Host	远程连接的别名。
HostName	远程设备的实际 IP 地址或主机名。
User	登录远程设备的用户名。
IdentityFile	如果使用密钥登录，请确保此路径指向正确的私钥文件。

2. 检查远程服务器的 SSH 服务状态

确保远程 Ubuntu 设备上的 SSH 服务（sshd）正在运行：

# 在远程 Ubuntu 设备上执行
sudo systemctl status sshd

如果服务未运行，请启动它：

# 在远程 Ubuntu 设备上执行
sudo systemctl start sshd

3. 检查 SSH 客户端日志

在 VS Code 中，您可以通过以下方式查看更详细的连接日志：

1. 点击左下角的 远程指示器（通常显示为 < > SSH: [Host Name]）。
2. 选择 “Show Log”。
3. 在输出（Output）面板中，选择 “Remote - SSH” 选项卡，查看连接过程中是否有更具体的错误信息。

---