Django Nginx uWSGI 部署详细教程

jopen 9年前

1. 运行开发服务器测试

cd zqxt # 进入项目 zqxt 目录  python manage.py runserver

运行开发服务器测试,确保开发服务器下能正常打开网站。

2. 安装 nginx 和 需要的包

2.1 安装 nginx 等软件

ubuntu / Linux Mint 等,下面简写为 (ubuntu):

sudo apt-get install python-dev nginx

centos / Fedora/ redhat 等,下面简写为 (centos)

sudo yum install epel-release  sudo yum install python-devel nginx

2.2 安装 supervisor, 一个专门用来管理进程的工具,我们用它来管理 gunicorn/uwsgi

sudo pip install supervisor

Ubuntu用户 请直接看 3,以下是CentOS 注意事项:

CentOS下,如果不是非常懂 SELinux 和 iptables 的话,为了方便调试,可以先临时关闭它们,如果发现部署了之后出不来结果,可以临时关闭测试一下,这样就知道是不是 SELinux 和 iptables 的问题

CentOS 7 iptables如何使用http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7


将 SELinux 设置为宽容模式,方便调试:

sudo setenforce 0

防火墙相关的设置:

可以选择临时关闭防火墙  sudo service iptables stop    或者开放一些需要的端口,比如 80  sudo iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT

上面的两条命令,如果是 CentOS 7 用

临时关闭防火墙  sudo systemctl stop firewalld    或者 开放需要的端口  sudo firewall-cmd --zone=public --add-port=80/tcp --permanent  sudo firewall-cmd --reload

备注:由于我还没有用 最新版本的 Fedora ,需要用 dnf 来安装包,有需求的同学自测,可以参考这里

3. 使用 gunicorn / uwsgi 来部署 (二选一)

注意:以下为二选一,不需要两个都用

3.1 使用 gunicorn(纯Python实现的包):

sudo pip install gunicorn

在项目目录下运行下面的命令进行测试:

gunicorn -w4 -b0.0.0.0:8001 zqxt.wsgi

-w 表示开启多少个worker,-b 表示要使用的ip和port,我们这里用的是 8001,0.0.0.0代表监控电脑的所有 ip。


如果使用了 virtualenv 可以这样

/path/to/env/bin/gunicorn --chdir /path/to/project --pythonpath /path/to/env/ -w4 -b0.0.0.0:8017 project.wsgi:application

用 --pythonpath 指定依赖包路径,多个的时候用逗号,隔开,如:'/path/to/lib,/home/tu/lib'

3.2 使用 uwsgi(纯C语言实现的包):

安装 uwsgi

sudo pip install uwsgi

使用 uwsgi 运行项目

uwsgi --http :8001 --chdir /path/to/project --home=/path/to/env --module project.wsgi

这样就可以跑了,--home 指定virtualenv 路径,如果没有可以去掉。project.wsgi 指 project/wsgi.py 文件

如果提示端口已经被占用:

probably another instance of uWSGI is running on the same address (:8002).  bind(): Address already in use [core/socket.c line 764]

这时可以把相关的进程 kill 掉:

按照端口进行查询:

lsof -i :8002

可以查出:

COMMAND  PID USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME  uwsgi   2208   tu    4u  IPv4 0x53492abadb5c9659      0t0  TCP *:teradataordbms (LISTEN)  uwsgi   2209   tu    4u  IPv4 0x53492abadb5c9659      0t0  TCP *:teradataordbms (LISTEN)

这时根据 PID 可以用下面的命令 kill 掉相关程序:

sudo kill -9 2208 2209

按照程序名称查询:

ps aux | grep uwsgi

4. 使用supervisor来管理进程

生成 supervisor 默认配置文件,比如我们放在 /etc/supervisord.conf 路径中:

sudo echo_supervisord_conf > /etc/supervisord.conf

打开 supervisor.conf 在最底部添加:

[program:zqxt]   command=/path/to/uwsgi --http :8003 --chdir /path/to/zqxt --module zqxt.wsgi   directory=/path/to/zqxt   startsecs=0   stopwaitsecs=0   autostart=true   autorestart=true

command 中写上对应的命令,这样,就可以用 supervisor 来管理了

supervisord -c /etc/supervisord.conf

重启 zqxt 程序(项目):

supervisorctl -c /etc/supervisord.conf restart zqxt

启动,停止,或重启 supervisor 管理的某个程序 或 所有程序:

supervisorctl -c /etc/supervisord.conf [start|stop|restart] [program-name|all]

以 uwsgi 为例,上面这样使用一行命令太长了,我们使用 ini 配置文件来搞定,比如项目在 /home/tu/zqxt 这个位置,

在其中新建一个 uwsgi.ini 全路径为 /path/to/project/uwsgi.ini

 [uwsgi]   chdir=/path/to/project   module=zqxt.wsgi:application   socket = /tmp/zqxt.sock   master=True   pidfile=/tmp/zqxt-master.pid   vacuum=True   max-requests=5000   daemonize=/path/to/project/zqxt.log

注意上面的 /tmp/zqxt.sock ,一会儿我们把它和 nginx 关联起来。

修改 supervisor 配置文件中的 command 一行:

[program:zqxt]   command=/path/to/uwsgi --ini /path/to/project/uwsgi.ini   directory=/path/to/zqxt   startsecs=0

然后重启一下 supervisor:

supervisorctl -c /etc/supervisord.conf restart zqxt  或者 supervisorctl -c /etc/supervisord.conf restart all

5. 配置 nginx

新建一个网站 zqxt

sudo vim /etc/nginx/sites-available/zqxt.conf

写入以下内容:

upstream zqxt_uwsgi {      server unix:///tmp/zqxt.sock;  }    server {      listen      80;      server_name www.ziqiangxuetang.com;      charset     utf-8;        client_max_body_size 75M;        location /media  {          alias /path/to/project/media;      }        location /static {          alias /path/to/project/static;      }        location / {          uwsgi_pass  zqxt_uwsgi;          include     /etc/nginx/uwsgi_params;      }  }

激活网站:

sudo ln -s /etc/nginx/sites-available/zqxt.conf /etc/nginx/sites-enabled/zqxt.conf

重启 nginx 服务器:

sudo service nginx reload  或者 sudo service nginx restart


一些有用的参考教程:

Django 官网部署教程:

https://docs.djangoproject.com/en/1.8/howto/deployment/wsgi/gunicorn/

https://docs.djangoproject.com/en/1.8/howto/deployment/wsgi/uwsgi/


一些博客相关教程:

http://www.ituring.com.cn/article/201045

http://www.jianshu.com/p/be9dd421fb8d

http://blog.csdn.net/tengzhaorong/article/details/12833157


nginx 与 socket

http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configure-nginx-for-your-site


防火墙:

iptables: https://www.digitalocean.com/community/tutorials/how-to-setup-a-basic-ip-tables-configuration-on-centos-6

centos 7 FireWalld: http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7

ubuntu ufw 防火墙:http://wiki.ubuntu.org.cn/Ufw%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97


uwsgi ini 配置文件:http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file

来自:http://www.ziqiangxuetang.com/django/django-nginx-deploy.html