Windows Server环境下使用Nginx部署Flask应用的全过程

 更新时间:2025年04月24日 09:28:59   作者:老胖闲聊  
Flask是一个轻量级的Python Web框架,它允许开发者快速搭建Web应用或服务,Nginx是一款高性能的HTTP和反向代理服务器,用于部署静态文件服务、负载均衡以及作为HTTP缓存等,本文给大家介绍了Windows Server环境下使用Nginx部署Flask应用的全过程,需要的朋友可以参考下

1. 环境准备

  1. 操作系统: Windows Server 2016/2019/2022
  2. Python: 安装最新稳定版(如 Python 3.10+),确保勾选 Add Python to PATH
  3. Nginx for Windows: 从 官网 下载 Windows 版本(如 nginx/Windows-1.25.3)。
  4. 依赖工具: Git(可选,用于代码拉取)、文本编辑器(如 VS Code)。

2. 创建 Flask 应用

2.1 项目结构

C:\flask-app\
   ├── app.py          # Flask 主程序
   ├── requirements.txt
   ├── static\         # 静态文件
   └── venv\           # Python 虚拟环境

2.2 示例 app.py

from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return "Hello, World! Flask on Windows Server with Nginx!"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

2.3 安装依赖

# 创建虚拟环境
python -m venv venv
venv\Scripts\activate

# 安装 Flask 和 Waitress(生产级 WSGI 服务器)
pip install flask waitress

3. 使用 Waitress 启动 Flask

3.1 启动命令

waitress-serve --port=5000 --threads=4 app:app
  • 参数说明:
    • --port: 监听端口
    • --threads: 线程数(根据 CPU 核心调整)

3.2 创建启动脚本 start_server.bat

@echo off
call venv\Scripts\activate
waitress-serve --port=5000 --threads=4 app:app

4. 配置 Nginx 反向代理

4.1 修改 Nginx 配置文件 nginx.conf

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    # 反向代理配置
    upstream flask_app {
        server 127.0.0.1:5000;  # Waitress 监听地址
    }

    server {
        listen       80;
        server_name  your_domain.com;  # 替换为域名或服务器 IP

        # 静态文件处理(由 Nginx 直接代理)
        location /static {
            alias C:/flask-app/static;  # 替换为实际路径
            expires 30d;
        }

        # 动态请求代理到 Flask
        location / {
            proxy_pass http://flask_app;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

4.2 启动 Nginx

# 检查配置语法
nginx -t

# 启动 Nginx
start nginx

# 重启(修改配置后)
nginx -s reload

5. 配置 Windows 服务(开机自启)

5.1 使用 NSSM 工具(推荐)

nssm install Nginx "C:\nginx\nginx.exe"  # 替换为 Nginx 实际路径
nssm start Nginx
  • 注册 Waitress 服务:
nssm install FlaskApp "C:\flask-app\venv\Scripts\python.exe" "C:\flask-app\venv\Scripts\waitress-serve.exe" --port=5000 app:app
nssm start FlaskApp

6. 常见问题与解决方案

6.1 端口冲突

  • 错误bind() to 0.0.0.0:5000 failed: 仅允许使用一个套接字地址
  • 解决: 检查是否有其他程序占用端口,使用 netstat -ano | findstr :5000 并终止进程。

6.2 静态文件 404

  • 错误: 浏览器无法加载 /static/style.css
  • 解决: 确保 Nginx 配置中的 alias 路径使用正斜杠(C:/flask-app/static),且目录存在。

6.3 Nginx 502 Bad Gateway

  • 原因: Nginx 无法连接后端 Flask 服务。
  • 排查:
    1. 检查 Waitress 是否运行 (tasklist | findstr waitress)。
    2. 检查防火墙是否允许端口 5000。

7. 扩展知识

7.1 启用 HTTPS

  1. 使用 Let’s Encrypt 获取免费证书(需域名)。
  2. 修改 Nginx 配置:
server {
    listen 443 ssl;
    ssl_certificate     C:/ssl/your_domain.crt;
    ssl_certificate_key C:/ssl/your_domain.key;
    # ... 其他配置
}

7.2 负载均衡

upstream flask_app {
    server 127.0.0.1:5000;
    server 127.0.0.1:5001;  # 启动第二个实例
    least_conn;  # 使用最少连接算法
}

8. 注意事项

  1. 生产环境禁用调试模式: 确保 Flask 的 app.run(debug=False)
  2. 日志管理: 配置 Nginx 和 Flask 的日志路径,定期归档。
  3. 备份配置: 修改关键文件前备份(如 nginx.conf)。

通过以上步骤, Flask 应用将在 Windows Server 上以高可靠性的方式运行,并通过 Nginx 实现高效反向代理和静态资源加速。

以上就是Windows Server环境下使用Nginx部署Flask应用的全过程的详细内容,更多关于Nginx部署Flask应用的资料请关注脚本之家其它相关文章!

相关文章

  • Nginx中配置用户服务器访问认证的方法示例

    Nginx中配置用户服务器访问认证的方法示例

    这篇文章主要介绍了Nginx中配置用户服务器访问认证的方法示例,包括一个用perl脚本来实现的方法,需要的朋友可以参考下
    2016-01-01
  • nginx服务器access日志中大量400 bad request错误的解决方法

    nginx服务器access日志中大量400 bad request错误的解决方法

    这篇文章主要介绍了nginx服务器access日志中大量400 bad request错误的解决方法,本文结论是空主机头导致的大量400错误日志,关闭默认主机的日志记录就可以解决问题,需要的朋友可以参考下
    2015-01-01
  • nginx http 499错误码详解以及解决办法

    nginx http 499错误码详解以及解决办法

    HTTP状态码出现499错误有多种情况,499错误是什么?这篇文章主要给大家介绍了关于nginx http 499错误码以及解决办法的相关资料,文中介绍的非常详细,需要的朋友可以参考下
    2024-01-01
  • Nginx 只允许 www 域名访问并禁止裸域名访问的实现步骤

    Nginx 只允许 www 域名访问并禁止裸域名访问的实现步骤

    通过Nginx配置,可以设定仅允许www域名访问,禁止或重定向裸域名,提升网站品牌统一性及用户体验,设置包括创建针对www的虚拟主机,禁止裸域名访问,并可选进行裸域名到www的301重定向,完成后,重启Nginx服务器使配置生效
    2024-10-10
  • 配置nginx 重定向到系统维护页面

    配置nginx 重定向到系统维护页面

    今天抽时间给大家普及nginx 重定向到系统维护页面的配置内容,nginx重定向问题说起来也很简单,因为重定向后直接跳转到静态页面,不需要后续操作和记录,所以直接301永久重定向。今天简单给大家介绍配置方法,一起看看吧
    2021-06-06
  • Nginx请求转发配置指南

    Nginx请求转发配置指南

    Nginx 是一款高性能的 HTTP 和反向代理服务器,也是一个 IMAP/POP3/SMTP 代理服务器,本文档将介绍如何使用 Nginx 配置请求转发,并解释一些常用的配置参数,需要的朋友可以参考下
    2024-10-10
  • 详解nginx配置location总结及rewrite规则写法

    详解nginx配置location总结及rewrite规则写法

    本篇文章主要介绍了详解nginx配置location总结及rewrite规则写法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-02-02
  • win10系统安装Nginx的详细步骤

    win10系统安装Nginx的详细步骤

    Nginx是一款自由的、开源的、高性能的HTTP服务器和反向代理服务器,同时也提供了IMAP/POP3/SMTP服务,这篇文章主要介绍了win10系统安装Nginx的详细步骤,需要的朋友可以参考下
    2023-02-02
  • nginx+lua单机上万并发的实现

    nginx+lua单机上万并发的实现

    nginx是我们最常用的服务器,常用于做内容分发和反向代理,本文主要介绍了nginx+lua单机上万并发的实现,有兴趣的可以了解下
    2021-05-05
  • 详解如何修改nginx的默认端口

    详解如何修改nginx的默认端口

    这篇文章主要介绍了详解如何修改nginx的默认端口,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-03-03

最新评论