{"title":"如何用 uWSGI 托管 Django","version":"3.0","locale":"zh-hans","docname":"howto/deployment/wsgi/uwsgi","url":"/zh-hans/3.0/howto/deployment/wsgi/uwsgi/","canonical":"https://djangodocs.dev/zh-hans/3.0/howto/deployment/wsgi/uwsgi/","summary":"uWSGI 是一个快速的，自我驱动的，对开发者和系统管理员友好的应用容器服务器，完全由 C 编写。 See also uWSGI 文档提供了一个覆盖 Django，nginx，和 uWSGI（一个配置，多种适配）。以下文档专注于如何用 uWSGI 集成 Django。 前置条件：uWSGI Link to this…","html":"

如何用 uWSGI 托管 DjangoLink to this heading#

\n

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

\n\n
\n

前置条件：uWSGILink to this heading#

\n

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

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

uWSGI 模块Link to this heading#

\n

uWSGI operates on a client-server model. Your Web server (e.g., nginx, Apache)\ncommunicates with a django-uwsgi "worker" process to serve dynamic content.

\n
\n
\n

配置并启动用于 Django 的 uWSGI 服务器Link to this heading#

\n

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

\n

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

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

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

\n

Django 指定的参数如下：

\n\n

示例 ini 配置文件:

\n
Shell
[uwsgi]\nchdir=/path/to/your/project\nmodule=mysite.wsgi:application\nmaster=True\npidfile=/tmp/project-master.pid\nvacuum=True\nmax-requests=5000\ndaemonize=/var/log/uwsgi/yourproject.log\n
\n

示例 ini 配置文件语法:

\n
Shell
uwsgi --ini uwsgi.ini\n
\n\n

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

\n
\n
","rootId":"how-to-use-django-with-uwsgi","toc":[{"title":"前置条件：uWSGI","anchor":"prerequisite-uwsgi","children":[{"title":"uWSGI 模块","anchor":"uwsgi-model","children":[]},{"title":"配置并启动用于 Django 的 uWSGI 服务器","anchor":"configuring-and-starting-the-uwsgi-server-for-django","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"操作指南","url":"/zh-hans/3.0/howto/"},{"docname":"howto/deployment/index","title":"部署 Django","url":"/zh-hans/3.0/howto/deployment/"},{"docname":"howto/deployment/wsgi/index","title":"如何使用 WSGI 进行部署","url":"/zh-hans/3.0/howto/deployment/wsgi/"}],"prev":{"docname":"howto/deployment/wsgi/gunicorn","title":"如何使用 Gunicorn 托管 Django","url":"/zh-hans/3.0/howto/deployment/wsgi/gunicorn/"},"next":{"docname":"howto/deployment/wsgi/modwsgi","title":"如何使用 Apache 和 mod_wsgi 托管 Django","url":"/zh-hans/3.0/howto/deployment/wsgi/modwsgi/"},"formats":{"html":"/zh-hans/3.0/howto/deployment/wsgi/uwsgi/","markdown":"/zh-hans/3.0/howto/deployment/wsgi/uwsgi.md","json":"/zh-hans/3.0/howto/deployment/wsgi/uwsgi.json"},"source":"https://github.com/django/django/blob/stable/3.0.x/docs/howto/deployment/wsgi/uwsgi.txt","official":"https://docs.djangoproject.com/zh-hans/3.0/howto/deployment/wsgi/uwsgi/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}