VSCode Remote-SSH连接失败求助：通道2打开失败（管理性禁止）

环境信息 #

• 本地环境：macOS 12.6、VSCode 1.72.2、Remote-SSH v0.90.1预览版
• 服务器环境：腾讯云轻量应用服务器CentOS7.6
• 已配置服务器SSH参数：AllowTcpForwarding yes
• 现状：本地命令行可正常SSH连接服务器，但VSCode Remote-SSH连接时出现如下报错：

英文报错：channel 2: open failed: administratively prohibited: open failed
中文翻译：通道2：打开失败：管理员禁止：打开失败

解决步骤 #

• 检查并完善服务器SSH配置
  编辑服务器的/etc/ssh/sshd_config文件，确认以下参数：

  • PermitOpen：若存在该参数，设置为PermitOpen any（允许任意端口转发），或根据需求指定允许的端口
  • GatewayPorts：设置为yes或clientspecified
    修改完成后重启SSH服务：systemctl restart sshd

• 调整VSCode Remote-SSH连接配置
  通过VSCode命令面板（快捷键Cmd+Shift+P）打开Remote-SSH: Open SSH Configuration File，在目标服务器的配置块中添加：

  Host 你的服务器IP/别名
    ForwardAgent yes
    ForwardX11 yes
    ForwardX11Trusted yes
  

  保存配置后重新尝试连接。

• 检查服务器安全组与防火墙

  • 腾讯云轻量服务器安全组：确保允许SSH端口（默认22）及动态转发端口的入站/出站规则
  • 服务器本地防火墙：执行firewall-cmd --add-service=ssh --permanent并重启防火墙firewall-cmd --reload，或根据需求放行相关端口

• 切换Remote-SSH插件至稳定版
  当前使用的预览版可能存在兼容性问题，在VSCode插件市场中找到Remote-SSH，点击版本选择器，切换到最新稳定版后重启VSCode再尝试连接。

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