萬盛學電腦網

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

Nginx + uWSGI 部署 Python 應用:從單站到多站虛擬主機完整配置

uWSGI 是功能最豐富的 Python 應用伺服器,支援 WSGI、uwsgi、HTTP、FastCGI 多種協定,內建進程管理、緩存、路由、訂閱、Emperor 多應用編排。配合 Nginx 反向代理,是現代 Python 生產部署的黃金組合。

一、快速安裝(Ubuntu/Debian)


# 官方 PPA(較新版本)
add-apt-repository ppa:stevecrozz/ppa
apt-get update
apt-get install uwsgi uwsgi-plugin-python3

# 或使用 pip(虛擬環境內)
pip install uwsgi

二、最小化單站部署

1. Nginx 配置


# /etc/nginx/sites-available/myapp
server {
    listen 80;
    server_name myapp.example.com;

    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:9090;  # 或 unix:/run/uwsgi/myapp.sock
    }

    location /static {
        alias /var/www/myapp/static;
        expires 30d;
    }
}

2. uWSGI 啟動


# 專案 wsgi.py 模組變數名為 application
uwsgi --http-socket :9090 --module myapp.wsgi:application --master --processes 4 --threads 2

3. Django 專案 wsgi.py 標準內容


# myapp/wsgi.py
import os
from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myapp.settings')
application = get_wsgi_application()

三、uWSGI 核心參數速查

參數說明建議值
--socket / --http-socket監聽位址(UNIX socket 較快、安全)unix:/run/uwsgi/app.sock
--moduleWSGI 模組路徑 pkg.module:applicationmyproject.wsgi:application
--master啟用 Master 進程(管理 worker、平滑重載)必開
--processes / -pWorker 進程數CPU 核心數 × 2
--threads每進程執行緒數10-64 (I/O 密集)
--harakiri請求超時秒數(殺掉卡住 worker)30-60
--limit-as單進程虛擬記憶體上限(MB)256-1024
--max-requests處理 N 請求後重啟 worker(防記憶體洩漏)1000-5000
--daemonize前台/後台模式與日誌檔/var/log/uwsgi/app.log
--vhost虛擬主機模式(動態載入應用)多站共用一 uWSGI 實例
--pythonpath加入 Python 搜尋路徑/var/www/myapp
--chdir切換工作目錄/var/www/myapp
--virtualenv指定虛擬環境路徑/opt/venv/myapp
--env設定環境變數DJANGO_SETTINGS_MODULE=prod

四、多站點共用單一 uWSGI 實例(Virtualhosting Mode)

1. 啟用虛擬主機模式


uwsgi --socket :9090 --master --processes 4 --threads 10 --vhost \
  --limit-as 128 --harakiri 30 --max-requests 10000 \
  --daemonize /var/log/uwsgi/emperor.log

2. 建立共用虛擬環境


apt-get install python3-virtualenv
virtualenv /var/www/shared-env
source /var/www/shared-env/bin/activate
pip install django flask requests ...

3. Nginx 站點配置(每站一個 server 區塊)


# site1
server {
    listen 80;
    server_name app1.example.com;
    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:9090;
        uwsgi_param UWSGI_PYHOME /var/www/shared-env;
        uwsgi_param UWSGI_SCRIPT app1.wsgi:application;
        uwsgi_param UWSGI_CHDIR /var/www/app1;
    }
}

# site2
server {
    listen 80;
    server_name app2.example.com;
    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:9090;
        uwsgi_param UWSGI_PYHOME /var/www/shared-env;
        uwsgi_param UWSGI_SCRIPT app2.wsgi:application;
        uwsgi_param UWSGI_CHDIR /var/www/app2;
    }
}

關鍵參數:

  • UWSGI_PYHOME:虛擬環境路徑(對應 --virtualenv)
  • UWSGI_SCRIPT:WSGI 模組路徑(對應 --module)
  • UWSGI_CHDIR:工作目錄(對應 --chdir)

五、進階:Emperor 模式(推薦生產環境)

Emperor 監控 vassals 目錄下的 .ini 檔案,自動啟動/重載/停止對應應用,各應用擁有獨立進程池、虛擬環境、使用者身分,隔離性最佳。

1. Emperor 服務


# /etc/systemd/system/uwsgi-emperor.service
[Unit]
Description=uWSGI Emperor
After=network.target

[Service]
ExecStart=/usr/local/bin/uwsgi --emperor /etc/uwsgi/vassals --uid www-data --gid www-data --logto /var/log/uwsgi/emperor.log
Restart=on-failure
KillSignal=SIGQUIT
Type=notify
StandardError=syslog
NotifyAccess=all

[Install]
WantedBy=multi-user.target

2. Vassal 設定檔範例


# /etc/uwsgi/vassals/app1.ini
[uwsgi]
chdir = /var/www/app1
module = wsgi:application
virtualenv = /opt/venv/app1
socket = /run/uwsgi/app1.sock
chmod-socket = 660
master = true
processes = 2
threads = 15
harakiri = 30
limit-as = 256
max-requests = 5000
vacuum = true
logto = /var/log/uwsgi/app1.log

3. Nginx 對接


location / {
    include uwsgi_params;
    uwsgi_pass unix:/run/uwsgi/app1.sock;
}

六、常見問題與調試

現象排查方向
502 Bad GatewayuWSGI 未啟動、socket 路徑錯誤、權限不足、harakiri 觸發
504 Gateway Timeout請求處理超過 proxy_read_timeout 或 harakiri
ImportError虛擬環境未正確指定、pythonpath 缺漏
記憶體持續增長啟用 max-requests、檢查程式碼洩漏、考慮 reload-on-rss
靜態檔 404Nginx alias 路徑錯誤、未執行 collectstatic

七、監控與觀測

  • uwsgi --stats 127.0.0.1:9191 暴露統計 socket,搭配 uwsgitop、Prometheus uwsgi-exporter、Grafana。
  • 關鍵指標:workers.active、requests、avg_rt、tx/rx、rss。
copyright © 萬盛學電腦網 all rights reserved