本教程针对想要设置生产Web服务器的Django用户。它将指导您完成设置Django所需的步骤,以便与uWSGI和nginx完美配合。它涵盖了所有三个组件,提供了完整的Web应用程序和服务器软件堆栈。
Django是一个高级Python Web框架,鼓励快速开发和干净,实用的设计。
nginx(发音为engine-x)是一个免费的,开源的,高性能的HTTP服务器和反向代理,以及一个IMAP / POP3代理服务器。
注意
这是一个教程。其目的不是为部署主题提供参考指南,更不用说详尽的参考。
nginx和uWSGI是Django部署的不错选择,但它们不是唯一的,也不是“官方”的。两者都有很好的替代方案,我们鼓励您对它们进行调查。
我们在这里部署的Django的方式是一个很好的方式,但它不是的唯一途径; 出于某些目的,它甚至可能不是最好的方式。
然而,这是一种可靠而简单的方法,这里介绍的材料将向您介绍熟悉用于部署Django的软件所需的概念和过程。通过为您提供工作设置,并排练您必须采取的步骤,它将为您提供探索实现此目标的其他方法的基础。
注意
本教程对您使用的系统做了一些假设。
假设您使用的是类Unix系统,并且它具有类似aptitude的包管理器。但是,如果您需要提出诸如“Mac OS X上相当于aptitude的内容?”之类的问题,您将能够相当轻松地找到这种帮助。
虽然本教程假设Django 1.4或更高版本,它将在您的新项目中自动创建一个wsgi模块,但这些说明适用于早期版本。您将需要自己获取Django wsgi模块,并且您可能会发现Django项目目录结构略有不同。
Web服务器面向外部世界。它可以直接从文件系统提供文件(HTML,图像,CSS等)。但是,它不能直接与Django应用程序对话; 它需要运行应用程序的东西,从Web客户端(例如浏览器)提供请求并返回响应。
Web服务器网关接口 - WSGI - 完成这项工作。WSGI是Python标准。
uWSGI是一个WSGI实现。在本教程中,我们将设置uWSGI,以便创建一个Unix套接字,并通过uwsgi协议提供对Web服务器的响应。最后,我们完整的组件堆栈将如下所示:
the web client <-> the web server <-> the socket <-> uwsgi <-> Django
确保您对我们需要安装的软件有所了解(我们将在后面介绍如何安装系统范围的uwsgi):
virtualenv uwsgi-tutorial
cd uwsgi-tutorial
source bin/activate
将Django安装到virtualenv中,创建一个新项目,然后cd
进入项目:
pip install Django
django-admin.py startproject mysite
cd mysite
在本教程中,我们将调用您的域名example.com
。替换您自己的FQDN或IP地址。
在整个过程中,我们将使用端口8000为Web服务器发布,就像Django runserver默认情况下那样。您可以使用您想要的任何端口,但我选择了这个端口,因此它不会与Web服务器可能已经做的任何事情冲突。
pip install uwsgi
当然还有其他方法可以安装uWSGI,但是这个方法和其他方法一样好。请记住,您需要安装Python开发包。对于Debian或Debian派生的系统(如Ubuntu),您需要安装的是pythonX.Y-dev
XY,即您的Python版本。
创建一个名为的文件test.py
:
# test.py
def application(env, start_response):
start_response('200 OK', [('Content-Type','text/html')])
return [b"Hello World"] # python3
#return ["Hello World"] # python2
注意
考虑到Python 3的要求bytes()
。
运行uWSGI:
uwsgi --http :8000 --wsgi-file test.py
选项意味着:
http :8000
:使用协议http,端口8000wsgi-file test.py
:加载指定的文件test.py这应该直接向端口8000上的浏览器发送“hello world”消息。访问:
http://example.com:8000
去检查。如果是这样,则表示以下堆栈组件有效:
the web client <-> uWSGI <-> Python
现在我们希望uWSGI做同样的事情,但是要运行Django站点而不是 test.py
模块。
如果您还没有这样做,请确保您的mysite
项目确实有效:
python manage.py runserver 0.0.0.0:8000
如果可行,请使用uWSGI运行它:
uwsgi --http :8000 --module mysite.wsgi
module mysite.wsgi
:加载指定的wsgi模块将浏览器指向服务器; 如果该网站出现,则表示uWSGI能够从您的virtualenv为您的Django应用程序提供服务,并且此堆栈可以正常运行:
the web client <-> uWSGI <-> Django
现在通常我们不会让浏览器直接与uWSGI对话。这是网络服务器的工作,它将充当中间人。
sudo apt-get install nginx
sudo /etc/init.d/nginx start # start nginx
现在通过在端口80上的Web浏览器中访问它来检查nginx是否正在服务 - 你应该从nginx收到一条消息:“欢迎来到nginx!”。这意味着完整堆栈的这些组件正在协同工作:
the web client <-> the web server
如果别的东西是已经服务的80端口,你想有使用nginx的,你就必须重新配置nginx的服务于不同的端口上。但是对于本教程,我们将使用端口8000。
您将需要该uwsgi_params
文件,该文件nginx
位于uWSGI发行版的目录中,或者来自https://github.com/nginx/nginx/blob/master/conf/uwsgi_params
将其复制到项目目录中。稍后我们将告诉nginx引用它。
现在在/ etc / nginx / sites-available /目录中创建一个名为mysite_nginx.conf的文件,并将其放入其中:
# mysite_nginx.conf
# the upstream component nginx needs to connect to
upstream django {
# server unix:///path/to/your/mysite/mysite.sock; # for a file socket
server 127.0.0.1:8001; # for a web port socket (we'll use this first)
}
# configuration of the server
server {
# the port your site will be served on
listen 8000;
# the domain name it will serve for
server_name example.com; # substitute your machine's IP address or FQDN
charset utf-8;
# max upload size
client_max_body_size 75M; # adjust to taste
# Django media
location /media {
alias /path/to/your/mysite/media; # your Django project's media files - amend as required
}
location /static {
alias /path/to/your/mysite/static; # your Django project's static files - amend as required
}
# Finally, send all non-media requests to the Django server.
location / {
uwsgi_pass django;
include /path/to/your/mysite/uwsgi_params; # the uwsgi_params file you installed
}
}
这个conf文件告诉nginx从文件系统提供媒体和静态文件,以及处理需要Django干预的请求。对于大型部署,让一个服务器处理静态/媒体文件,另一个处理Django应用程序被认为是一种好习惯,但是现在,这样做会很好。
从/ etc / nginx / sites-enabled到此文件的符号链接,以便nginx可以看到它:
sudo ln -s ~/etc/nginx/sites-available/mysite_nginx.conf /etc/nginx/sites-enabled/
在运行nginx之前,您必须收集静态文件夹中的所有Django静态文件。首先你必须编辑mysite / settings.py添加:
STATIC_ROOT = os.path.join(BASE_DIR, "static/")
然后跑
python manage.py collectstatic
重启nginx:
sudo /etc/init.d/nginx restart
要检查的媒体文件被送达正确,添加一个名为图像 media.png
的,然后访问http://example.com:8000/media/media.png -如果这个工程,你就会知道,至少这是nginx的文件服务正确。/path/to/your/project/project/media directory
值得的不仅仅是重新启动nginx,而是实际停止然后再次启动它,这将通知您是否存在问题,以及它的位置。
让我们让nginx与“hello world” test.py
应用程序对话。
uwsgi --socket :8001 --wsgi-file test.py
这几乎和以前一样,除了这次选项之一是不同的:
socket :8001
:使用协议uwsgi,端口8001nginx同时已配置为在该端口上与uWSGI通信,并与外部世界在端口8000上进行通信。访问:
http://example.com:8000/
去检查。这是我们的堆栈:
the web client <-> the web server <-> the socket <-> uWSGI <-> Python
同时,您可以尝试查看http://example.com:8001上的uwsgi输出 - 但很可能,它不会起作用,因为您的浏览器会说http,而不是uWSGI,尽管您应该看到来自uWSGI的输出你的终端。
到目前为止,我们已经使用了TCP端口套接字,因为它更简单,但实际上使用Unix套接字比使用端口更好 - 开销更少。
编辑mysite_nginx.conf
,将其更改为匹配:
server unix:///path/to/your/mysite/mysite.sock; # for a file socket
# server 127.0.0.1:8001; # for a web port socket (we'll use this first)
并重新启动nginx。
再次运行uWSGI:
uwsgi --socket mysite.sock --wsgi-file test.py
这次socket
选项告诉uWSGI使用哪个文件。
在浏览器中尝试http://example.com:8000/。
检查你的nginx错误日志(/var/log/nginx/error.log)。如果你看到类似的东西:
connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permission
denied)
那么可能你需要管理套接字上的权限,以便允许nginx使用它。
尝试:
uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=666 # (very permissive)
要么:
uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=664 # (more sensible)
您可能还需要将您的用户添加到nginx的组(可能是www-data),反之亦然,这样nginx就可以正确地读取和写入您的套接字。
值得保持nginx日志的输出在终端窗口中运行,以便在故障排除时轻松引用它。
让我们运行我们的Django应用程序:
uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=664
现在uWSGI和nginx应该不仅仅是一个“Hello World”模块,而是你的Django项目。
我们可以将与uWSGI一起使用的相同选项放入文件中,然后让uWSGI运行该文件。它使管理配置变得更加容易。
创建一个名为的文件`mysite_uwsgi.ini`
:
# mysite_uwsgi.ini file
[uwsgi]
# Django-related settings
# the base directory (full path)
chdir = /path/to/your/project
# Django's wsgi file
module = project.wsgi
# the virtualenv (full path)
home = /path/to/virtualenv
# process-related settings
# master
master = true
# maximum number of worker processes
processes = 10
# the socket (use the full path to be safe
socket = /path/to/your/project/mysite.sock
# ... with appropriate permissions - may be needed
# chmod-socket = 664
# clear environment on exit
vacuum = true
并使用此文件运行uwsgi:
uwsgi --ini mysite_uwsgi.ini # the --ini option is used to specify a file
英文链接:https://uwsgi-docs.readthedocs.io/en/latest/tutorials/Django_and_nginx.html