VSCode远程开发时本地无法访问localhost:3000，主因是sshd默认禁用TCP端口转发，需将/etc/ssh/sshd_config中AllowTcpForwarding设为yes并重启sshd；应使用VSCode「Ports」面板配置端口映射而非手动ssh -L，且服务需监听0.0.0.0或正确匹配localhost/127.0.0.1。
VSCode 远程开发时 ssh -L 不生效？检查 SSH 配置是否禁用了端口转发
VSCode 用 Remote-SSH 连上服务器后，本地打不开 localhost:3000 —— 很大概率不是 VSCode 的问题，而是远程服务器的 sshd 默认禁止了 TCP 端口转发。这个限制在很多生产环境或云主机（比如某些阿里云/腾讯云镜像）上是默认开启的。
- 登录服务器，检查
/etc/ssh/sshd_config中是否有AllowTcpForwarding no或未显式设为yes - 改成
AllowTcpForwarding yes，然后运行sudo systemctl restart sshd - VSCode Remote-SSH 本身不自动加
-L参数，它只建通道；端口映射得靠你手动配或用 VSCode 的「端口转发」UI
在 VSCode 里点几下就能映射端口：用「Ports」面板而不是写命令
很多人习惯在终端敲 ssh -L 3000:localhost:3000 user@host，但在 Remote-SSH 模式下，这反而多余甚至冲突——VSCode 已经维持着一个长期 SSH 连接，自己有更稳的端口转发机制。
- 连接远程后，左下角状态栏点击「Remote Explorer」图标 → 切到「Ports」页签
- 点击「+」号，填入
3000（本地端口），目标地址填localhost:3000（远程服务监听地址） - VSCode 会自动生成带
GatewayPorts兼容性的转发规则，并在后台维持，比手敲ssh -L更可靠 - 如果远程服务绑的是
127.0.0.1:3000，这里必须填localhost:3000，填0.0.0.0:3000会失败
localhost 和 127.0.0.1 在 Remote-SSH 端口转发里不是一回事
你在远程跑了个 npm run dev，控制台显示 http://localhost:3000，但本地访问空白——很可能是因为它实际只监听了 127.0.0.1，而 VSCode 的 Ports 转发默认走的是 loopback 代理逻辑，对 localhost 域名做了特殊处理。
- 启动服务时显式指定 host：
npm run dev -- --host 0.0.0.0（Vite）、python manage.py runserver 0.0.0.0:8000（Django） - 或者改用
127.0.0.1替代localhost在转发配置中，有时能绕过 DNS 解析或代理层的歧义 - VSCode 的转发底层依赖 OpenSSH 的
LocalForward，而 OpenSSH 对localhost有优化行为，不一定等价于127.0.0.1
转发后打不开？先看 VSCode 「Ports」列表里的状态图标
端口出现在 Ports 面板不代表它真通了。VSCode 会给每个转发项标状态：灰色（未启用）、绿色（已连接）、红色（连接失败）。红色往往意味着远程服务根本没起来，或者防火墙挡了。
- 右键端口 → 「Copy Address」粘贴到浏览器，确认 URL 是
http://localhost:3000，不是http://127.0.0.1:3000（有些服务对 Host header 敏感） - 在远程终端执行
lsof -i :3000或netstat -tuln | grep :3000，确认服务确实在监听且没被127.0.0.1锁死 - 如果用的是 WSL2 或 Docker Desktop，注意 VSCode 可能连的是 WSL 实例而非物理机，转发链路多了一跳，
localhost含义会变
远程端口转发看着简单，但每层网络栈（SSH daemon、VSCode agent、本地浏览器、服务绑定地址）都可能悄悄改写「localhost」的指向。调不通时，别急着重装插件，先盯住 Ports 面板的状态色块和 lsof 输出。
