如何在VSCode中通过Remote-SSH连接使用非22默认端口号的内网或公有云服务器

VSCode Remote-SSH连接失败主因是SSH配置错误、远程SSH服务未启用或被防火墙拦截、VS Code扩展权限/路径异常；需检查sshd状态、~/.ssh/config配置、remote.ssh.path设置及远程vscode-server环境。

连不上不是插件问题，而是 VSCode 默认只认 22 端口，你改了端口却没在配置里显式声明，它根本不会自动识别穿透映射端口或自定义 SSH 端口。

Remote-SSH 必须通过 ~/.ssh/config 指定非 22 端口

VSCode 的 Remote-SSH 插件不解析你在连接框里输的 user@host:2222 这种格式——它会忽略冒号后的端口，只当你是想连 22。唯一可靠的方式是走 SSH 配置文件。

• 编辑 ~/.ssh/config，写一段合法 Host 配置（别名不能含下划线或大写字母）：复制AI写代码

  1 2 3 4 5

  Host myserver   HostName 192.168.1.100   User ubuntu   Port 2222   IdentityFile ~/.ssh/id_rsa

• 保存后，在 VSCode 命令面板（Ctrl+Shift+P）运行 Remote-SSH: Connect to Host...，选 myserver ——不是输 IP，是选这个别名
• 如果用的是内网穿透（如 frp），确认云服务器上能 telnet 127.0.0.1 2222 通；不通说明 frp client 没连上 server，或云平台安全组没放行 2222

Permission denied (publickey) 的真实原因和修复点

报这个错，不代表密码错了，大概率是私钥没被加载、路径不对、或服务端拒绝了该密钥。尤其在非 22 端口下，OpenSSH 对权限更敏感。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• IdentityFile 必须写绝对路径，比如 /home/user/.ssh/id_rsa，不能用 ~ —— VSCode 的 SSH 插件有时不展开波浪号
• 本地私钥权限必须是 600：chmod 600 ~/.ssh/id_rsa；Windows 上还要确认是 PEM 格式，.ppk 不支持
• 公钥内容必须已追加进服务器的 ~/.ssh/authorized_keys（不是覆盖！），且该文件权限为 600，目录 ~/.ssh 为 700
• 检查服务器 /etc/ssh/sshd_config 是否启用：PubkeyAuthentication yes、Port 2222、AllowAgentForwarding yes；改完必须 sudo systemctl restart sshd，reload 不生效

内网穿透场景下 kex_exchange_identification 错误怎么快速定位

这不是认证失败，而是 TCP 连接刚建好就被远端立即切断。本质是“还没走到验证那步，连接就没了”。

• 先在服务器本地执行：ss -tuln | grep :2222，看有没有 LISTEN ——没有说明 sshd 根本没监听这个端口
• 检查 frp server 配置（如 frps.ini）是否在 allow_ports 里放开 2222
• 云服务器（阿里云/AWS）的安全组规则必须明确允许入方向 2222/TCP，不能只开 22
• Linux 服务器防火墙（ufw 或 firewalld）默认可能拦非标准端口，临时关掉测试：sudo ufw disable

远程 vscode-server 启动失败的隐藏条件

SSH 连成功 ≠ 远程开发就绪。VSCode 会在服务器上自动下载并启动 vscode-server，但它依赖几个容易被最小化系统砍掉的基础组件。

• 确保服务器有 curl 和 tar：which curl && tar --version；Alpine 或 debian-slim 镜像常缺 glibc，导致解压后无法执行
• 检查磁盘空间：df -h ~ /tmp；No space left on device 会静默失败
• 某些企业环境挂载 /home 时用了 noexec，导致 ~/.vscode-server 下的二进制无法运行；需确认挂载参数：mount | grep home
• 如果连接后卡在 Opening remote… 超过 30 秒，大概率是 ~/.bashrc 里有阻塞操作（如 git status、API 请求），注释掉再试

真正卡住的地方往往不在连接动作本身，而在 SSH 配置的路径展开、私钥权限的跨平台差异、或 vscode-server 对基础工具链的隐式依赖——这些细节一旦漏掉，就会陷入“命令行能连，VSCode 死活不行”的循环。