使用 vscode 的 Port Forwarding 可在本地安全访问远程服务，需安装最新 VSCode、Remote-ssh 扩展并连接远程主机，通过命令面板连接后，在端口面板输入远程端口号（如 3000），VSCode 会自动映射到本地，浏览器访问 http://localhost:3000 即可；支持修改映射、设为始终转发及通过 .vscode/settings.json 配置属性标签和自动开浏览器，适用于调试 Web 服务、数据库、API、jupyter 等场景，操作简便无需手动 SSH 隧道。

使用 VSCode 的 Port Forwarding 功能进行远程开发，可以让你在本地安全地访问远程服务器上运行的服务，比如 Web 应用、数据库或调试接口。这个功能是 Remote-SSH 扩展的一部分，配合端口转发机制，能极大提升远程开发体验。

启用 Port Forwarding 的前提条件

要使用该功能，需确保以下几点已准备就绪：

• 安装了 VSCode 并更新到最新版本
• 安装了官方 Remote – SSH 扩展
• 拥有可通过 SSH 访问的远程服务器（支持密码或密钥登录）
• 远程服务器上的服务正在监听某个端口（如 3000、5000、8080 等）

连接远程服务器并开启端口转发

连接成功后，你可以通过以下步骤设置端口转发：

1. 按下 F1 或 Ctrl+Shift+P 打开命令面板
2. 输入并选择 Remote-SSH: Connect to Host…
3. 选择你的远程主机完成连接
4. 连接成功后，在左侧活动栏点击“端口”图标（或使用 Ctrl+Shift+P → Ports: Focus on Ports View）
5. 在“Ports”面板中，点击“Forward a port”按钮
6. 输入远程服务正在监听的端口号（例如 3000）
7. VSCode 会自动将该端口映射到本地一个可用端口（默认相同）

此时，你在本地浏览器访问 http://localhost:3000，实际上请求会被安全地转发到远程服务器的 3000 端口。

管理与配置转发端口

VSCode 提供了灵活的端口管理方式：

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

• 可在“Ports”面板中右键端口，修改本地映射端口或关闭转发
• 设置为“Always Forwarded”，实现下次连接时自动转发
• 通过 .vscode/remote.json 配置文件预定义转发规则

示例配置（放在项目根目录的 .vscode/settings.json 中）：

"remote.portsAttributes": {   "3000": {     "label": "react app",     "elevateIfNeeded": true,     "openBrowser": true   },   "5432": {     "label": "postgresql"   } }

常见应用场景

Port Forwarding 特别适用于以下情况：

• 本地调试运行在远程容器或云服务器上的 Web 服务
• 安全访问远程数据库（如 PostgreSQL 5432、mysql 3306）
• 调试后端 API 或微服务接口
• 查看远程 Jupyter Notebook 或 streamlit 应用

基本上就这些。只要连接上远程主机，端口转发操作几秒就能完成，不需要额外配置 SSH 命令或使用命令行 tunnel。对日常开发来说，既方便又安全。