萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Mac OS 部署 Nginx + FastCGI + Flask 完整教學:從安裝到上線

Flask 是 Python 輕量級 Web 框架的代表作,但開發環境的內建伺服器不適合生產環境。本文記錄在 Mac OS 上,如何從零開始部署 Nginx 反向代理、FastCGI 協議與 Flask 應用(以官方範例 Flaskr 為例),打造一個可上線的生產級環境。

環境準備與 Nginx 安裝

使用 Homebrew 一鍵安裝:

$ brew install nginx

安裝完成後,Nginx 版本為 1.6.2,設定檔位於 /usr/local/etc/nginx/nginx.conf。啟動指令:

$ nginx

預設監聽 8080 端口,瀏覽 https://localhost:8080 即可見到歡迎頁面。

Nginx 反向代理設定

修改 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 應用尚未啟動。

FastCGI 伺服器啟動(flup)

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,應用即可正常訪問。

架構總結

  • Nginx:靜態資源服務 + 反向代理(80 端口)
  • FastCGI (flup):協議轉換器,管理 Unix Socket
  • Flask 應用:運行於 FastCGI Server 之上

這套架構在 Linux 生產環境同樣適用,只需調整路徑與權限設定。

copyright © 萬盛學電腦網 all rights reserved