vscode ssh端口转发失效主因是配置未被正确读取，需在ssh配置文件中显式添加localforward并重启连接；remote.ssh.port与localforward作用域不同但位置错则失效；服务监听地址、防火墙、ssh保活等服务器侧配置才是关键排查点。
VSCode SSH远程开发时，portForwarding 不生效怎么办
端口转发没反应，最常见原因是 VSCode 没读到正确的配置——它不自动继承 SSH config 里的 LocalForward，也不识别手动写的 ForwardAgent yes。必须显式在 VSCode 的远程连接设置里声明。
- 打开 VSCode 远程窗口（
Ctrl+Shift+P→Remote-SSH: Connect to Host...），选中目标主机后，右键 →Open Configuration File...，编辑对应~/.ssh/config或 VSCode 自建的config文件 - 在该 host 块内添加：
LocalForward 5432 localhost:5432
（把服务器的 5432 映射到本地 5432） - 保存后必须重启远程连接：断开 → 再次
Connect to Host，否则旧连接不会加载新配置 - 验证是否成功：连上后打开命令面板（
Ctrl+Shift+P），搜Remote-SSH: Open SSH Configuration File，再看左下角状态栏是否有「Port forwarding」图标；或终端执行netstat -an | grep 5432看本地端口是否监听
用 remote.SSH.port 和 LocalForward 混用会冲突吗
会。VSCode 的 remote.SSH.port 是控制 SSH 连接本身用的端口（比如服务器改了 SSH 端口为 2222），而 LocalForward 是应用层端口映射，两者作用域不同，但写错位置就失效。
-
remote.SSH.port是 VSCode 扩展级配置，写在 VSCode 设置（settings.json）里，只影响建立 SSH 连接的端口，不影响转发 -
LocalForward必须写在~/.ssh/config或 VSCode 的 SSH 配置文件里，且格式严格：LocalForward [bind_address:]port host:hostport，中间不能有等号或引号 - 常见错误：把
LocalForward 8080 127.0.0.1:8080写成LocalForward=8080:127.0.0.1:8080（多了等号）→ 直接被忽略，无报错也无日志提示 - 如果服务器开了防火墙（如
ufw），还需确认localhost:8080能被 SSH 进程访问（不是所有服务都绑定127.0.0.1，有些默认只监听0.0.0.0）
转发 PostgreSQL / Redis 等服务端口时连不上，Connection refused
错误信息是 Connection refused，说明本地端口已监听，但 VSCode 没把请求正确转给服务器上的服务——本质是服务没在服务器本地回环地址上监听，或权限限制。
- 先在服务器上确认服务是否运行且监听
127.0.0.1：ss -tlnp | grep :5432，输出里要有127.0.0.1:5432或*:5432；若只有192.168.x.x:5432，则转发失败 - PostgreSQL 默认
pg_hba.conf只允许local和host的127.0.0.1连接，确保有类似这行：host all all 127.0.0.1/32 md5
- Redis 若启用了
bind 127.0.0.1但没配protected-mode no，SSH 转发过来的连接会被拒绝——因为转发流量对 Redis 来说是“远程”，即使来源是本机 SSH 进程 - 别用
localhost当 bind 地址：某些系统（macOS、WSL）下localhost解析走 IPv6，而服务可能只监听 IPv4 的127.0.0.1，统一写127.0.0.1更稳
为什么 VSCode 端口转发有时延迟高、偶发断连
这不是 VSCode 的 bug，而是底层 SSH 连接保活机制缺失导致的——SSH 通道空闲超时后被服务器或中间网络设备关闭，VSCode 不会自动重连转发端口。
- 在 SSH 配置里加两行：
ServerAliveInterval 60<br>ServerAliveCountMax 3
，让客户端每 60 秒发一次心跳，连续 3 次无响应才断开 - 避免使用
ControlMaster auto+ControlPersist组合：VSCode 的 SSH 扩展对复用连接支持不稳定，容易导致转发端口卡死或映射丢失 - 转发大量小请求（如 WebSocket、DevTools 调试）时，建议关掉 VSCode 的
remote.SSH.useLocalServer（设为false），强制走标准 SSH 通道，减少本地代理层开销 - 真正难排查的是 NAT 环境：如果服务器在企业内网或云厂商私有子网里，某些安全组策略会静默丢弃非初始 SYN 包，此时必须联系运维确认转发路径上所有中间节点允许 ESTABLISHED 连接回流
ss、journalctl -u ssh、tcpdump -i lo port 5432 看。
