使用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 实例,你需要添加合适的 WSGIDaemonProcessWSGIProcessGroup 指令。上述配置在你使用后台模式时需要点小修改,即你不能使用 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

相关推荐
FYKJ_20103 小时前
springboot校园兼职平台--附源码02041
java·javascript·spring boot·python·eclipse·django·php
心静财富之门15 小时前
Django 超详细初级教程(零基础可学)
python·django
ZC跨境爬虫16 小时前
Python Django开发者转向微信小程序:从架构理解到第一行代码的完整准备指南
开发语言·python·ui·微信小程序·django
绘梨衣54716 小时前
django-elasticsearch-dsl-drf 搜索服务搭建教学文档
python·elasticsearch·django
星光开发者16 小时前
基于springboot电动汽车租赁管理系统-计算机毕设 附源码 11217
javascript·spring boot·mysql·django·php·html5·express
Muyuan19981 天前
28.Paper RAG Agent 开发记录:修复 LLM Rerank 的解析、Fallback 与可验证性
linux·人工智能·windows·python·django·fastapi
Muyuan19982 天前
27.RAG 系统中的上下文充分性判断:从 Chunk 数量、FAISS 距离到 LLM Relevance Gate
python·django·pdf·fastapi·faiss
程序媛徐师姐3 天前
Python基于Django的小区果蔬预定系统【附源码、文档说明】
python·django·小区果蔬预定系统·果蔬预定·python小区果蔬预定系统·小区果蔬预定·python果蔬预定系统
码界筑梦坊3 天前
111-基于Python的中国旅游用户数据可视化分析系统
python·信息可视化·django·毕业设计·旅游
YJlio4 天前
10.2.8 以其他账户运行服务(Running services in alternate accounts):为什么“把服务切到某个用户账号下运行”,本质上是在改变服务的整个安全上下文?
python·安全·ios·机器人·django·iphone·7-zip