Flask默认监听127.0.0.1导致外部无法访问,根本原因是开发服务器仅绑定本地回环地址;必须显式设置app.run(host='0.0.0.0')或flask run --host 0.0.0.0,且需配合防火墙放行与正确端口映射。
Flask 默认只监听 127.0.0.1,外部根本连不到
这不是网络或防火墙的问题,而是 Flask 开发服务器的默认行为:它只绑定到本地回环地址 127.0.0.1。哪怕你看到控制台输出 * Running on http://0.0.0.0:5000/,那也可能是日志误导——实际监听地址仍可能是 127.0.0.1。用 netstat -ano | findstr :5000(Windows)或 lsof -i :5000(macOS/Linux)查一眼,如果显示的是 127.0.0.1:5000 而非 *:5000 或 0.0.0.0:5000,就坐实了这个问题。
app.run(host='0.0.0.0') 必须显式写,不能依赖配置项
Flask 的 app.config 不控制 app.run() 的绑定行为;SERVER_NAME 或 HOST 配置项对开发服务器无效。唯一可靠的方式是直接传参:
- ✅ 正确:
app.run(host='0.0.0.0', port=5000) - ❌ 错误:
app.config['HOST'] = '0.0.0.0'然后只调用app.run() - ⚠️ 注意:如果用了
flask run命令,必须加--host 0.0.0.0,不能只靠环境变量
Docker 容器里不改 host=0.0.0.0 就等于没绑对外端口
即使你写了 -p 8080:5000,容器内 Flask 若仍监听 127.0.0.1:5000,宿主机映射过来的流量也进不去。Docker 网络模型要求服务在容器内部“主动暴露”给所有接口。
Python 3.14.3
微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
- 容器内执行
curl -v http://127.0.0.1:5000成功 ≠ 外部能访问 - 必须同时满足:
app.run(host='0.0.0.0')+docker run -p 8080:5000 - 镜像构建时若把
host写死在代码里(比如app.run(host='localhost')),就得改代码再重建镜像
Windows 上 Edge/Chrome 打不开 127.0.0.1 是另一回事
这和“外部无法访问”无关,而是浏览器沙箱策略:UWP 版 Edge 默认禁用 loopback 访问。此时 127.0.0.1 在本机都打不开,但 http://localhost:5000 或 http://[你的局域网IP]:5000 可能正常——别被这个现象带偏排查方向。
真正卡住外部访问的,永远是那三件事:Flask 绑定地址不对、宿主机防火墙拦了端口、云服务器/路由器没开安全组或端口转发。其中第一个最容易被忽略,也最常白忙活半天。