如何用 uWSGI 托管 Django

uWSGI 是一个快速的，自我驱动的，对开发者和系统管理员友好的应用容器服务器，完全由 C 编写。

参见

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

前置条件：uWSGI

uWSGI 百科介绍了几种 安装流程。Pip （Python 包管理器）能让你仅用一行代码就安装任意版本的 uWSGI。例子：

  1. # Install current stable version.
  2. $ python -m pip install uwsgi
  4. # Or install LTS (long term support).
  5. $ python -m pip install https://projects.unbit.it/downloads/uwsgi-lts.tar.gz

uWSGI 模块

uWSGI以 客户-服务器模式运行。你的网站服务器（如 nginx、Apache）与 django-uwsgi “worker” 进程进行通信，以提供动态内容。

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

uWSGI 支持多种配置进程的方式。参考 uWSGI 的 配置文档。

以下是个示例命令，用于启动一个 uWSGI 服务器:

  1. uwsgi --chdir=/path/to/your/project \
  2.     --module=mysite.wsgi:application \
  3.     --env DJANGO_SETTINGS_MODULE=mysite.settings \
  4.     --master --pidfile=/tmp/project-master.pid \
  5.     --socket=127.0.0.1:49152 \      # can also be a file
  6.     --processes=5 \                 # number of worker processes
  7.     --uid=1000 --gid=2000 \         # if root, uwsgi can drop privileges
  8.     --harakiri=20 \                 # respawn processes taking more than 20 seconds
  9.     --max-requests=5000 \           # respawn processes after serving 5000 requests
  10.     --vacuum \                      # clear environment on exit
  11.     --home=/path/to/virtual/env \   # optional path to a virtual environment
  12.     --daemonize=/var/log/uwsgi/yourproject.log      # background the process

假设你有个叫做 mysite 的顶级项目包，其中包含一个模板 mysite/wsgi.py，模块包含一个 WSGI application 对象。如果你使用的是较新的 Django，这就是你运行 django-admin startproject mysite （使用你的项目名替换 mysite）后得到的目录结构。若该文件不存在，你需要创建它。参考文档 如何使用 WSGI 进行部署 看看你需要配置的默认内容，以及你还能添加什么。

Django 指定的参数如下：

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

示例 ini 配置文件:

  1. [uwsgi]
  2. chdir=/path/to/your/project
  3. module=mysite.wsgi:application
  4. master=True
  5. pidfile=/tmp/project-master.pid
  6. vacuum=True
  7. max-requests=5000
  8. daemonize=/var/log/uwsgi/yourproject.log

示例 ini 配置文件语法:

  1. uwsgi --ini uwsgi.ini

为文件上传修复 UnicodeEncodeError

如果上传的文件名包含非 ASCII 字符时，可能抛出 UnicodeEncodeError，确保 uWSGI 已正确配置，能接受非 ASCII 字符的文件名，通过在 uwsgi.ini 添加以下内容:

  1. env = LANG=en_US.UTF-8

参考 Unicode 参考指引的 文件 章节获取细节信息。

参考 uWSGI 文档 管理 uWSGI 进程 获取更多关于开启，关闭和重载 uWSGI workers 的信息。