VS Code远程开发中的端口转发和SSH隧道-VSCode-PHP中文网

VS Code远程开发中的端口转发和SSH隧道

P粉986688829

发布： 2025-12-04 18:05:24

原创

727人浏览过

VS Code端口转发是内置的SSH隧道自动配置功能，用于本地访问远程服务；手动SSH隧道更灵活，支持跨设备访问、内网穿透等场景，需注意监听地址、GatewayPorts配置及端口冲突等问题。

vs code远程开发中的端口转发和ssh隧道

VS Code远程开发时，端口转发和SSH隧道是打通本地与远程服务的关键机制。它们不是一回事，但常配合使用：端口转发是VS Code内置的便捷功能，本质就是自动帮你建SSH隧道；而手动配置SSH隧道则更灵活，适合调试、数据库连接或绕过防火墙等场景。

当你通过Remote-SSH连接到服务器后，在VS Code左下角状态栏点击“Forwarded Ports”区域，或按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入“Forward Port”，就能添加一个端口映射。

有些场景VS Code的图形化转发不够用，比如需要保持长期隧道、转发非localhost目标、或让其他设备也能访问——这时就得自己配SSH隧道。

帮小忙

腾讯QQ浏览器在线工具箱平台

102

基础命令：ssh -L [本地地址:]本地端口:远程地址:远程端口 user@host
想让手机也访问远程Web服务？用ssh -L *:8082:localhost:8080 user@host（注意需SSH服务端配置GatewayPorts yes）
转发到远程机器上的另一台内网机器？比如跳板机A连着数据库机B：ssh -L 3307:B:3306 user@A
加-N -f可后台运行，加-o ExitOnForwardFailure=yes避免端口被占时静默失败

端口转发不是万能的，几个容易踩的坑得提前知道：

服务监听地址必须匹配：如果远程服务只绑定了127.0.0.1:8080，那从本地转发过去没问题；但如果它监听的是0.0.0.0:8080，且你又用了*:前缀，还得确认远程SSH服务是否允许GatewayPorts
端口冲突要主动处理：本地端口已被占用时，VS Code会提示失败，不会自动换端口；手动SSH隧道也会报错，需先lsof -i :端口号或netstat -an | grep 端口号查进程
HTTP服务别漏掉路径和协议：转发只是端口层面的TCP透传，浏览器访问http://localhost:8081没问题，但如果是HTTPS或带子路径的服务（如/api），前端代码里的URL仍需按实际部署结构调整
身份验证别走代理：如果SSH连接本身用了跳转主机（ProxyJump）或密钥代理（ssh-agent），端口转发会复用同一连接，一般无需额外配置