VS Code端口转发是内置的SSH隧道自动配置功能，用于本地访问远程服务；手动SSH隧道更灵活，支持跨设备访问、内网穿透等场景，需注意监听地址、GatewayPorts配置及端口冲突等问题。
VS Code远程开发时，端口转发和SSH隧道是打通本地与远程服务的关键机制。它们不是一回事，但常配合使用：端口转发是VS Code内置的便捷功能，本质就是自动帮你建SSH隧道；而手动配置SSH隧道则更灵活，适合调试、数据库连接或绕过防火墙等场景。
VS Code自带的端口转发（最常用）
当你通过Remote-SSH连接到服务器后，在VS Code左下角状态栏点击“Forwarded Ports”区域，或按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入“Forward Port”，就能添加一个端口映射。
- 比如远程服务运行在8080端口，你想在本地8081访问它，就填“8081 → 8080”
- VS Code会在后台执行类似ssh -L 8081:localhost:8080 user@host的命令
- 这个映射会随SSH会话存在，关闭Remote窗口或断开连接后自动清理
- 支持“Remote”、“Local”、“Both”三种绑定方式，默认“Local”（只允许本地访问，更安全）
手动配置SSH隧道（更可控）
有些场景VS Code的图形化转发不够用，比如需要保持长期隧道、转发非localhost目标、或让其他设备也能访问——这时就得自己配SSH隧道。
- 基础命令：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），端口转发会复用同一连接，一般无需额外配置
基本上就这些。端口转发不复杂，但容易忽略监听地址、绑定范围和权限配置这些细节。用熟了，本地调远程API、连远程数据库、甚至看远程Jupyter Notebook都变得像在本机一样顺手。
