VSCode Remote-SSH端口转发通过SSH隧道将本地端口请求转发至远程服务，无需公网暴露或防火墙修改；支持命令面板和Remote Explorer两种添加方式，自动处理浏览器跳转与端口冲突，状态可视化管理，常见问题包括监听地址匹配、端口占用及会话生命周期依赖。
VSCode 的远程开发（Remote-SSH）中，端口转发是让本地机器访问远程服务器上运行的服务（比如 Web 服务、数据库、Jupyter Notebook）最常用也最实用的方式。它不依赖额外工具，配置简单，且能自动处理 SSH 隧道和浏览器跳转。
端口转发是怎么工作的
本质是通过已建立的 SSH 连接，在本地监听一个端口，把发往该端口的请求，经由 SSH 隧道转发到远程服务器的指定地址和端口。远程服务无需暴露在公网，也不用改防火墙规则——只要 SSH 连得上，就能“穿透”过去。
例如：远程服务器上启动了 http://localhost:3000 的前端开发服务，你在本地访问 http://localhost:3000，VSCode 就会自动把请求转过去，就像服务跑在你本机一样。
两种触发方式：命令面板 & 右键菜单
连接到远程主机后，有两处快捷入口：
- 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Remote-SSH: Forward a Port…，回车后输入远程端口（如 3000），本地端口可留空（默认同远程端口）
- 在 VSCode 左侧活动栏点击 远程资源管理器（Remote Explorer） → 展开 Forwarded Ports 区域 → 点击 + Add Port 按钮，填入远程端口和可选的本地端口
添加后，端口会显示在列表中，并附带“打开浏览器”和“复制链接”按钮，点一下就能直接访问。
端口转发的状态与管理
所有已转发的端口都会列在 Forwarded Ports 面板里，每条记录包含：
- 远程地址：默认是 localhost，也可填 127.0.0.1 或其他监听地址（需服务本身允许）
- 远程端口：服务实际监听的端口（如 5432、8888）
- 本地端口：你在本地访问的端口（可与远程不同，比如远程 8888 → 本地 9999）
- 状态图标：绿色表示已成功建立隧道；灰色表示未激活；红色表示连接失败（常见于远程端口没服务、被占用或权限问题）
右键某条转发项，可选择 Remove Forwarded Port 停止转发，或 Change Local Port 修改本地映射端口。
常见问题与注意事项
端口转发看着简单，但几个细节容易卡住：
- 远程服务必须监听 localhost 或 127.0.0.1：如果服务绑定了 0.0.0.0 或具体 IP，通常也能转发；但如果只监听 127.0.0.1，而你填了远程地址为 server-ip，就会失败——保持地址一致即可
- 本地端口被占用会自动递增：比如你想转发远程 3000 到本地 3000，但 3000 已被占用，VSCode 会悄悄改成 3001 并提示，注意看通知栏
-
关闭 VSCode 或断开 SSH 后转发自动停止：不需要手动清理，但也意味着重启后要重新添加（可配合 settings.json 中
"remote.SSH.defaultForwardedPorts"预设常用端口） - 浏览器跨域或 CORS 一般不影响：因为请求发到本地端口，再由 SSH 隧道代为发出，对浏览器来说就是同源请求
基本上就这些。用熟了，几秒就能把远程的 Flask、Vue Dev Server、PostgreSQL Admin 页面调出来，比配反向代理或改 hosts 实在太多。
