將開發完成的 Django 專案部署到生產環境 Apache,核心在於 mod_wsgi 的正確配置。本文以 RHEL 5.3 + Apache 2.2 + mod_wsgi 3.2 + Django 1.2 為例,詳細說明 django.wsgi 撰寫、settings.py 調整、虛擬主機配置與除錯技巧。
DocumentRoot /var/www/html)/var/www/html/server編輯 /etc/httpd/conf.d/wsgi.conf:
LoadModule wsgi_module modules/mod_wsgi.so
WSGIScriptAlias / "/var/www/html/server/django.wsgi"
Order Deny,Allow
Allow from all
在專案根目錄建立 django.wsgi:
# -*- coding: utf-8 -*-
import os
import sys
# 關鍵:指定 Django 設定模組
os.environ['DJANGO_SETTINGS_MODULE'] = 'settings'
# 關鍵:指定 Python Egg 快取目錄(Apache 使用者需有寫入權限)
os.environ['PYTHON_EGG_CACHE'] = '/tmp/.python-eggs'
# 將專案目錄加入 sys.path
current_dir = os.path.dirname(__file__)
if current_dir not in sys.path:
sys.path.append(current_dir)
# 建立 WSGI 應用物件
import django.core.handlers.wsgi
application = django.core.handlers.wsgi.WSGIHandler()
關鍵點解析:
DJANGO_SETTINGS_MODULE 指向 settings(即 settings.py),不含 .py 副檔名。PYTHON_EGG_CACHE 必須可寫入,否則含 C 擴充套件的套件(如 MySQLdb、Pillow)會啟動失敗。app.wsgi),但需與 WSGIScriptAlias 一致。
# 絕對路徑指定模板目錄(相對路徑在 mod_wsgi 下會失效)
TEMPLATE_DIRS = (
"/var/www/html/server/template",
)
# 靜態檔案設定(Django 1.3+ 推薦)
STATIC_URL = '/static/'
STATIC_ROOT = '/var/www/html/server/static_collected'
# 允許的主機(生產環境必填)
ALLOWED_HOSTS = ['example.com', 'www.example.com']
# 關閉除錯模式
DEBUG = False
收集靜態檔:
cd /var/www/html/server
python manage.py collectstatic --noinput
ServerName django.example.com
DocumentRoot /var/www/html
# WSGI 應用
WSGIScriptAlias / /var/www/html/server/django.wsgi
# 專案目錄權限
Order Deny,Allow
Allow from all
# 隱藏原始碼目錄
Order Deny,Allow
Deny from all
# Django Admin 靜態資源(舊版路徑)
Alias /admin_media /usr/local/lib/python2.5/site-packages/django/contrib/admin/media
Order Allow,Deny
Allow from all
# 專案靜態檔案
Alias /static /var/www/html/server/static
Order Allow,Deny
Allow from all
# 媒體上傳檔案
Alias /media /var/www/html/server/media
Order Allow,Deny
Allow from all
ErrorLog logs/django_error_log
CustomLog logs/django_access_log common
| 模式 | 架構 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|---|
| Embedded Mode (預設) |
Python 解釋器內嵌於 Apache worker 進程 | 無額外進程、啟動快 | 記憶體共享、洩漏影響整個 Apache、worker MPM 強制多執行緒(非執行緒安全庫會崩潰) | 小型腳本、低流量、單一應用 |
| Daemon Mode (推薦) |
獨立 daemon 進程池,透過 UNIX socket 與 Apache 通訊 | 記憶體隔離、可獨立重啟、支援多種 MPM 模擬、多應用隔離 | 額外進程開銷、配置稍複雜 | 生產環境、多 Django 專案、高可用需求 |
# 單一應用獨立 daemon
WSGIDaemonProcess myproject processes=2 threads=15 display-name=myproject
WSGIProcessGroup myproject
WSGIScriptAlias / /var/www/html/myproject/wsgi.py
# 多應用共用同一 daemon(省資源)
WSGIDaemonProcess shared processes=2 threads=10 display-name=shared
WSGIProcessGroup shared
WSGIScriptAlias /app1 /var/www/app1/wsgi.py
WSGIScriptAlias /app2 /var/www/app2/wsgi.py
# 多應用各自獨立 daemon(完全隔離)
WSGIDaemonProcess app1 processes=2 threads=15 display-name=app1
WSGIDaemonProcess app2 processes=1 threads=10 display-name=app2
WSGIProcessGroup app1
WSGIScriptAlias /app1 /var/www/app1/wsgi.py
WSGIProcessGroup app2
WSGIScriptAlias /app2 /var/www/app2/wsgi.py
processes=5 threads=1 → wsgi.multiprocess=True, wsgi.multithread=Falseprocesses=2 threads=25 → True, Trueprocesses=1 threads=25 → True, False(若明確指定 processes=1 則為 True, True)Django 1.0+ 已支援多執行緒,建議 processes=2 threads=15~64;舊版請用 threads=1。
| 現象 | 可能原因 | 解決 |
|---|---|---|
| 500 Internal Server Error | wsgi 腳本語法錯、路徑錯、權限不足 | 查 /var/log/httpd/error_log,啟用 LogLevel debug |
| ImportError: No module named django | Python 路徑不含 site-packages | wsgi 腳本加 sys.path.append('/path/to/site-packages') |
| TemplateDoesNotExist | TEMPLATE_DIRS 相對路徑 | 改用絕對路徑 |
| Permission denied: /tmp/.python-eggs | Egg 快取目錄權限 | mkdir -p /tmp/.python-eggs && chown apache:apache /tmp/.python-eggs |
| 靜態檔 404 | Alias 路徑錯誤或 collectstatic 未跑 | 確認 STATIC_ROOT、執行 collectstatic、Alias 指向正確目錄 |
新專案建議採用 Nginx + Gunicorn + systemd 或 Docker + Kubernetes:
# systemd service 範例
[Unit]
Description=Gunicorn Django App
After=network.target
[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/myproject
ExecStart=/opt/venv/myproject/bin/gunicorn --workers 3 --bind unix:/run/gunicorn.sock myproject.wsgi:application
Restart=on-failure
[Install]
WantedBy=multi-user.target
Nginx 反向代理 proxy_pass https://unix:/run/gunicorn.sock;,效能更高、配置更簡潔、生態工具更豐富。