Flask 是 Python 輕量級 Web 框架的代表作,但開發環境的內建伺服器不適合生產環境。本文記錄在 Mac OS 上,如何從零開始部署 Nginx 反向代理、FastCGI 協議與 Flask 應用(以官方範例 Flaskr 為例),打造一個可上線的生產級環境。
使用 Homebrew 一鍵安裝:
$ brew install nginx
安裝完成後,Nginx 版本為 1.6.2,設定檔位於 /usr/local/etc/nginx/nginx.conf。啟動指令:
$ nginx
預設監聽 8080 端口,瀏覽 https://localhost:8080 即可見到歡迎頁面。

修改 nginx.conf,將動態請求轉發給 FastCGI:
server {
listen 80;
server_name localhost;
charset utf-8;
location / {
try_files $uri @flaskr;
}
location @flaskr {
include fastcgi_params;
fastcgi_param PATH_INFO $fastcgi_script_name;
fastcgi_param SCRIPT_NAME "";
fastcgi_pass unix:/tmp/flaskr-fcgi.sock;
}
}
因使用 80 端口需 root 權限:
$ nginx -s quit
$ sudo nginx

此時會出現錯誤,因為 Flask 應用尚未啟動。
Nginx 只處理靜態檔案,動態請求需透過 FastCGI 轉交給 Python 應用。安裝 flup:
$ pip install flup
在專案目錄建立 flaskr.fcgi 啟動腳本:
#!/usr/bin/python
from flup.server.fcgi import WSGIServer
from flaskr import app
if __name__ == '__main__':
WSGIServer(app, bindAddress='/tmp/flaskr-fcgi.sock').run()
賦予執行權限並啟動(建議使用 screen 或 nohup 置於背景):
$ chmod +x flaskr.fcgi
$ screen
$ ./flaskr.fcgi
# 或
$ nohup ./flaskr.fcgi &
首次啟動可能遇到 Nginx 無權存取 socket 檔案。修改 nginx.conf 加入 user 指令:
user wzy wheel;
關鍵點:若只寫 user wzy;,Nginx 會嘗試尋找同名群組 wzy,不存在則報錯。必須顯式指定群組(Mac 上通常為 wheel)。
Syntax: user user [group];
Default: user nobody nobody;
修正後重啟 Nginx,應用即可正常訪問。
這套架構在 Linux 生產環境同樣適用,只需調整路徑與權限設定。