Docker容器中Flask应用非本地地址无法访问问题求助

排查方向及解决方案 #

1. 确认宿主机访问方式 #

使用docker run -p 5000:5000启动容器后，端口已映射到宿主机的5000端口：

• 宿主机本地访问：用http://localhost:5000或http://宿主机局域网IP:5000（比如192.168.x.x）
• 局域网其他设备访问：必须使用宿主机的局域网IP，容器内部的172.17.0.2是Docker网桥私有IP，仅宿主机能直接访问，其他设备无法路由到该地址

2. 确保Flask启动参数生效 #

在代码中显式指定端口并添加日志验证，避免参数未加载：

if __name__ == "__main__":
    print("Flask启动参数：host=0.0.0.0，port=5000")
    app.run(
        debug=True,
        use_reloader=False,
        host="0.0.0.0",
        port=5000  # 显式指定端口，避免默认值变更
    )

启动后确认日志显示Running on all addresses (0.0.0.0)，若未显示，检查代码是否被正确执行（比如是否存在其他Flask启动入口）。

3. 检查宿主机防火墙设置 #

• 临时关闭宿主机防火墙（Windows防火墙、Linux iptables、macOS防火墙）测试，若能访问，再添加5000端口的入站允许规则
• 确保防火墙未拦截宿主机5000端口的外部连接

4. 验证Docker端口映射状态 #

执行docker ps查看容器端口映射，确认输出包含0.0.0.0:5000->5000/tcp或:::5000->5000/tcp，这表示端口绑定到宿主机所有IP；若显示127.0.0.1:5000->5000/tcp，说明启动时指定了仅本地映射，需改为-p 5000:5000。

5. 测试容器内部服务可用性 #

进入容器内部验证Flask服务是否正常：

# 替换<容器ID>为实际容器ID
docker exec -it <容器ID> bash
# 容器内执行curl请求
curl http://0.0.0.0:5000

若容器内部能访问，问题出在宿主机网络或端口映射；若容器内部也无法访问，检查Flask服务是否真的启动在0.0.0.0:5000。

内容的提问来源于stack exchange，提问作者Christian