Windows Server環(huán)境下使用Nginx部署Flask應用的全過程
更新時間:2025年04月24日 09:28:59 作者:老胖閑聊
Flask是一個輕量級的Python Web框架,它允許開發(fā)者快速搭建Web應用或服務,Nginx是一款高性能的HTTP和反向代理服務器,用于部署靜態(tài)文件服務、負載均衡以及作為HTTP緩存等,本文給大家介紹了Windows Server環(huán)境下使用Nginx部署Flask應用的全過程,需要的朋友可以參考下
1. 環(huán)境準備
- 操作系統(tǒng): Windows Server 2016/2019/2022
- Python: 安裝最新穩(wěn)定版(如 Python 3.10+),確保勾選
Add Python to PATH
。 - Nginx for Windows: 從 官網(wǎng) 下載 Windows 版本(如 nginx/Windows-1.25.3)。
- 依賴工具: Git(可選,用于代碼拉取)、文本編輯器(如 VS Code)。
2. 創(chuàng)建 Flask 應用
2.1 項目結構
C:\flask-app\ ├── app.py # Flask 主程序 ├── requirements.txt ├── static\ # 靜態(tài)文件 └── venv\ # Python 虛擬環(huán)境
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 安裝依賴
# 創(chuàng)建虛擬環(huán)境 python -m venv venv venv\Scripts\activate # 安裝 Flask 和 Waitress(生產(chǎn)級 WSGI 服務器) pip install flask waitress
3. 使用 Waitress 啟動 Flask
3.1 啟動命令
waitress-serve --port=5000 --threads=4 app:app
- 參數(shù)說明:
--port
: 監(jiān)聽端口--threads
: 線程數(shù)(根據(jù) CPU 核心調整)
3.2 創(chuàng)建啟動腳本 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 監(jiān)聽地址 } server { listen 80; server_name your_domain.com; # 替換為域名或服務器 IP # 靜態(tài)文件處理(由 Nginx 直接代理) location /static { alias C:/flask-app/static; # 替換為實際路徑 expires 30d; } # 動態(tài)請求代理到 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.exe
- 注冊 Nginx 服務:
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 靜態(tài)文件 404
- 錯誤: 瀏覽器無法加載
/static/style.css
- 解決: 確保 Nginx 配置中的
alias
路徑使用正斜杠(C:/flask-app/static
),且目錄存在。
6.3 Nginx 502 Bad Gateway
- 原因: Nginx 無法連接后端 Flask 服務。
- 排查:
- 檢查 Waitress 是否運行 (
tasklist | findstr waitress
)。 - 檢查防火墻是否允許端口 5000。
- 檢查 Waitress 是否運行 (
7. 擴展知識
7.1 啟用 HTTPS
- 使用 Let’s Encrypt 獲取免費證書(需域名)。
- 修改 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. 注意事項
- 生產(chǎn)環(huán)境禁用調試模式: 確保 Flask 的
app.run(debug=False)
。 - 日志管理: 配置 Nginx 和 Flask 的日志路徑,定期歸檔。
- 備份配置: 修改關鍵文件前備份(如
nginx.conf
)。
通過以上步驟, Flask 應用將在 Windows Server 上以高可靠性的方式運行,并通過 Nginx 實現(xiàn)高效反向代理和靜態(tài)資源加速。
以上就是Windows Server環(huán)境下使用Nginx部署Flask應用的全過程的詳細內容,更多關于Nginx部署Flask應用的資料請關注腳本之家其它相關文章!
相關文章
nginx服務器access日志中大量400 bad request錯誤的解決方法
這篇文章主要介紹了nginx服務器access日志中大量400 bad request錯誤的解決方法,本文結論是空主機頭導致的大量400錯誤日志,關閉默認主機的日志記錄就可以解決問題,需要的朋友可以參考下2015-01-01Nginx 只允許 www 域名訪問并禁止裸域名訪問的實現(xiàn)步驟
通過Nginx配置,可以設定僅允許www域名訪問,禁止或重定向裸域名,提升網(wǎng)站品牌統(tǒng)一性及用戶體驗,設置包括創(chuàng)建針對www的虛擬主機,禁止裸域名訪問,并可選進行裸域名到www的301重定向,完成后,重啟Nginx服務器使配置生效2024-10-10詳解nginx配置location總結及rewrite規(guī)則寫法
本篇文章主要介紹了詳解nginx配置location總結及rewrite規(guī)則寫法,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-02-02