VS Code更新后Windows远程SSH连接树莓派开发服务器启动失败求助

环境信息 #

• 两台已完全更新的Raspberry Pi Bullseye Linux服务器（备份/开发服务器配置相近）
• Windows 10系统运行VS Code 1.77.0，通过Remote-SSH扩展连接服务器，无代理、未使用Docker
• 四天前两台服务器均可正常连接，VS Code提示更新后，仅开发服务器连接失败，备份服务器正常
• 可通过PuTTY、WinSCP正常访问两台服务器

错误现象 #

连接开发服务器时，反复显示> Waiting for server log...后抛出以下报错：

[00:20:27.191] Resolver error: Error: The VS Code Server failed to start
    at m.ServerInstallError (c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:584322)
    at f (c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:578379)
    at t.handleInstallOutput (c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:581404)
    at t.tryInstall (c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:681793)
    at async c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:644041
    at async t.withShowDetailsEvent (c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:647359)
    at async t.resolve (c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:645091)
    at async c:\Users\Roy\.vscode\extensions\ms-vscode-remote.remote-ssh-0.98.0\out\extension.js:1:720839
[00:20:27.194] ------

[00:20:27.419] > 
[00:20:28.481] "install" terminal command done
[00:20:28.481] Install terminal quit with output: 

终端最后无额外输出。

已尝试的无效解决方案 #

• 删除开发服务器/home/me/.vscode-server目录，重新生成后问题依旧
• 通过VS Code命令面板执行Remote-SSH: kill VS Code Server on Host...，重启后无效
• 确认服务器磁盘空间充足
• 卸载重装Remote-SSH/Remote-SSH: Editing扩展，无效（同一VS Code可连接备份服务器，排除扩展全局问题）
• 删除Windows端C:\Users\Roy\.ssh\known_hosts中对应开发服务器的条目，重新生成后无效
• 为开发服务器添加新IP，尝试连接后无效
• 卸载重装服务器SSH服务，操作如下，无效：

sudo service ssh stop
sudo apt-get --purge remove openssh-client openssh-server
sudo apt autoremove
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install openssh-server
sudo service ssh status

建议解决方案 #

1. 手动指定VS Code Server版本
   先在备份服务器上查看已成功运行的VS Code Server版本：

   ls /home/your-user/.vscode-server/bin/
   

   复制对应的版本号（如abc123...），然后在VS Code的SSH配置文件（~/.ssh/config）中为开发服务器添加以下配置：

   Host dev-pi
       HostName 你的开发服务器IP
       User 你的用户名
       RemoteForward 52698 127.0.0.1:52698
       RemoteCommand bash -c "cd ~/.vscode-server/bin/你的版本号 && ./server.sh"
   

   保存后重新尝试连接。

2. 检查并统一Node.js版本
   VS Code Server依赖Node.js，可能开发服务器的Node版本与VS Code 1.77.0不兼容。在备份服务器执行node -v查看版本，然后在开发服务器安装相同版本：

   # 示例：安装v16.x版本（适配VS Code 1.77.0）
   curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
   sudo apt-get install -y nodejs
   

3. 修复服务器目录权限
   确认/home/me/.vscode-server目录的权限为当前用户所有：

   sudo chown -R me:me /home/me/.vscode-server
   sudo chmod -R 755 /home/me/.vscode-server
   

4. 禁用自动服务器更新
   在VS Code设置中搜索remote.SSH.serverDownloadURL，将其设置为备份服务器上已成功运行的VS Code Server的下载链接（可从备份服务器.vscode-server/bin/版本号目录下的install.log中找到），强制使用兼容版本。

内容的提问来源于stack exchange，提问作者Roy Grubb