讲师中心 微信公众号
AI工具推荐 视频效率加速

VSCode如何使用内建的端口转发 远程访问本地服务方法【教程】

风辰大大_2021

风辰大大_2021

发布时间:2026-05-23 09:37:39

|

563人浏览过

|

来源于php中文网

原创

VSCode内建端口转发仅支持本地转发(-L),不提供远程转发(-R)的图形界面;需手动在本地终端执行ssh -R命令实现远程访问本地服务。

vscode如何使用内建的端口转发 远程访问本地服务方法【教程】

VSCode 内建的端口转发不能“远程访问本地服务”——它只支持本地端口转发(-L),即把远程服务映射到本地;想让远程机器访问你本机的服务,必须用远程端口转发(-R),而 VSCode Remote-SSH 插件默认不提供图形界面配置 -R 的能力。

Remote-SSH 不支持点选式远程端口转发(-R)

VSCode Remote-SSH 的「Forward a Port…」命令、状态栏 Ports 视图、以及所有 UI 操作,底层调用的都是 SSH 的 -L 参数(本地转发)。它没有对应 -R 的按钮或菜单项。试图在命令面板里搜 “Remote Forward” 或 “Reverse Forward” 会找不到任何匹配项。

  • 官方文档和源码确认:截至 2026 年 5 月,Remote-SSH 扩展未暴露 RemoteForward 配置入口,也不解析 ~/.ssh/config 中的 RemoteForward 行
  • 如果你看到某些文章说“VSCode 支持反向转发”,大概率是混淆了手动命令行 ssh -R 和 VSCode 自身功能
  • Remote-SSH 的核心定位是“把开发环境搬到远程”,不是构建通用 SSH 隧道代理工具

想让远程服务器访问你本地的服务?只能手动 ssh -R

比如你在本地跑了一个 API 服务监听 localhost:8000,想让远程服务器上的 curl 能访问 http://localhost:8000(即远程机器能调用你本机的服务),必须从你的本地终端执行:

ssh -R 8000:localhost:8000 user@remote-server

这条命令含义是:“把远程服务器的 localhost:8000 绑定,收到的请求原样转发回我本地的 localhost:8000”。注意几个关键点:

VSCode
VSCode

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

下载
  • -R 必须从你本地发起(不是在 VSCode 远程窗口里执行),因为本机才是被访问的一方
  • 远程服务器需开启 GatewayPorts no(默认)才能让 localhost:8000 只对本机 SSH 进程可见;若想让远程其他机器也能访问该端口,得配 GatewayPorts yes 并用 -R *:8000:localhost:8000
  • SSH 连接断开,-R 隧道就失效;如需持久化,要用 autossh 或 systemd service 管理

VSCode 里误用 Forward a Port… 的典型失败现象

有人在 VSCode 远程窗口中输入 Forward a Port… → 填 8000,以为这样就能让远程服务器“看到”自己本机的 8000 端口。结果是:

  • VSCode 实际执行的是 ssh -L 8000:localhost:8000 …,目标是去连远程服务器自己的 localhost:8000 —— 但那台机器根本没开这个服务,所以报 Connection refused
  • 右下角状态栏显示绿色图标,只是说明隧道建立成功,不代表远程有服务在听;它不验证远端目标是否真实可达
  • 你以为转发了“本地服务”,其实只是把本地流量打向一个不存在的远程端点

替代方案:用 VSCode + 本地终端组合完成 -R 流程

虽然 VSCode UI 不支持 -R,但它可以成为协作枢纽:

  • 在 VSCode 本地窗口(非 Remote)中打开终端,运行 ssh -R 8000:localhost:8000 user@remote-server
  • 保持这个终端常驻;VSCode 远程窗口里可照常编辑、调试、运行命令,远程脚本调用 curl http://localhost:8000 就能命中你本机服务
  • 如果本地服务是 Node.js/Python,确保它监听 127.0.0.1(不是 0.0.0.0),否则可能被防火墙拦截或绑定失败
  • Windows 用户注意:OpenSSH 客户端需 Windows 10 1809+ 或手动安装;PowerShell 中执行前先确认 Get-Service ssh-agent 是否运行

真正容易被忽略的点是:VSCode 的端口转发 UI 和 SSH 协议本身的 -R 能力完全不在一个抽象层上——前者是 Remote-SSH 扩展封装的便利功能,后者是 SSH 协议原生命令。指望点几下鼠标就实现反向穿透,只会卡在 Connection refused 里反复怀疑人生。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1395

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2952

2023.07.21

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1989

2024.03.14

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1727

2024.03.14

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2607

2024.03.15

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1838

2024.03.15

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1262

2024.03.15

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1116

2024.03.15

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn