在 Windows 生產(chǎn)環(huán)境中部署 Flask 應(yīng)用，你需要使用 Windows 兼容的 WSGI 服務(wù)器（如 Waitress、Hypercorn）以及 Windows 服務(wù)管理工具（如 NSSM 或直接使用 Python 的 win32service）。本文將為你提供一套完整的 Windows 系統(tǒng) Flask 部署方案，并對(duì)比與 Linux 方式的異同。

Windows 部署 Flask 的完整方案

核心組件替換說(shuō)明

注意：Hypercorn 支持 HTTP/2 和 ASGI，但配置稍復(fù)雜；Waitress 簡(jiǎn)單穩(wěn)定，是 Flask 官方推薦的生產(chǎn)服務(wù)器之一。

一、使用 Waitress + NSSM 部署 Flask（推薦）

1. 環(huán)境準(zhǔn)備

• Windows Server 2016+ 或 Windows 10/11（專業(yè)版/企業(yè)版）
• Python 3.8+ 已安裝并加入 PATH
• 你的 Flask 項(xiàng)目（例如 C:\myapp\app.py）

2. 安裝依賴

在項(xiàng)目目錄創(chuàng)建虛擬環(huán)境（強(qiáng)烈推薦）：

cd C:\myapp
python -m venv venv
venv\Scripts\activate
pip install flask waitress

3. 創(chuàng)建啟動(dòng)腳本

由于 NSSM 需要執(zhí)行一個(gè) .bat 或 .exe，我們編寫(xiě)一個(gè) Python 啟動(dòng)腳本 run.py，它使用 Waitress 運(yùn)行 Flask 應(yīng)用：

# run.py
from waitress import serve
from app import app   # 假設(shè)你的 Flask 實(shí)例名為 app
if __name__ == '__main__':
    # 監(jiān)聽(tīng)所有IP的8080端口，生產(chǎn)環(huán)境建議綁定內(nèi)網(wǎng)IP并通過(guò)反向代理（如 Nginx）暴露
    serve(app, host='0.0.0.0', port=8080, threads=4)

測(cè)試腳本是否能正常運(yùn)行：

python run.py

訪問(wèn) http://localhost:8080 看到 Flask 輸出即為成功。

4. 使用 NSSM 注冊(cè)為 Windows 服務(wù)

下載 NSSM（官網(wǎng)），將 nssm.exe 放在 C:\Windows\System32 或項(xiàng)目目錄下。

以管理員身份打開(kāi)命令提示符，執(zhí)行：

nssm install FlaskApp

彈出 GUI 配置界面：

• Path: C:\myapp\venv\Scripts\python.exe
• Startup directory: C:\myapp
• Arguments: run.py
• Service name: FlaskApp（可自定義）

點(diǎn)擊 “Install service”。

然后啟動(dòng)服務(wù)：

nssm start FlaskApp

檢查狀態(tài)：

nssm status FlaskApp

5. 設(shè)置服務(wù)開(kāi)機(jī)自啟

NSSM 安裝的服務(wù)默認(rèn)就是“自動(dòng)”啟動(dòng)類型，可以在 Windows 服務(wù)管理器（services.msc）中確認(rèn)。

6. 查看日志與崩潰自動(dòng)重啟

NSSM 默認(rèn)會(huì)將 stdout/stderr 重定向到文件。在 NSSM GUI 的 “I/O” 選項(xiàng)卡中可以設(shè)置日志文件路徑：

• Output (stdout): C:\myapp\logs\service-out.log
• Error (stderr): C:\myapp\logs\service-err.log

并勾選 “Redirect error output to stdout” 簡(jiǎn)化。

在 “Process” 選項(xiàng)卡中：

• Exit action: Restart（進(jìn)程意外退出時(shí)自動(dòng)重啟）
• Restart delay: 5000（毫秒）

7. 常用 NSSM 命令

nssm restart FlaskApp    # 重啟服務(wù)
nssm stop FlaskApp       # 停止
nssm remove FlaskApp     # 刪除服務(wù)（需加 confirm 參數(shù)）

二、使用 Waitress + 任務(wù)計(jì)劃程序（無(wú)第三方工具）

如果不想安裝 NSSM，可以用 Windows 任務(wù)計(jì)劃程序創(chuàng)建一個(gè)“不管用戶是否登錄都運(yùn)行”的任務(wù)，并設(shè)置觸發(fā)器為“啟動(dòng)時(shí)”，以及“如果失敗則重啟”。缺點(diǎn)是配置較繁瑣，且重啟策略不如 NSSM 靈活。

步驟簡(jiǎn)述：

創(chuàng)建啟動(dòng)腳本 start.bat：

@echo off
cd C:\myapp
call venv\Scripts\activate
python run.py

打開(kāi)“任務(wù)計(jì)劃程序” → “創(chuàng)建任務(wù)”：

• 常規(guī)：勾選“不管用戶是否登錄都運(yùn)行”，使用最高權(quán)限。
• 觸發(fā)器：新建“啟動(dòng)時(shí)”。
• 操作：?jiǎn)?dòng)程序 cmd.exe，參數(shù) /c "C:\myapp\start.bat"。
• 條件：取消所有“只有在以下網(wǎng)絡(luò)連接可用時(shí)才啟動(dòng)”等選項(xiàng)。
• 設(shè)置：勾選“如果任務(wù)失敗，按以下頻率重啟”，例如每5分鐘重啟一次，最多3次。

這種方法不推薦用于生產(chǎn)環(huán)境，因?yàn)檫M(jìn)程管理能力弱，無(wú)優(yōu)雅停止。

三、Windows 部署的注意事項(xiàng)

1. 反向代理

Windows 下同樣建議在 Waitress 前面加一層 Nginx for Windows 或 IIS 做反向代理，用于：

• 提供靜態(tài)文件服務(wù)（Waitress 不擅長(zhǎng)）
• 負(fù)載均衡
• HTTPS 卸載

Nginx for Windows 配置與 Linux 類似，下載官方 Windows 版本即可。

2. 日志輪轉(zhuǎn)

在 run.py 中配置 Python logging 的 RotatingFileHandler：

import logging
from logging.handlers import RotatingFileHandler
handler = RotatingFileHandler('app.log', maxBytes=10*1024*1024, backupCount=5)
handler.setFormatter(logging.Formatter('%(asctime)s %(levelname)s: %(message)s'))
app.logger.addHandler(handler)
app.logger.setLevel(logging.INFO)

3. 性能調(diào)優(yōu)

• Waitress 的 threads 參數(shù)建議設(shè)置為 CPU 核心數(shù)的 2-4 倍。
• 如果遇到高并發(fā)，可以增加 asyncore 或使用 Hypercorn 配合 uvloop（但 Windows 上 uvloop 不可用，性能不如 Linux）。

4. 防火墻與端口

確保 Windows 防火墻允許外部訪問(wèn)你的端口（例如 8080）：

netsh advfirewall firewall add rule name="Flask App" dir=in action=allow protocol=TCP localport=8080

四、修改代碼后如何重新部署

使用 NSSM

由于 NSSM 只是管理進(jìn)程，修改代碼后需要重啟服務(wù)才能加載新代碼：

nssm restart FlaskApp

注意：restart 會(huì)立即殺死當(dāng)前進(jìn)程，可能導(dǎo)致正在處理的請(qǐng)求失敗。要實(shí)現(xiàn)優(yōu)雅重啟，Waitress 本身不支持熱重載，你可以在代碼中使用 watchdog 庫(kù)監(jiān)聽(tīng)文件變化并觸發(fā) sys.exit()，配合 NSSM 的自動(dòng)重啟策略，但較為復(fù)雜。更簡(jiǎn)單的做法是：在低流量時(shí)段重啟，或使用負(fù)載均衡摘除節(jié)點(diǎn)。

使用任務(wù)計(jì)劃程序

手動(dòng)停止任務(wù)（在任務(wù)計(jì)劃程序庫(kù)中右鍵結(jié)束），然后重新啟動(dòng)任務(wù)。

五、與 Linux 部署方式的異同總結(jié)

結(jié)論：

• 如果生產(chǎn)環(huán)境是 Windows Server，使用 Waitress + NSSM 是最穩(wěn)定、最接近 Linux 體驗(yàn)的方案。
• 如果追求更高性能，建議將應(yīng)用容器化（Docker for Windows）或直接遷移到 Linux 服務(wù)器。
• 不推薦 使用 flask run 或內(nèi)置服務(wù)器用于生產(chǎn)，無(wú)論何種平臺(tái)。

六、完整示例腳本

為了方便，提供一個(gè)完整的 run.py 示例，包含日志配置和 Waitress 啟動(dòng)：

import logging
from logging.handlers import RotatingFileHandler
from waitress import serve
from app import app
# 配置日志
if not app.debug:
    handler = RotatingFileHandler('logs/app.log', maxBytes=10*1024*1024, backupCount=5)
    handler.setLevel(logging.INFO)
    formatter = logging.Formatter('%(asctime)s %(levelname)s: %(message)s')
    handler.setFormatter(formatter)
    app.logger.addHandler(handler)
    app.logger.setLevel(logging.INFO)
    app.logger.info('Flask app starting')
if __name__ == '__main__':
    serve(app, host='0.0.0.0', port=8080, threads=4)

記得創(chuàng)建 logs 文件夾。

希望這份 Windows 部署教程能幫助你順利完成 Flask 項(xiàng)目的生產(chǎn)環(huán)境部署。如果你的環(huán)境可以換成 Linux，強(qiáng)烈建議使用 Linux 以獲得更成熟、高性能的工具鏈。

以上就是在Windows環(huán)境下部署Flask的完整方案的詳細(xì)內(nèi)容，更多關(guān)于Windows部署Flask方案的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論