VSCode如何配置远程端口转发_VSCode远程端口转发配置步骤-VSCode-PHP中文网

vscode远程端口转发无需手动ssh命令，点击状态栏“forward a port…”输入远端端口（如3000）即可自动映射本地同号端口；仅当前窗口有效，依赖远端服务监听127.0.0.1或0.0.0.0；持久化需在~/.ssh/config中配置localforward。

vscode如何配置远程端口转发_vscode远程端口转发配置步骤

VSCode 远程端口转发不需要手动写 SSH 命令，但必须理解它只转发「本地到远程」的流量，且依赖远程服务监听地址是否匹配。

点一下就能转发：VSCode 内置 Forward a Port 功能

连接远程主机后，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Remote-SSH: Forward a Port…，回车，输入远程服务监听的端口号（如 3000）。VSCode 会自动在本地监听同号端口（localhost:3000），并建立隧道。

这个操作本质是后台执行了类似 ssh -L 3000:localhost:3000 user@host 的命令。它只对当前 Remote 窗口有效，关闭窗口即断开；不重启 VSCode、不重连，就不会自动恢复。

右下角状态栏点击 Forwarded Ports 可查看、编辑、删除已转发端口
悬停在端口条目上能看到完整映射（如 localhost:3000 → localhost:3000）
若本地 3000 已被占用，VSCode 会静默分配下一个可用端口（比如 3001），但不会弹窗提醒——得自己去状态栏点开看实际映射
转发成功后图标为绿色；红色表示失败，常见原因是远程端口没服务、或服务没监听 localhost/127.0.0.1

持久化配置：改 ~/.ssh/config 而不是 settings.json

想每次连上就自动转发多个端口（比如数据库 5432、API 8080），必须编辑 ~/.ssh/config，在对应 Host 块里加 LocalForward 行：

Host my-server
  HostName 192.168.1.100
  User dev
  LocalForward 5432 localhost:5432
  LocalForward 8080 localhost:8080

注意：LocalForward 必须写在 ~/.ssh/config 里，不能写进 VSCode 的 settings.json；也不能写成 LocalForward=5432:localhost:5432（等号会直接被忽略，无报错）。

改完保存，需断开当前 Remote 连接，再重新 Connect 才生效
VSCode Remote-SSH 扩展会读取该文件，无需额外插件或重启 VSCode 主进程
如果同时配了 remote.SSH.port（VSCode 设置中控制 SSH 连接端口），和 LocalForward 互不影响——前者管“怎么连上服务器”，后者管“连上后转哪些端口”

远程服务连不上？先查监听地址，不是防火墙

转发失败时看到 Connection refused，90% 是因为远程服务根本没在 localhost 或 127.0.0.1 上监听。VSCode 的端口转发只能把请求发给远程的 127.0.0.1:x，它不处理服务绑定逻辑。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在远程服务器上执行：

ss -tlnp | grep :3000

看输出第二列（Local Address:Port）是否包含 127.0.0.1:3000 或 *:3000。如果是 ::1:3000（IPv6 回环），而你的本地环境没启用 IPv6，也会失败。

create-react-app / Next.js / Vite 默认只监听 localhost，启动时加 --host 127.0.0.1 或配 server.host: '127.0.0.1'
Flask 默认只监听 127.0.0.1，用 app.run(host='0.0.0.0') 才能被转发识别（注意安全边界）
PostgreSQL 默认监听 127.0.0.1，但需确认 pg_hba.conf 允许 local 连接
远程防火墙（如 ufw）通常不影响，因为流量走的是 SSH 隧道，不经过 iptables INPUT 链

转发到非 localhost 目标：比如容器或内网机器

默认 LocalForward 3000 localhost:3000 只能访问远程本机服务。如果服务跑在 Docker 容器里，或另一台内网机器上，就得显式指定远程目标地址：

容器内服务（假设容器 IP 是 172.17.0.2，端口 8080）：LocalForward 8080 172.17.0.2:8080
跳板机后方的数据库（跳板机 A 连着 DB 机 B）：LocalForward 3307 10.0.1.5:3306（B 的内网 IP）
要让局域网其他设备也能访问（比如手机调试），需远程 SSH 服务端开启 GatewayPorts yes，再用 LocalForward *:8082 localhost:8080

这种写法绕过了 VSCode 图形界面，但更灵活。关键点在于：VSCode 只负责触发和管理隧道，真正的转发行为由 OpenSSH 客户端执行，所以所有 ssh -L 支持的语法都适用。

最易被忽略的一点：VSCode 的端口转发不继承终端里的 HTTP_PROXY 或 NO_PROXY 设置，如果你在远程终端里设置了代理变量，VSCode 的扩展进程（比如 Python 或 Docker 扩展）默认看不到——得单独配置 remote.extensionKind 或改 ~/.bashrc 并重启窗口。