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 目录密码保护的设置方法

    比如要对 网站目录下的 test 文件夹 进行加密认证
    2010-12-12
  • Nginx服务器屏蔽与禁止屏蔽网络爬虫的方法

    Nginx服务器屏蔽与禁止屏蔽网络爬虫的方法

    今天小编就为大家分享一篇关于Nginx服务器屏蔽与禁止屏蔽网络爬虫的方法,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-03-03
  • nginx如何配置部署一个域名,多个端口

    nginx如何配置部署一个域名,多个端口

    文章主要讲述了在Windows下使用Nginx部署服务器的过程,包括配置Nginx、部署前端和后端项目、设置反向代理以及部署多个不同端口的项目
    2026-03-03
  • Nginx重定向后请求参数丢失的原因分析及解决方案

    Nginx重定向后请求参数丢失的原因分析及解决方案

    在日常开发和运维中,我们经常会遇到需要使用 Nginx 进行反向代理的场景,但在配置 proxy_pass 时,有时候可能会遇到请求参数丢失的问题,在这篇文章中,我们将会详细探讨这个问题并给出几种解决方案,需要的朋友可以参考下
    2023-11-11
  • Nginx实现清除缓存内容

    Nginx实现清除缓存内容

    NGINX可以从缓存中删除旧的和过期的缓存文件,本文主要介绍了Nginx实现清除缓存内容,具有一定的参考价值,感兴趣的可以了解一下
    2024-08-08
  • 详解nginx 配置文件解读

    详解nginx 配置文件解读

    这篇文章主要介绍了详解nginx 配置文件解读,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-07-07
  • nginx的zabbix 5.0安装部署的方法步骤

    nginx的zabbix 5.0安装部署的方法步骤

    之前大家可能经常会基于apache去部署zabbix,但是这样会偶尔遇到一些问题,今天小编就带大家操作一下基于nginx的zabbix5.0的部署。感兴趣的可以了解一下
    2021-07-07
  • nginx try_files指令的实现示例

    nginx try_files指令的实现示例

    try_files用于指定文件的查找规则,可以配置多个规则,会按顺序执行查找规则,本文主要介绍了nginx try_files指令的实现示例,具有一定的参考价值,感兴趣的可以了解一下
    2024-07-07
  • Nginx如何进行流量按比例转发

    Nginx如何进行流量按比例转发

    Nginx 可以借助split_clients指令或通过 weight 参数以及 Lua 脚本实现流量按比例转发,下面小编就为大家介绍一下两种方式具体的操作步骤吧
    2025-03-03
  • keepalived结合nginx实现nginx高可用的方法

    keepalived结合nginx实现nginx高可用的方法

    这篇文章主要介绍了keepalived结合nginx实现nginx高可用的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03

最新评论