VS Code port forwarding 怎样限制转发端口的访问范围

要限制 VS Code 内置端口转发的访问范围，在 Ports 面板右键目标端口，检查 Port Visibility 并保持为 Private；不再使用时停止该端口的转发。不要为了让同事免登录而随手切换成 Public：公开转发链接不要求登录，链接本身也不是细粒度授权。

官方地址：https://code.visualstudio.com/

端口转发文档：https://code.visualstudio.com/docs/debugtest/port-forwarding

下面讨论的是 VS Code 本地工作区借助 Microsoft dev tunnels 分享本地 Web 服务的入口，不是 Remote SSH、容器或 Codespaces 的所有端口机制。假设你已有一个只包含虚构数据的本地演示服务，想在另一台自己的设备上查看，又不希望任何拿到链接的人都能访问。本文不实际建立隧道，不测试远程链接；配图均为原创界面说明图而非截图。

1. 在 Ports 面板确认转发对象和入口

在菜单 View → Command Palette 中输入并执行 Ports: Focus on Ports View，定位到底部面板的 Ports 页签。先看列表里是否已有目标端口，不要对同一个服务反复创建转发，也不要依据应用名称猜端口号。

如果已有目标端口行，直接进入下一步检查可见性。如果需要新建，仅在确认服务适合远程访问后点击 Forward a Port，输入实际监听端口。例如演示服务确实运行在 3000 时才填写 3000；这个数字不是所有项目的默认值。

首次使用可能出现账号登录提示，应完成产品自己的正规登录流程，不分享账号会话、验证码或令牌。完成后，面板应出现对应端口及 Forwarded Address。这说明转发条目已建立，不代表应用功能、登录或数据权限已经正确。

这里需要做一个取舍：若只在本机浏览器看页面，通常无需创建互联网转发。少创建一个分享入口，往往比建立入口后再寻找限制按钮更直接。也不要把实际管理后台、调试控制台或带真实数据的页面当作演示服务。

2. 将目标端口的可见性保持为 Private

在 Ports 表格中右键目标端口行，打开 Port Visibility 子菜单，选择或确认 Private。之后观察该行的可见性状态；若版本界面采用图标或不同列布局，应结合菜单里的选中状态确认，而不是只看链接有没有变化。

对这一内置本地服务转发入口，官方文档说明 Private 为默认状态，访问时需要相应账号认证；其中 GitHub 登录流程要求使用开启该转发时的同一个 GitHub 账号。不要把 Private 理解为“同一个公司的所有账号自动获得访问权”，也不要把自己已登录浏览器能打开页面，当成其他账号也有权限的证明。

如果只是需要复制地址，悬停 Forwarded Address 后使用复制操作即可；复制动作本身不需要把可见性改为 Public。截图、群聊和工单里也应避免贴出不必要的真实分享地址。

假如需求其实是“只给三位同事看，但不共享自己的账号”，不能用一句“设置 Private”就宣称实现了团队白名单。应选用组织批准的分享和认证方案，并在应用层配置合适的登录与授权。不要用公开端口来绕过账号范围不匹配的问题。

3. 演示结束后停止转发并保留应用权限边界

演示结束后回到同一条端口行，右键选择 Stop Forwarding。操作后的可见状态是该活动转发条目从 Ports 列表移除；如果后续有其他机制重新创建转发，应单独查明来源。不要只关闭一个浏览器标签，就认为服务器侧的分享入口已经结束。

停止转发不会自动停止本地 Web 服务，也不会撤销该服务通过局域网监听、另一条隧道或其他代理公开的入口。你若需要完全结束演示，应按原来的启动方式关闭自己的演示服务，并遵守所在环境的权限和网络管理规则；不要随意终止不属于本次演示的进程。

对于受限页面，隧道认证与应用认证应分别考虑。Private 只是入口访问条件，并不替应用核对用户能看哪一条业务记录。HTTPS 也只解决传输相关的一部分问题，不会自动修复开发服务里过宽的授权。

看不到 Port Visibility 菜单怎么办？先确认你用的是本文的本地服务转发方式。远程工作区、SSH 和不同托管环境的端口入口可能不同，应查相应功能文档，不要盲目修改本地监听地址或放宽网络权限。

为什么 Private 链接在另一台设备打不开？除了服务是否运行，还应检查登录账号是否匹配开启转发时的账号，以及组织对隧道服务的限制；不要把改成 Public 当作通用修复办法。

把 Public 改回 Private，就能撤回之前泄露的信息吗？不能。它可以收紧后续访问条件，但无法撤回已经被读取或复制的数据。涉及凭据时还需要按团队事件处理规则处置，而不是只改一个菜单项。

这个演示场景的完成条件很具体：目标条目处于 Private，应用本身仍有必要的权限保护，不用时停止该转发。限制访问范围不是让链接难猜，而是明确入口的认证要求、应用授权责任和关闭方式。

参考：VS Code 端口转发官方说明。