CentOS 环境下基于 Nginx uwsgi 搭建 Django 站点

因为我的个人网站 restran.net 已经启用，博客园的内容已经不再更新。请访问我的个人网站获取这篇文章的最新内容，CentOS 环境下基于 Nginx uwsgi 搭建 Django 站点

以下用一个网站 ocean_monitor 举例

MySQL 安装与配置

安装

MariaDB is shipped in the CentOS repo as of CentOS 7 instead of mysql.

if you still want to install mysql you need to add mysql rpm dependency into your yum repo.

sudo yum -y install mariadb-server mariadb-devel mariadb

sudo systemctl start mariadb.service

sudo systemctl enable mariadb.service

配置

mysql -u root -p

创建用户

CREATE USER ocean_monitor IDENTIFIED BY 'ocean_monitor_pwd';

上面建立的用户可以在任何地方登陆。如果要限制在固定地址登陆，比如 localhost 登陆：

CREATE USER ocean_monitor@localhost IDENTIFIED BY 'ocean_monitor_pwd';

创建数据库

# 使用utf8编码，否则中文会有问题

CREATE DATABASE ocean_monitor character set utf8;

授权 ocean_monitor 用户拥有 ocean_monitor 数据库的所有权限

grant all on ocean_monitor.* to ocean_monitor identified by 'ocean_monitor_pwd';

如果是限制在 localhost 登录的，则使用

grant all on ocean_monitor.* to ocean_monitor@localhost identified by 'ocean_monitor_pwd';

使用 PIP 安装依赖

为mysql-python安装依赖，这样才能编译安装

如果是Ubuntu用户

sudo apt-get install build-essential python-dev libmysqlclient-dev python-mysqldb

如果是Centos用户

yum install gcc python-devel

安装所有的依赖

# requirements.txt 是 django 项目目录下，填写的依赖包信息

pip install -r requirements.txt

测试 uWSGU

创建一个测试文件

# test.py

def application(env, start_response):

    start_response('200 OK', [('Content-Type','text/html')])

    return ["Hello World"] # python2

    #return [b"Hello World"] # python3

然后，Run uWSGI:

uwsgi --http :8000 --wsgi-file test.py

如果出现错误，!!! no internal routing support, rebuild with pcre support !!!

sudo apt-get install libpcre3 libpcre3-dev

sudo pip uninstall uwsgi

sudo apt-get remove uwsgi

sudo pip install uwsgi

打开下面url，浏览器上应该显示hello world

http://example.com:8000

如果显示正确，说明下面3个环节是通畅的：

the web client <-> uWSGI <-> Python

测试Django

我看别人用的是 --module mysite.wsgi，但是建 Django项目时，并没有生成这个文件，这里十分奇怪。因此，使用 Django 生成的 wsgi.py

uwsgi --http :8000 --wsgi-file wsgi.py

如果显示正确，说明下面3个环节是通畅的：

the web client <-> uWSGI <-> Django

Nginx 安装与配置

Nginx 安装

http://cantgis.blog.51cto.com/5788192/1540004

配置站点

vim /etc/nginx/conf.d/ocean_monitor.conf

添加配置信息

# ocean_monitor.conf

# the upstream component nginx needs to connect to

upstream django_ocean_monitor {

    # server unix:///path/to/your/mysite/mysite.sock; # for a file socket

    # for a web port socket (we'll use this first)

    server 127.0.0.1:8108;

}

# configuration of the server

server {

    # the port your site will be served on

    listen      8008;

    # the domain name it will serve for

    # substitute your machine's IP address or FQDN

    # Django 的 settings.py 文件中的 ALLOWED_HOSTS 要加上这里设置的 server_name

    server_name localhost;

    charset     utf-8;

    gzip on;

    gzip_min_length 1000;

    gzip_buffers 4 16k;

    gzip_http_version 1.1;

    gzip_comp_level 3;

    gzip_vary on;

    # 禁用对 IE 6 使用 gzip 压缩

    gzip_disable "MSIE [1-6]\.";

    gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml application/xml+rss application/json;

    ## Individual nginx logs

    access_log  /var/log/nginx/ocean_monitor_access.log;

    error_log   /var/log/nginx/ocean_monitor_error.log;

    # max upload size

    client_max_body_size 8M;   # adjust to taste

    # Django media

    location /media  {

        # your Django project's media files - amend as required

        alias /home/python/ocean_monitor/media;

    }

    location /static {

        # your Django project's static files - amend as required

        alias /home/python/ocean_monitor/static;

    }

    # Finally, send all non-media requests to the Django server.

    location / {

        uwsgi_pass  django_ocean_monitor;

        # the uwsgi_params file you installed

        #  增加 nginx 配置， uwsgi_params 文件在 /etc/nginx/ 目录下

        include     /etc/nginx/uwsgi_params;

    }

}

测试 nginx 的配置文件的语法是否正确

sudo nginx -t

重启 nginx

service nginx restart

Django 配置

settings.py 配置

设置 ALLOWED_HOSTS

Django gives Bad Request (400) when DEBUG = False

The ALLOWED_HOSTS list should contain fully qualified host names, not urls. Leave of the port and the protocol. If you are using 127.0.0.1, I'd add localhost to the list too

ALLOWED_HOSTS = [

    # 加上本机的IP地址

    '192.168.137.146',

    '127.0.0.1',

    'localhost'

]

You could also use * to match any host:

ALLOWED_HOSTS = ['*']

设置 DATABASES

DATABASES = {

    'default': {

        'ENGINE': 'django.db.backends.mysql',

        'NAME': 'ocean_monitor',

        'USER': 'ocean_monitor',

        'PASSWORD': 'ocean_monitor_pwd',

        'HOST': 'localhost',

        'PORT': '3306',

    }

}

初始化数据库

python manage.py syncdb

启动一下，测试 Django 有没有问题

python manage.py runserver 0.0.0.0:8080

uWSGI 配置文件

在 Django 项目的根目录添加 uwsgi.ini 文件

# uwsgi.ini file

[uwsgi]

# Django-related settings

# the base directory (full path)

chdir           = /home/python/ocean_monitor

# Django's wsgi file

wsgi-file       = /home/python/ocean_monitor/ocean_monitor/wsgi.py

# module       = index.wsgi:application

# the virtualenv (full path)

# home            = /path/to/virtualenv

daemonize	= /home/python/ocean_monitor/ocean_monitor.log

# process-related settings

# master

master          = true

pidfile		= /tmp/ocean_monitor_master.pid

# maximum number of worker processes

processes       = 3

# the socket (use the full path to be safe

# socket          = /home/python/ocean_monitor/ocean_monitor.sock

socket          = 127.0.0.1:8108

# ... with appropriate permissions - may be needed

chmod-socket    = 664

# clear environment on exit

vacuum          = true

uwsgi 启动与结束

# 启动

uwsgi --ini uwsgi.ini

# 重启

uwsgi --reload /tmp/ocean_monitor_master.pid

# 结束

uwsgi --stop /tmp/ocean_monitor_master.pid

如果出现错误 signal_pidfile()/kill(): No such process [core/uwsgi.c line 1627]，是由于 ocean_monitor_master.pid 的进程ID不正确，修改/tmp/ocean_monitor_master.pid为正确的pid就可以。

使用如下命令，查询指定端口的进程id

sudo netstat -ap | grep 8108

修改 /tmp/ocean_monitor_master.pid 的进程id值

vim /tmp/ocean_monitor_master.pid

使用 supervisor 启动 celery-worker 及 celery-beat

安装 supervisor

安装

pip install supervisor

安装方法请参考

http://www.iitshare.com/supervisord-manage-process.html

生成配置文件

安装好supervisor之后，默认是没有生成配置文件的。可以通过以下命令生成配置文件

echo_supervisord_conf > /etc/supervisord.conf

启动

supervisord -c /etc/supervisord.conf  # 到指定路径下去找配置文件

如果出现

another program is already listening on a port that one of our HTTP servers is configured to use

sudo unlink /etc/supervisor.sock

然后再次运行

supervisord -c /etc/supervisord.conf

supervisor 管理

supervisor 安装完成后有两个可用的命令行 supervisor 和 supervisorctl，命令使用解释如下：

supervisord，初始启动Supervisord，启动、管理配置中设置的进程。

supervisorctl stop programxxx，停止某一个进程(programxxx)，programxxx为[program:chatdemon]里配置的值，这个示例就是chatdemon。

supervisorctl start programxxx，启动某个进程

supervisorctl restart programxxx，重启某个进程

supervisorctl stop groupworker: ，重启所有属于名为groupworker这个分组的进程(start,restart同理)

supervisorctl stop all，停止全部进程，注：start、restart、stop都不会载入最新的配置文件。

supervisorctl reload，载入最新的配置文件，停止原有进程并按新的配置启动、管理所有进程。

supervisorctl update，根据最新的配置文件，启动新配置或有改动的进程，配置没有改动的进程不会受影响而重启。

注意：显示用stop停止掉的进程，用reload或者update都不会自动重启。

设置配置文件

vim /etc/supervisord.conf

在文件最后添加如下信息

[program:ocean_monitor_celery_worker]

process_name = ocean_monitor_celery_worker

command=python /home/python/ocean_monitor/manage.py celery worker --loglevel=info

directory=/home/python/ocean_monitor

autorestart=true

redirect_stderr=true

stdout_logfile = /var/log/supervisord/ocean_monitor_celery_worker.log

loglevel=info

[program:ocean_monitor_celery_beat]

process_name = ocean_monitor_celery_beat

command=python /home/python/ocean_monitor/manage.py celery beat --loglevel=info

directory=/home/python/ocean_monitor

autorestart=true

redirect_stderr=true

stdout_logfile = /var/log/supervisord/ocean_monitor_celery_beat.log

loglevel=info

用 supervisor 运行前，可以先在命令行下启动测试一下

python manage.py celery beat --loglevel=info

python manage.py celery worker --loglevel=info

启动

# 根据最新的配置文件，启动新配置或有改动的进程

# 配置没有改动的进程不会受影响而重启

supervisorctl update

防火墙设置及 SELinux 问题

设置防火墙开放端口（iptables）

/sbin/iptables -I INPUT -p tcp --dport 8008 -j ACCEPT

nginx permission denied 问题

因为忘记了 selinux 的问题，导致 trouble shooting 耽误了不少时间。

由于SELinux的问题，会导致nginx nginx permission denied 的问题，需要将 selinux 关闭。

查看SELinux状态：

# 如果SELinux status参数为enabled即为开启状态

/usr/sbin/sestatus -v

也可以用 getenforce 这个命令检查

关闭SELinux

# 只是临时关闭（不用重启机器），重启后问题仍然出现

# 设置SELinux 成为permissive模式

setenforce 0

# setenforce 1 # 设置SELinux 成为enforcing模式

永久关闭，需要通过修改配置文件，但是需要重启机器：

vim /etc/selinux/config

将SELINUX=enforcing 改为 SELINUX=disabled，重启机器即可

shutdown -r now