nginx+uwsgi部署Django/Flask

本文用来记录 Django/Flask 部署的一些笔记，文中描述的系统环境为 Ubuntu，采用的服务器为 nginx 以及用 uwsgi 来连接 Django/Flask，这也是目前 Django/Flask 比较主流的部署套餐。

部署连接原理

　　浏览器发起web请求<——>nginx接收请求<——>uwsgi处理请求<—–>django程序

 

环境安装

nginx

　　安装 nginx（Ubuntu）

sudo apt-get install nginx

 

　　运行并查看状态

/etc/init.d/nginx start
/etc/init.d/nginx status

 

Uwsgi

　　先安装 python-dev，否则 uwsgi 安装可能会报错

apt-get install python-dev

 

　　安装uwsgi 

pip install uwsgi

　　安装完后添加环境变量: 

　　　　打开文件：sudo vim .bashrc，添加以下内容：

export PATH=/home/nmask/.local/bin/:$PATH

然后运行 source .bashrc 使之生效，就可以在命令行直接运行 uwsgi

或者

使用软连接

ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi

 

环境测试

测试nginx

/etc/init.d/nginx start

　　测试 uwsgi 打开http://localhost:80，能看到 nginx 说明 nginx 安装成功。

项目根目录下创建 test.py 文件，写入：

def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return "Hello World”

 

项目根目录下运行： 

uwsgi --http :8001 --wsgi-file test.py#表示运行test文件，8001端口

访问http://localhost:8001，如果能看到 hello world，说明 uwsgi 安装成功。 

利用 uwsgi 运行 django 项目

uwsgi --http :8001 --chdir /home/nmask/mydjango --wsgi-file mydjango/wsgi.py --master --processes 4 --threads 2 --stats 127.0.0.1:8080

http ： 协议类型和端口号常用选项：

• processes ： 开启的进程数量
• workers ： 开启的进程数量，等同于processes（官网的说法是spawn the specified number ofworkers / processes）
• chdir ： 指定运行目录（chdir to specified directory before apps loading）
• wsgi-file ： 载入wsgi-file（load .wsgi file）
• stats ： 在指定的地址上，开启状态服务（enable the stats server on the specified address）
• threads ： 运行线程。由于GIL的存在，我觉得这个真心没啥用。（run each worker in prethreaded mode with the specified number of threads）
• master ： 允许主进程存在（enable master process）
• daemonize ： 使进程在后台运行，并将日志打到指定的日志文件或者udp服务器（daemonize uWSGI）。实际上最常用的，还是把运行记录输出到一个本地文件上。
• pidfile ： 指定pid文件的位置，记录主进程的pid号。
• vacuum ： 当服务器退出的时候自动清理环境，删除unix socket文件和pid文件（try to remove all of the generated file/sockets）

以配置文件形式设置

myweb_uwsgi.ini

项目根目录下创建：myweb_uwsgi.ini文件（名字可以是任意的），写入：

# myweb_uwsgi.ini file
[uwsgi]
 
# Django-related settings
 
socket = :8000  # socket设定的端口是uwsgi和nginx交互的端口，必须与nginx的配置文件中相同
http = :8001
 
# 项目所在绝对路径
chdir = /home/nmask/mydjango
# Django s wsgi file
module = mydjango.wsgi
 
# process-related settings
# master
master = true
 
# maximum number of worker processes
processes = 4
 
# ... with appropriate permissions - may be needed
# chmod-socket = 664
# clear environment on exit
vacuum = true

 

利用uwsgi运行django：（与前面命令行的方式一样，这样为了方便写成了文件） 

uwsgi --ini myweb_uwsgi.ini

 

配置文件参数：

• socket:指uwsgi运行的端口
• Chdir:运行的目录
• Module：运行的文件

 

配置nginx

　　打开/etc/nginx/nginx.conf，http内添加以下内容：

server {
    listen 8890;
    server_name 127.0.0.1#0.0.0.0为任意IP均可访问
    charset UTF-8;
    access_log /var/log/nginx/myweb_access.log;
    error_log /var/log/nginx/myweb_error.log;
 
    client_max_body_size 75M;
 
location / {
    include uwsgi_params;
    uwsgi_pass 127.0.0.1:8000;
    uwsgi_read_timeout 2;
}
location /static {
    expires 30d;
    autoindex on;
    add_header Cache-Control private;
    alias /home/fnngj/pydj/myweb/static/;
}
}

说明：这里的 8000 端口是 uwsgi 的端口，nginx 运行将开启 8890 端口，也就是 nginx 的 8890 端口与 uwsgi 的 8000 端口相互通信。 

 

部署运行

运行uwsgi

nohup uwsgi --ini myweb_uwsgi.ini &

 

运行nginx:

/etc/init.d/nginx start

最后访问http://IP地址:8890，可以看到django项目已经被运行在nginx上了。

注意：在更新Django代码后，最好重启一下uwsgi进程，避免出现不可预知的Bug！

#关闭uwsgi和nginx
sudo nginx -s stop
killall -9 uwsgi

 

坑点

• 如果服务器是映射的，nginx配置文件里面的server_name要写外网的IP或者域名
• 不要在python虚拟环境中使用uwsgi，会有一些问题，当然也可以解决，参考：https://stackoverflow.com/questions/14194859/importerror-no-module-named-django-core-wsgi-for-uwsgi
• 若是uwsgi运行正常，nginx运行也正常，但就是连接不起来，可以检查下系统是否开启了selinux，需要关闭它才行。

 

报错

No module named django.core.wsgi

启动uwsgi时报以下错误：ImportError: No module named django.core.wsgi for uwsgi

　　uwsgi在python虚拟环境中启动时，配置文件里面要加虚拟的路径。 

　　打开django.init（自己创建）写入：

home=/path/to/venv/

　　运行： 

uwsgi --ini django.ini --protocol=http

uwsgi http is ambiguous 

　　这也是因为虚拟环境的原因，建议退出python的虚拟环境，然后pip install uwsgi。