如何用uWSGI和nginx来搭建Django工程
nginx和uWSGI是Django部署的不错选择,但并非唯一的,它们都是可以替代的,欢迎进行其它尝试。
背景知识简要介绍:
1、WSGI是一种Web服务器网关接口。它是Web服务器(如nginx)与应用服务器(如uWSGI服务器)通信的一种规范。
2、uWSGI它实现了WSGI、uwsgi、http等协议。
3、Nginx是高性能的HTTP和反向代理服务器(我们使用Nginx是因为其高效的处理静态文件请求的能力)
4、Django是采用MVC设计模式的开源Web应用框架。
5、socket是用来实现进程间通信的,在我们这里用作实现nginx和uWSGI之间的通信
粗略的介绍我们需要使用到的部件之后,我们来具体说明搭建的步骤(请认真看,务求一次做对)
我们最后要完成的工作基本是这样的:
客户端(进行web请求) —— 服务器(这里使用的是nginx) —— socket(自动生成的通信文件)—— uwsgi —— Django
下面的内容很多来源于http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file
uWSGI的安装和基本配置:
我们使用pip包管理工具来安装uWSGI:
sudo pip install uwsgi
如果你还没有pip,那么装上它:
在 Debian 和 Ubuntu系统中使用:
sudo apt-get install python-pip在 Fedora 和 CentOS系统中使用:
sudo yum install python-pip在pip安装uwsgi的过程中如果提示有依赖没有安装:
Debian 和Ubuntu:
apt-get groupinstall "Development Tools"
apt-get install python-devel
Fedora 和CentOS:
yum groupinstall "Development Tools"
yum install -y python-devel
基本试验
创建一个测试文件test.py:
def application(env, start_response): start_response('200 OK', [('Content-Type','text/html')]) return ["Hello World"] # python2 #return [b"Hello World"] # python3
运行uWSGI
uwsgi --http :8000 --wsgi-file test.py代码的意思是使用http协议,端口8000,载入我们的测试文件。如果一切正常,访问:
http://127.0.0.1:8000/ (注意冒号是英文的冒号)
你会看到熟悉且可爱的Hello World。这也就说明我们打通了客户端——uWSGI——Python的桥梁。
用你的Django工程代替test.py
首先确信一下我们的工程本身能正常运行,在终端进入你的工程目录,然后敲入:
python manage.py runserver 0.0.0.0:8000如果可以正常运行,停掉它然后执行下面的代码,把nidegongchenming改成你的工程名:
uwsgi --http :8000 --module nidegongchenming.wsgimodule *.wsgi是载入wsgi模块的意思,请放心这个模块你已经有了的。
那么现在我们打通客户端——uWSGI——Django的桥梁,恭喜。
如果你的Django工程叫abc,我建议你把它的全部内容都拷贝到/var/www/中。然后你的工程的manage.py文件就在/var/www/abc/中,这样可以避免因文件权限,带来的一些不能提供服务的问题。
好了可以停掉服务了,我们继续。
nginx的安装和基本配置:
安装 nginx
Ubuntu 和 Debian:
sudo apt-get install nginx sudo /etc/init.d/nginx startFedora 和CentOS
sudo yum install nginx sudo service nginx startFedora中,service nginx start会被重定向到systemctl start nginx.service。
如果一切正常(默认的80端口没有被占用),此时在浏览器中访问127.0.0.1你会看到“Welcome to nginx on XXX”
那么现在我们的桥梁变成了:客户端——服务器(nginx)
如果端口被Apache或者其它什么占用了,导致nginx服务不能成功启动也没关系,下面我们介绍怎么配置nginx来监听其它端口。
配置 nginx
首先我们需要一份uwsgi_params文件,这个文件一般会在你的nginx目录中,比如我的在/etc/nginx/里,当然,没找到的话,你也可以去https://github.com/nginx/nginx/blob/master/conf/uwsgi_params,copy一份,或者复制下面的内容
uwsgi_param QUERY_STRING $query_string; uwsgi_param REQUEST_METHOD $request_method; uwsgi_param CONTENT_TYPE $content_type; uwsgi_param CONTENT_LENGTH $content_length; uwsgi_param REQUEST_URI $request_uri; uwsgi_param PATH_INFO $document_uri; uwsgi_param DOCUMENT_ROOT $document_root; uwsgi_param SERVER_PROTOCOL $server_protocol; uwsgi_param HTTPS $https if_not_empty; uwsgi_param REMOTE_ADDR $remote_addr; uwsgi_param REMOTE_PORT $remote_port; uwsgi_param SERVER_PORT $server_port; uwsgi_param SERVER_NAME $server_name;
文件名是uwsgi_params,没有后缀。把它放到你的Django工程中,和manage.py同目录。下面我们来配置nginx,并告诉它引用uwsgi_params文件。
进入你的Django工程目录,创建一个文件 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 } }这个文件中的内容我保留了英文文档中的注释,比较详细,可能会对你有一些意外的帮助。
server{}中的server_name可以接IP地址,比如:server_name 219.242.174.48,测试的话用你本机的吧,搭好了之后方便在同网段内使用其它机器测试。
这份配置文件告诉nginx从文件系统中建立媒体和静态文件服务,同时也处理Django应用中的请求。对于大型的部署而言,让一个服务器处理静态/媒体文件,另一个处理Django应用,会有很好的表现。不过现在,我们这么做也没问题。
然后执行下面的命令,让nginx知道有这么一个配置文件:
sudo ln -s mysite_nginx.conf /etc/nginx/sites-enabled/
部署静态文件
在运行nginx之前,必须把所有的Django静态文件收集到一个静态文件夹中,首先在settings.py中写入:
STATIC_ROOT = os.path.join(BASE_DIR, "static/")
然后运行
python manage.py collectstatic
基本nginx测试
重启nginx服务
Ubuntu,Debian:
sudo /etc/init.d/nginx restartFedora,CentOS:
sudo service nginx restart 或者 systemctl restart nginx.service
为了测试我们是不是可以提供访问媒体文件的服务,找张图片比如"abc.png",放到你的Django工程中的媒体目录下,比如/var/www/project/project/media。然后访问http://127.0.0.1:8000/media/abc.png,如果有问题,需要先停止nginx(上面命令中restart改成stop),再启动。这样我们能得到一些提示信息,以便找出问题在哪。
nginx和uWSGI以及test.py的沟通
uwsgi --socket :8001 --wsgi-file test.py前面nginx已经被设置好在8001端口与uWSGI通信,同时在外界服务被布置在8000端口,访问:http://127.0.0.1:8000/
如果能看到Hell World,说明我们打通的桥梁变成:
客户端(浏览器)——服务器(nginx)——socket——uWSGI——python
同时你也可以访问http://127.0.0.1:8001/,看看uWSGI的反应,暂不剧透……
到现在我们都是在使用TCP port socket,这样开始的时候会容易些,不过实际上使用Unix sockets 会更好些,会有较小的开销。
编辑我们刚才的nginx配置文件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.pymysite.sock文件会被自动建立,用做通信,你可以当它是个临时文件。当然不喜欢这个文件名,你也可以更改。用浏览器再访问一次8000端口,看看结果。
如果服务没能正常运行,查看一次啊nginx的错误日志,在/var/log/nginx/error.log。如果错误日志像是这样:
connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permission denied)那可能需要更改socket的权限,以便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用户组,反之也需要把nginx加入你当前用户的用户组。这样nginx应该就有权限访问socket文件了。
激动人心的时候要到了
现在我们可以尝试一下用uwsgi和nginx来运行我们的Django应用了。
在工程目录下运行:
uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=664注意mysite.wsgi要改成你的工程名。
现在应该在浏览器中能看到你的工程了。
用ini文件来配置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如果你使用了virtualenv,home那个位置就不能注释掉。
以后再运行 uswgi就可以使用:
uwsgi --ini mysite_uwsgi.ini进一步我们还可以让uWSGI运行在上帝模式,设置开机自动启动以及限制最大访问,工程文件大小之类的配置。
去吃饭了
这些内容我可能会在下一篇博客里写,想先了解的同学请移步:http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file
这个文档相当全面,而且重要的是没有拼写错误这种情况。
版权声明:本文为博主原创文章,未经博主允许不得转载。
以上就介绍了如何用uWSGI和nginx来搭建Django工程,包括了方面的内容,希望对PHP教程有兴趣的朋友有所帮助。
声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn核实处理。
相关文章
相关视频