萬盛學電腦網

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

Django 專案部署至 Apache:mod_wsgi 設定完整實作

將開發完成的 Django 專案部署到生產環境 Apache,核心在於 mod_wsgi 的正確配置。本文以 RHEL 5.3 + Apache 2.2 + mod_wsgi 3.2 + Django 1.2 為例,詳細說明 django.wsgi 撰寫、settings.py 調整、虛擬主機配置與除錯技巧。

環境前提

  • OS:RHEL 5.3 x86_64
  • Apache:httpd-2.2.3(DocumentRoot /var/www/html)
  • mod_wsgi:3.2(EPEL 安裝)
  • Python:2.5(系統預設)
  • Django 專案目錄:/var/www/html/server

1. Apache 載入 mod_wsgi 設定

編輯 /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

2. 撰寫 django.wsgi 進入點腳本

在專案根目錄建立 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 一致。

3. 修改 settings.py 關鍵設定


# 絕對路徑指定模板目錄(相對路徑在 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

4. Apache 虛擬主機完整範本



    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

5. mod_wsgi 兩種運作模式深度解析

模式架構優點缺點適用場景
Embedded Mode
(預設)
Python 解釋器內嵌於 Apache worker 進程 無額外進程、啟動快 記憶體共享、洩漏影響整個 Apache、worker MPM 強制多執行緒(非執行緒安全庫會崩潰) 小型腳本、低流量、單一應用
Daemon Mode
(推薦)
獨立 daemon 進程池,透過 UNIX socket 與 Apache 通訊 記憶體隔離、可獨立重啟、支援多種 MPM 模擬、多應用隔離 額外進程開銷、配置稍複雜 生產環境、多 Django 專案、高可用需求

Daemon Mode 進階配置範例


# 單一應用獨立 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

MPM 模擬參數對照

  • prefork 模擬:processes=5 threads=1 → wsgi.multiprocess=True, wsgi.multithread=False
  • worker 模擬:processes=2 threads=25 → True, True
  • winnt (Windows) 模擬:processes=1 threads=25 → True, False(若明確指定 processes=1 則為 True, True)

Django 1.0+ 已支援多執行緒,建議 processes=2 threads=15~64;舊版請用 threads=1。

6. 常見部署問題排查

現象可能原因解決
500 Internal Server Errorwsgi 腳本語法錯、路徑錯、權限不足查 /var/log/httpd/error_log,啟用 LogLevel debug
ImportError: No module named djangoPython 路徑不含 site-packageswsgi 腳本加 sys.path.append('/path/to/site-packages')
TemplateDoesNotExistTEMPLATE_DIRS 相對路徑改用絕對路徑
Permission denied: /tmp/.python-eggsEgg 快取目錄權限mkdir -p /tmp/.python-eggs && chown apache:apache /tmp/.python-eggs
靜態檔 404Alias 路徑錯誤或 collectstatic 未跑確認 STATIC_ROOT、執行 collectstatic、Alias 指向正確目錄

7. 遷移至現代架構建議

新專案建議採用 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;,效能更高、配置更簡潔、生態工具更豐富。

copyright © 萬盛學電腦網 all rights reserved