完成本地開發只是開始,將 Web App 部署到生產環境才能服務真實用戶。本文以 awesome-python-webapp 為例,完整記錄從零構建 Ubuntu Server、配置 Nginx 反向代理、Gunicorn WSGI 伺服器、Supervisor 進程監控,到 Fabric 自動化部署腳本的全流程最佳實踐。
用戶請求 → Nginx (靜態資源 + 反向代理) → Gunicorn (Master-Worker) → Python App
↑
Supervisor (進程監控、自動重啟)


ssh-copy-id user@server$ sudo apt-get install nginx gunicorn python-gevent supervisor mysql-server
$ sudo apt-get install python-jinja2 python-mysql.connector
/
└── srv/
└── awesome/ <-- Web App 根目錄
├── www/ <-- 當前版本軟連結 → releases/20240115_1430/
├── releases/ <-- 歷史版本目錄
│ ├── 20240115_1430/
│ └── 20240114_2200/
├── log/ <-- 日誌目錄
└── static/ <-- 靜態資源(由 Nginx 直接服務)

軟連結策略:新版本解壓至 releases/,切換 www 指向即完成部署,回滾只需切回舊連結。
server {
listen 80;
server_name yourdomain.com;
root /srv/awesome/www;
location /static/ { expires 30d; }
location / {
proxy_pass https://127.0.0.1:9000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
# /etc/supervisor/conf.d/awesome.conf
[program:awesome]
command = /srv/awesome/www/venv/bin/gunicorn -w 4 -k gevent -b 127.0.0.1:9000 wsgi:app
directory = /srv/awesome/www
user = www-data
autostart = true
autorestart = true
redirect_stderr = true
stdout_logfile = /srv/awesome/log/gunicorn.log
-k gevent:無需修改同步代碼即獲得協程級併發-w 4:Worker 數通常設為 CPU 核心數 × 2# fabfile.py
from fabric.api import *
import os, re
from datetime import datetime
env.user = 'deploy'
env.sudo_user = 'root'
env.hosts = ['your.server.ip']
_TAR_FILE = 'dist-awesome.tar.gz'
_REMOTE_BASE = '/srv/awesome'
def build():
includes = ['static', 'templates', 'transwarp', 'favicon.ico', '*.py']
excludes = ['test', '.*', '*.pyc', '*.pyo']
local('rm -f dist/%s' % _TAR_FILE)
with lcd(os.path.join(os.path.abspath('.'), 'www')):
cmd = ['tar', '--dereference', '-czvf', '../dist/%s' % _TAR_FILE]
cmd.extend(['--exclude=%s' % ex for ex in excludes])
cmd.extend(includes)
local(' '.join(cmd))
def deploy():
newdir = 'www-%s' % datetime.now().strftime('%y-%m-%d_%H.%M.%S')
run('rm -f %s/%s' % (_REMOTE_BASE, _TAR_FILE))
put('dist/%s' % _TAR_FILE, '%s/%s' % (_REMOTE_BASE, _TAR_FILE))
with cd(_REMOTE_BASE):
sudo('mkdir %s' % newdir)
sudo('tar -xzf %s -C %s' % (_TAR_FILE, newdir))
sudo('rm -f www')
sudo('ln -s %s www' % newdir)
sudo('supervisorctl restart awesome')
sudo('nginx -s reload')
print('Deploy success: %s' % newdir)
部署僅需一條指令:
$ fab build deploy
$ mysql -u root -p < schema.sql