使用WSGI部署Django的几种方式

部署服务器介绍：

• Gunicorn ('Green Unicorn') 是一个 UNIX 下的纯 Python WSGI 服务器
• uWSGI 是一个快速的，自我驱动的，对开发者和系统管理员友好的应用容器服务器，完全由 C 编写
• Apache 和 mod_wsgi 在生产环境部署已经过充分测试

方式一：使用 Gunicorn 托管 Django

安装 Gunicorn

> pip install gunicorn

把 Django 当作普通 WSGI 应用在 Gunicorn 中运行

安装了 Gunicorn 后，将提供一个 gunicorn 命令，该命令用于启动 Gunicorn 服务器进程。最简单的使用方式是传递包含名为 application 的 WSGI 应用程序对象的模块的位置，对于典型的 Django 项目，如下所示：

> gunicorn myproject.wsgi

这样会创建一个进程，包含了一个监听在 127.0.0.1:8000 的线程。前提是你的项目在 Python path 中，要满足这个条件，最简单的方法是在 manage.py 文件所在的目录中运行这条命令。

方式二：使用 uWSGI 托管 Django

uWSGI 文档提供了一个覆盖 Django，nginx，和 uWSGI（一个配置，多种适配）。以下文档专注于如何用 uWSGI 集成 Django。

前置条件：uWSGI

安装uwsgi

pip install uwsgi

配置并启动用于 Django 的 uWSGI 服务器

uWSGI 支持多种配置进程的方式

以下是启动 uWSGI 服务器的示例命令：

uwsgi --chdir=/path/to/your/project \

    --module=mysite.wsgi:application \

    --env DJANGO_SETTINGS_MODULE=mysite.settings \

    --master --pidfile=/tmp/project-master.pid \

    --socket=127.0.0.1:49152 \     # can also be a file

    --processes=5 \                 # number of worker processes

    --uid=1000 --gid=2000 \         # if root, uwsgi can drop privileges

    --harakiri=20 \                 # respawn processes taking more than 20 seconds

    --max-requests=5000 \           # respawn processes after serving 5000 requests

    --vacuum \                     # clear environment on exit

    --home=/path/to/virtual/env \   # optional path to a virtual environment

    --daemonize=/var/log/uwsgi/yourproject.log      # background the process

假设你有个叫做 mysite 的顶级项目包，其中包含一个模板 mysite/wsgi.py，模块包含一个 WSGI application 对象。如果你使用的是较新的 Django，这就是你运行 django-admin startproject mysite （使用你的项目名替换 mysite）后得到的目录结构。若该文件不存在，你需要创建它

Django 指定的参数如下：

• chdir：需要包含于 Python 的导入路径的目录的路径——例如，包含 mysite 包的目录
• module：要使用的 WSGI 模块——可能是 startproject 创建的 mysite.wsgi 的模块
• env：至少要包括 DJANGO_SETTINGS_MODULE
• home: 可选的路径，指向你工程的虚拟环境。

示例 INI 配置文件：

[uwsgi]

chdir=/path/to/your/project

module=mysite.wsgi:application

master=True

pidfile=/tmp/project-master.pid

vacuum=True

max-requests=5000

daemonize=/var/log/uwsgi/yourproject.log

示例 INI 配置文件的使用方法：

uwsgi --ini uwsgi.ini

方式三：使用 Apache 和 mod_wsgi 托管 Django

mod_wsgi 是一个 Apache 模块，它可以管理任何 Python WSGI 应用，包括 Django

Django 支持所有支持 mod_wsgi 的 Apache 版本

基础配置

一旦你安装了 mod_wsgi 并且启用了它，请在你的Apache服务器的 httpd.conf 文件中添加如下内容。

WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py

WSGIPythonHome /path/to/venv

WSGIPythonPath /path/to/mysite.com

<Directory /path/to/mysite.com/mysite>

<Files wsgi.py>

Require all granted

</Files>

</Directory>

WSGIScriptAlias 行的第一项是你所期望的应用所在的基础 URL 路径（ / 根 url），第二项是 "WSGI 文件" 的位置——一般位于项目包之内（本例中是 mysite）。这告诉 Apache 用该文件中定义的 WSGI 应用响应指定 URL 下的请求。

如果你在某个 virtual environment 1 内为应用安装项目的 Python 依赖，将该 virtualenv 的路径添加至 WSGIPythonHome

WSGIPythonPath 行确保你的项目包能从 Python path 导入

使用 mod_wsgi 后台模式

"Daemon mode" 是运行 mod_wsgi 的推荐模式（在非 Windows 平台上）。为了创建必要的后台进程组并在其中运行 Django 实例，你需要添加合适的 WSGIDaemonProcess 和 WSGIProcessGroup 指令。上述配置在你使用后台模式时需要点小修改，即你不能使用 WSGIPythonPath；作为替换，你要在 WSGIDaemonProcess 中添加 python-path 选项，例如：

WSGIDaemonProcess example.com python-home=/path/to/venv python-path=/path/to/mysite.com

WSGIProcessGroup example.com

如果你想在子目录中开放你的项目（本例中 https://example.com/mysite），你可在上述配置中添加 WSGIScriptAlias：

WSGIScriptAlias /mysite /path/to/mysite.com/mysite/wsgi.py process-group=example.com

静态文件服务

Django 本身并不提供文件，它把这项工作留给你选择的任何一个网络服务器。

我们建议使用一个单独的 Web 服务器独立提供静态文件服务如：

• Nginx
• Apache

参考文档

如何部署 Django - 如何使用 WSGI 进行部署 - 《Django v4.1 中文文档》 - 书栈网 · BookStack