Nginx 以高併發、低記憶體著稱,搭配 Python Web 框架需透過 FastCGI、uWSGI 或 HTTP 反向代理 介接。本文記錄早期 spawn-fcgi + flup 架構下部署 web.py 與 Django 的實作細節,並對比現代 uWSGI / Gunicorn 方案。
#!/bin/bash
# 編譯腳本範例
src_base_dir=$(pwd)
src_openssl=$src_base_dir/openssl-1.1.1w
src_pcre=$src_base_dir/pcre-8.45
src_nginx=$src_base_dir/nginx-1.25.3
dest_nginx=$src_base_dir/release/nginx
tar xzf openssl-1.1.1w.tar.gz
tar xzf pcre-8.45.tar.gz
tar xzf nginx-1.25.3.tar.gz
cd $src_nginx
./configure \
--prefix=$dest_nginx \
--with-http_ssl_module \
--with-http_stub_status_module \
--with-openssl=$src_openssl \
--with-pcre=$src_pcre \
--with-http_v2_module \
--with-http_realip_module
make -j$(nproc) && make install
# /etc/nginx/fastcgi_params 補充
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param QUERY_STRING $query_string;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;
fastcgi_param GATEWAY_INTERFACE CGI/1.1;
fastcgi_param SERVER_SOFTWARE nginx/$nginx_version;
fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param REMOTE_PORT $remote_port;
fastcgi_param SERVER_ADDR $server_addr;
fastcgi_param SERVER_PORT $server_port;
fastcgi_param SERVER_NAME $server_name;
fastcgi_param SERVER_PROTOCOL $server_protocol;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_script_name;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
server {
listen 80;
server_name example.com;
location / {
# TCP socket 方式
fastcgi_pass 127.0.0.1:9002;
# 或 UNIX socket(效能較好)
# fastcgi_pass unix:/var/run/webpy.sock;
include fastcgi_params;
}
# Django Admin 靜態檔
location /admin_media {
alias /usr/local/lib/python2.7/site-packages/django/contrib/admin/media;
}
# 專案靜態檔
location /static {
alias /var/www/project/static;
expires 30d;
}
# 使用者上傳媒體
location /media {
alias /var/www/project/media;
expires 7d;
}
}
pip install web.py flup
# 或編譯安裝 spawn-fcgi
#!/usr/bin/env python
# -*- coding: utf-8 -*-
import web
urls = ("/.*", "hello")
app = web.application(urls, globals())
class hello:
def GET(self):
return "Hello, world!"
if __name__ == "__main__":
# 讓 web.py 支援 FastCGI
web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr)
app.run()
# TCP 模式
spawn-fcgi -a 127.0.0.1 -p 9002 -f /var/www/webpy/index.py -P /var/run/webpy.pid -u www-data -g www-data
# UNIX socket 模式(推薦)
spawn-fcgi -s /var/run/webpy.sock -f /var/www/webpy/index.py -P /var/run/webpy.pid -u www-data -g www-data -M 660
kill -TERM $(cat /var/run/webpy.pid)
# 或強制
kill -9 $(cat /var/run/webpy.pid)
pip install flup
# start.sh
#!/bin/bash
cd /var/www/django/mysite
python manage.py runfcgi daemonize=true \
pidfile=/var/run/django.pid \
socket=/var/run/django.sock \
maxrequests=1000 \
minspare=2 \
maxspare=5 \
maxchildren=10 \
method=prefork \
outlog=/var/log/django-fcgi.log \
errlog=/var/log/django-fcgi.err
location / {
fastcgi_pass unix:/var/run/django.sock;
include fastcgi_params;
}
FastCGI + spawn-fcgi 已過時,缺乏進程管理、健康檢查、平滑重載、指標暴露等生產級功能。現代標準架構:
| 組件 | 角色 | 推薦版本 |
|---|---|---|
| Nginx | 靜態檔、SSL 終結、反向代理、限流、快取 | 1.24+ (Mainline) |
| Gunicorn | WSGI HTTP Server,prefork/worker/gevent worker | 21.0+ |
| uWSGI | 功能豐富的應用伺服器,支援 Emperor 模式多應用管理 | 2.0.22+ |
| systemd | 進程監督、自動重啟、資源限制、日誌整合 | — |
# /etc/systemd/system/gunicorn.service
[Unit]
Description=Gunicorn Django App
After=network.target
[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/myproject
Environment=DJANGO_SETTINGS_MODULE=myproject.settings
ExecStart=/opt/venv/myproject/bin/gunicorn \
--workers 4 \
--worker-class gthread \
--threads 8 \
--bind unix:/run/gunicorn.sock \
--access-logfile /var/log/gunicorn/access.log \
--error-logfile /var/log/gunicorn/error.log \
--capture-output \
myproject.wsgi:application
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
# Nginx 反向代理
location / {
proxy_pass https://unix:/run/gunicorn.sock;
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;
proxy_read_timeout 60s;
proxy_send_timeout 60s;
}
# /etc/uwsgi/emperor.ini
[uwsgi]
emperor = /etc/uwsgi/vassals
uid = www-data
gid = www-data
logto = /var/log/uwsgi/emperor.log
# /etc/uwsgi/vassals/app1.ini
[uwsgi]
chdir = /var/www/app1
module = wsgi:application
socket = /run/uwsgi/app1.sock
chmod-socket = 660
processes = 2
threads = 10
master = true
vacuum = true
啟用:systemctl enable --now uwsgi-emperor。新增應用只需在 vassals 目錄放入 .ini,Emperor 自動偵測啟動/重載/停止。
CPU 核心數 × 2 + 1(CPU 密集型),或更高(I/O 密集型配合 gevent/eventlet)。worker_connections、keepalive_timeout、proxy_buffering。proxy_cache_path、fastcgi_cache、uwsgi_cache。gzip on; gzip_types text/css application/javascript application/json;。