Flask API容器化后主机无法访问的问题求助

以下是针对问题的具体排查和解决步骤：

• 修正Flask监听地址
  Flask默认仅监听容器内部的127.0.0.1，主机请求无法穿透到容器内。必须将服务绑定到0.0.0.0，确保容器外能访问。修改你的app.py启动代码：

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)  # 端口需和Dockerfile/容器映射保持一致

• 确认端口映射配置
  运行容器时必须通过-p参数完成主机与容器的端口映射，比如把主机8080端口映射到容器内Flask监听的5000端口：

docker run -p 8080:5000 your-image-tag

如果遗漏-p参数或端口映射不匹配，主机无法访问容器服务。

• 检查容器内端口监听状态
  进入容器验证服务是否在正确监听端口：

docker exec -it your-container-id /bin/bash
# 若容器基于Debian/Ubuntu，先安装net-tools：apt update && apt install -y net-tools
# 若基于Alpine：apk add net-tools
netstat -tulpn | grep 5000

正常输出应包含0.0.0.0:5000，说明服务已对外监听。

• 排查主机网络与端口占用

  1. 检查主机8080端口是否被其他进程占用：

  lsof -i :8080  # macOS/Linux
  # Windows用：netstat -ano | findstr :8080
  

  若被占用，更换未使用的端口重新映射。
  2. 临时关闭主机防火墙测试，或添加允许8080端口入站的规则，避免防火墙拦截请求。

• 验证Dockerfile启动命令
  确保Dockerfile的启动命令正确配置了监听地址：
  如果用直接运行脚本的方式：

FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py .
CMD ["python", "app.py"]

如果用flask run命令，需设置环境变量并指定监听地址：

ENV FLASK_APP=app.py
CMD ["flask", "run", "--host=0.0.0.0", "--port=5000"]

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