萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx + Python 部署指南:web.py 與 Django 於 FastCGI/uWSGI 架構下的實作

Nginx 以高併發、低記憶體著稱,搭配 Python Web 框架需透過 FastCGI、uWSGI 或 HTTP 反向代理 介接。本文記錄早期 spawn-fcgi + flup 架構下部署 web.py 與 Django 的實作細節,並對比現代 uWSGI / Gunicorn 方案。

一、Nginx 編譯安裝(支援 SSL、Rewrite、FastCGI)


#!/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

二、Nginx FastCGI 通用配置片段


# /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;
    }
}

三、部署 web.py(輕量框架)

1. 依賴安裝


pip install web.py flup
# 或編譯安裝 spawn-fcgi

2. 應用程式碼 (index.py)


#!/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()

3. 啟動 FastCGI 進程


# 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

4. 停止與重啟


kill -TERM $(cat /var/run/webpy.pid)
# 或強制
kill -9 $(cat /var/run/webpy.pid)

四、部署 Django(FastCGI 方式,舊版)

1. 依賴


pip install flup

2. 啟動管理腳本


# 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

3. Nginx 指向 UNIX socket


location / {
    fastcgi_pass unix:/var/run/django.sock;
    include fastcgi_params;
}

五、現代化遷移:uWSGI / Gunicorn + Nginx

FastCGI + spawn-fcgi 已過時,缺乏進程管理、健康檢查、平滑重載、指標暴露等生產級功能。現代標準架構:

組件角色推薦版本
Nginx靜態檔、SSL 終結、反向代理、限流、快取1.24+ (Mainline)
GunicornWSGI HTTP Server,prefork/worker/gevent worker21.0+
uWSGI功能豐富的應用伺服器,支援 Emperor 模式多應用管理2.0.22+
systemd進程監督、自動重啟、資源限制、日誌整合—

Gunicorn + Nginx 範例


# /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;
}

uWSGI Emperor 多應用管理


# /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 自動偵測啟動/重載/停止。

六、效能調優關鍵參數

  • Worker 數:CPU 核心數 × 2 + 1(CPU 密集型),或更高(I/O 密集型配合 gevent/eventlet)。
  • 連線池:Nginx worker_connections、keepalive_timeout、proxy_buffering。
  • 快取:proxy_cache_path、fastcgi_cache、uwsgi_cache。
  • 壓縮:gzip on; gzip_types text/css application/javascript application/json;。
copyright © 萬盛學電腦網 all rights reserved