wiremind/uwsgi-nginx-flask

支持的标签及对应的Dockerfile链接

• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.6/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.6-index/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.6-alpine3.7/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.5/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.5-index/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python2.7/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python2.7-index/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python2.7-alpine3.7/Dockerfile

已弃用的标签及对应的Dockerfile链接

• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/deprecated/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/deprecated-index/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.5/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python3.5-index/Dockerfile
• https://github.com/tiangolo/uwsgi-nginx-flask-docker/blob/master/python2.7/Dockerfile

uwsgi-nginx-flask

镜像概述

该Docker镜像为Python 3.6、3.5和2.7版本的Flask Web应用提供uWSGI（应用服务器）和Nginx（Web服务器）支持，可在单个容器中运行，也提供轻量的Alpine Linux版本选项。uWSGI搭配Nginx是部署Python Web应用的高效方案，能保证良好性能（参考基准测试）。

GitHub仓库：https://github.com/tiangolo/uwsgi-nginx-flask-docker
Docker Hub镜像：https://hub.docker.com/r/tiangolo/uwsgi-nginx-flask/

核心功能

1. 高效部署：整合uWSGI和Nginx，兼顾动态请求处理与静态文件服务效率。
2. 多版本支持：覆盖Python 2.7/3.5/3.6及Alpine变体，适配不同项目需求。
3. 灵活配置：支持自定义上传大小、监听端口、静态文件路径/URL、Nginx工作进程数等。
4. SPA优化：直接提供静态index.html，适配Angular/React等单页应用。
5. 预启动脚本：允许执行数据库迁移、初始化等预启动操作。

使用场景

1. 快速部署中小型Flask Web应用或微服务。
2. 构建前后端分离项目（Flask后端API + SPA前端）。
3. 需要高效静态文件服务的Python Web项目。
4. 开发环境中实时测试Flask应用（通过卷映射实现热更新）。

配置说明

基础快速开始

1. 项目结构：

   .  
   ├── app  
   │   └── main.py  
   └── Dockerfile  
   

2. Dockerfile：

   Dockerfile
   FROM tiangolo/uwsgi-nginx-flask:python3.6  
   COPY ./app /app  
   

3. main.py示例：

   python
   from flask import Flask  
   app = Flask(__name__)  
   
   @app.route("/")  
   def hello():  
       return "Hello World from Flask"  
   
   if __name__ == "__main__":  
       app.run(host='0.0.0.0', debug=True, port=80)  
   

4. 构建与运行：

   bash
   docker build -t my-flask-app .  
   docker run -d --name my-container -p 80:80 my-flask-app  
   

SPA支持

若需直接提供静态index.html：

1. Dockerfile添加环境变量：

   Dockerfile
   ENV STATIC_INDEX 1  
   

2. 确保./app/static/index.html存在，并在main.py中处理静态路由（参考原文档示例）。

高级配置

• 自定义端口：

  Dockerfile
  ENV LISTEN_PORT 8080  
  EXPOSE 8080  
  

• 最大上传大小：

  Dockerfile
  ENV NGINX_MAX_UPLOAD 1m  # 限制为1MB  
  

• 静态文件路径：

  Dockerfile
  ENV STATIC_PATH /app/custom_static  # 自定义静态目录  
  

• 预启动脚本：在./app目录添加prestart.sh（如执行数据库迁移），镜像会自动执行。

开发热更新

通过卷映射实时更新代码：

bash
docker run -d --name my-dev-container -p 80:80 -v $(pwd)/app:/app my-flask-app  

（需确保./app目录包含uwsgi.ini文件）