VS Code Remote SSH连接特定主机失败：等待端口转发就绪

之前一直能正常连接某台远程主机，两天前突然连接失效。查看Output > Remote-SSH日志，显示已启动连接流程：

[09:34:33.197] > 63ffd590a635: running
> Script executing under PID: 2924742
> Found existing installation at /home/blaylock/.vscode-server...
> Starting VS Code CLI...

但连接无法完成，通知弹窗提示：

Setting up SSH Host <hostname>: Waiting for port forwarding to be ready

本地未做任何配置变更，且能正常连接其他远程主机。已尝试以下配置调整，但无效果：

"remote.SSH.showLoginTerminal": true,
"remote.SSH.useLocalServer": false

排查方向与解决步骤 #

• 优先确认主机端端口转发限制
  你的推测大概率成立，主机端可能存在以下变更：

  1. sshd_config中修改了AllowTcpForwarding（设为no或local），或限制了PermitOpen规则，阻断VS Code所需的端口转发请求
  2. 主机防火墙（如ufw、iptables）新增规则，拦截了VS Code Server使用的动态高位端口
  3. SELinux/AppArmor等安全模块更新策略，限制了VS Code进程的端口转发权限

• 手动验证SSH端口转发功能
  在本地终端执行测试命令，确认基础转发功能是否正常：

  ssh -L 12345:localhost:22 <hostname>
  

  若无法建立转发，说明主机端存在明确限制，需联系管理员调整；若能正常建立，再排查VS Code相关问题。

• 重置远程VS Code Server
  远程主机上的VS Code Server可能损坏，手动删除后重新部署：

  ssh <hostname> "rm -rf ~/.vscode-server"
  

  之后重新发起VS Code Remote-SSH连接，会自动重新安装Server。

• 排查本地SSH配置干扰
  检查本地~/.ssh/config中对应主机的配置，是否意外添加了NoForward等限制转发的参数；也可通过 verbose 模式连接，查看端口转发相关错误：

  ssh -v <hostname>
  

• 指定固定端口用于转发
  在VS Code设置中添加配置，强制使用固定端口：

  "remote.SSH.serverPort": 2222
  

  同时确保主机端防火墙允许2222端口的入站连接，再重新尝试连接。

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