remote-ssh 连接后本地无法访问远程 web 服务，根本原因是 vs code 默认不转发端口，需手动配置端口转发或使用 live share；务必确保远程服务监听 0.0.0.0 而非 127.0.0.1，并检查转发状态与防火墙设置。
Remote-SSH 连上远程 Python 环境后，本地调试 Web 服务（如 Flask、FastAPI）却无法在浏览器访问 localhost:5000？这不是连接失败，而是端口没暴露——VS Code 默认不转发远程服务端口到本地。必须显式配置端口转发，且要区分「远程服务监听地址」和「本地可访问地址」两个关键点。
为什么远程启动的 Python Web 服务在本地打不开
常见现象：远程终端里运行 flask run --host=0.0.0.0:5000，终端显示 * Running on http://0.0.0.0:5000，但本地浏览器访问 http://localhost:5000 超时或拒绝连接。
根本原因不是防火墙或 SSH 设置，而是 VS Code 的 Remote-SSH 通道默认只做文件/终端/调试通道，不自动映射远程端口。远程进程监听的是服务器的 0.0.0.0:5000，但这个端口对你的本地机器不可见。
解决路径只有两条：手动添加端口转发，或用 Live Share 主动共享端口（后者更适合协作场景）。
用 Remote-SSH 内置端口转发映射远程服务
VS Code 提供图形化端口转发入口，比手敲 ssh -L 更稳定，且会自动重连保持映射。
- 连接到远程服务器后，按下
Ctrl+Shift+P打开命令面板，输入Remote-SSH: Forward a Port并执行 - 在弹出输入框中填入远程服务监听的端口号（例如
5000），回车 - VS Code 会自动生成一条转发规则：
localhost:5000 → remote-host:5000，并显示在左下角状态栏 - 此时本地浏览器访问
http://localhost:5000即可直达远程服务
注意：如果远程服务绑定了 127.0.0.1（而非 0.0.0.0），转发会失败——因为 127.0.0.1 只允许本机访问，SSH 无法从外部连入。务必确认服务启动时用了 --host=0.0.0.0 或等效参数。
用 Live Share 共享本地正在运行的 Python 服务
如果你本地跑着一个 Python Web 服务（比如本地开发中的 FastAPI），想让远程同事直接访问，而不是把代码推到他们那边再启动——这时该用 Live Share，不是 Remote-SSH。
- 确保已安装
Live Share扩展（微软官方） - 本地启动服务（如
uvicorn main:app --host 127.0.0.1 --port 8000） - 点击左下角
Share按钮，选择Share Server - 输入端口号
8000，可选命名（如dev-api） - 生成链接发给协作者，他们在自己浏览器打开
http://localhost:8000即可访问你本地的服务
安全提示：Live Share 的端口共享走加密隧道，仅限会话内成员访问；但切勿共享 22、3389 等系统端口，也别共享数据库默认端口（如 5432、3306）。
调试时断点生效但网页打不开？检查这三处
很多用户能成功调试 Flask 视图函数，却卡在页面访问环节。问题往往藏在细节里：
- 远程终端里运行服务时，是否漏了
--host=0.0.0.0？只写--port 5000默认绑定127.0.0.1，SSH 无法穿透 - VS Code 端口转发状态栏是否显示绿色「Active」？灰色表示未激活，右键可手动启用
- 远程服务器防火墙是否放行该端口？Ubuntu 上运行
sudo ufw status查看，必要时加规则：sudo ufw allow 5000
最易忽略的一点：VS Code 的端口转发是单向的（remote → local），它不会影响远程服务本身的网络策略。所以即使转发成功，服务自身监听范围不对，照样白搭。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
