CentOS 下用 Nginx 和 uwsgi 部署 flask 项目

前一阵本身用flask框架写了一个博客程序，写完以后想部署到服务器上，由于是小白，因此本身google了好些资料，讲的零零碎碎并且有些地方只是告诉你怎么配置，但具体为何这样配却没有说明，因此本身总结了一篇从头至尾的过程。

服务器上部署项目说白了就是让你的项目在这台服务器上运行而且作到能够在公网上访问你的项目。
那么若是要作到这两点，须要作的工做有以下几个方面：

1. 服务器的环境搭建，让服务器具备运行项目的必要环境

2. 上传你的项目代码到服务器

3. 配置服务器代理，处理来自Internet上的请求。

1. 服务器的环境搭建

首先说一下系统的选择问题，先排除掉Windows系统，在Linux系统下，Ubuntu,Debian,CentOS都很不错。

Ubuntu有强大的软件源支持，但它更适合于桌面操做系统。Debian稳定，占硬盘空间小，占内存小，但发展过快，其安全性和稳定性都没有CentOS好。因此我选择了CentOS。对于三者的比较能够看 http://waynerqiu.com/7/156.html。

买来的服务器须要用远程链接来操做，这里推荐使用putty。我使用的是CentOS 6.3 x86_64，不一样的版本可能在安装软件的地址可能会有些不一样。

Linux系统下自带了低版本的python，能够经过python -V查看。自带的python版本会和系统的一些功能有关联，好比yum。

flask项目须要python2.7以上的版本，因此咱们须要在系统中安装python2.7或python3.5。

下载并安装 Python 2.7.5：

#wget http://www.python.org/ftp/python/2.7.5/Python-2.7.5.tar.bz2

若是此时没有wget，能够经过yum install wget来安装

#tar jxvf Python-2.7.5.tar.bz2
#cd Python-2.7.5
#./configure --prefix=/usr/local
#make && make install

这时的python2.7.5还不是咱们系统将会使用的python(如今键入python -V后，显示的还会是低版本的python)。因此须要创建软链接，使系统默认的python指向python2.7.5。

#mv /usr/bin/python /usr/bin/python2.4.3   //你的python版本可能不一样
#ln -s /usr/local/bin/python27 /usr/bin/python

使用了新版本的python会致使yum安装软件报错，由于yum没有兼容python2.7，因此咱们要指定yum使用的python版本。

#vi /usr/bin/yum

进入编辑模式，将#!/usr/bin/python改为#!/usr/bin/python2.7.5

安装相关的开发工具盒和一些包

#yum groupinstall "Development tools"
#yum install zlib zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel

安装pip

# wget https://pypi.python.org/packages/source/p/pip/pip-1.3.1.tar.gz --no-check-certificate

因为下载pip是基于https协议的，故须要在wget url后面加上--no-check-certificate，不然不能下载。

解压和安装pip

#chmod +x pip-1.3.1.tar.gz 
#tar xzvf pip-1.3.1.tar.gz 
#cd pip-1.3.1 
#python setup.py install

在最后一步可能会报错"ImportError: No module named setuptools"，缘由是没有安装setuptools

安装setuptools

#wget https://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg  --no-check-certificate 
#chmod +x setuptools-0.6c11-py2.7.egg 
#sh setuptools-0.6c11-py2.7.egg

这一步也有可能报错"zlib not available"，可使用#rpm -qa | grep zlib 查看可用的安装包，将没有安装的安装上(上面咱们已经安装了zlib和zlib-devel)

再次运行sh setuptools-0.6c11-py2.7.egg，发现仍是报错？一样的错误？

那么这应该不是zlib的问题，而是python的问题，咱们须要从新编译python2.7.5，在编译以前须要修改一下Modules/Setup.dist文件。找到

#zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz

将注释去掉，从新编译python2.7.5

#cd Python-2.7.5
#./configure --prefix=/usr/local
#make && make install

这样zlib应该能够用了，回到setuptools的安装，再回到pip的安装，这回总算把pip安装上了。你能够在全局环境下安装flask相关的包(若是你的服务器中包括未来只想运行一个项目的话），也能够将包安装在虚拟环境中。先别急，把项目代码上传了再说。

2. 上传你的项目代码到服务器

接下来能够上传你的flask项目代码到服务器上，可使用flashFXP或者FileZilla来上传。

这里按照个人上传目录来介绍接下来的步骤，个人flask项目代码放在了 /home/www/WebBlogold（WebBlogold就是个人项目文件夹）。不明白Linux目录结构？能够google一下，这里推荐一篇 http://yangrong.blog.51cto.com/6945369/1288072。

若是你的服务器上有多个项目，那么建议你安装virtualenv虚拟环境。virtualenv能够解决项目与项目之间对同一个包的不一样版本的依赖问题。

使用pip安装virtualenv虚拟环境

pip install virtualenv

进入项目目录，在目录下键入 virtualenv venv，其中venv是你要建的虚拟环境文件夹的名字，结果会出现下面两行

New python executable in venv/bin/python
Installing setuptools, pip...done.

说明文件夹已经建好，使用 source venv/bin/activate 命令来启用虚拟环境，启用后你当前的路径名的前面会有一个(venv)。

在虚拟环境下安装flask相关包，你能够一个一个安装，也能够将全部的包写在一个txt文件里，一次性安装。

flaskrelated.txt文件：

Flask==0.10.1
Flask-Login==0.2.11
Flask-Mail==0.9.1
Flask-Moment==0.4.0
Flask-PageDown==0.1.5
Flask-SQLAlchemy==2.0
等等

保存在你的项目文件夹下，在虚拟环境中键入 pip install -r flaskrelated.txt 来安装他们。

3. 配置服务器代理

个人服务器代理是安装在全局中的，固然你也能够在虚拟环境里安装。

使用的代理一共有两个，nginx和uwsgi，先说明一下，若是不用nginx同样能够访问你的项目，使用nginx的目的是为了安全和负载均衡。配置了nginx作前端代理，uwsgi做后端代理的服务器(这里所说的先后端都是相对的位置，并没有实际含义)，在处理来自Internet的请求时，要先通过nginx的处理，nginx把请求再交给uwsgi，通过uwsgi才能访问到项目自己。

没有nginx而只有uwsgi的服务器，则是Internet请求直接由uwsgi处理，并反馈到咱们的项目中。
nginx能够实现安全过滤，防DDOS等保护安全的操做，而且若是配置了多台服务器，nginx能够保证服务器的负载相对均衡。

而uwsgi则是一个web服务器，实现了WSGI协议(Web Server Gateway Interface)，http协议等，它能够接收和处理请求，发出响应等。因此只用uwsgi也是能够的。

先安装uwsgi

pip install uwsgi

在你的项目根目录下建立一个配置文件uwsgiconfig.ini(uwsgi支持多种配置文件格式，xml，ini，json等)

[uwsgi]

socket = 127.0.0.1:8001     //启动程序时所使用的地址和端口，一般在本地运行flask项目，
                            //地址和端口是127.0.0.1:5000,
                            //不过在服务器上是经过uwsgi设置端口，经过uwsgi来启动项目，
                            //也就是说启动了uwsgi，也就启动了项目。
chdir = /home/www/     //项目目录

wsgi-file = manage.py      //flask程序的启动文件，一般在本地是经过运行  
                           //      python manage.py runserver 来启动项目的

callable = app      //程序内启用的application变量名

processes = 4     //处理器个数

threads = 2     //线程个数

stats = 127.0.0.1:9191      //获取uwsgi统计信息的服务地址

保存配置文件，咱们能够经过键入 uwsgi uwsgiconfig.ini 来启动uwsgi。

安装nginx：因为nginx不在yum安装软件源里，因此添加上

#rpm -ivh http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm
#yum install nginx

nginx的一些命令

• 启动： nginx

• 中止： nginx -s -stop

• 强制中止： pkill -9 nginx

• 查看nginx是否应用配置文件: nginx -t

• 查看版本： nginx -v

先别急着启动咱们的nginx代理服务器，先来写一下nginx的配置文件。

nginx的配置文件在/etc/nginx/conf.d/文件夹下，也有可能在/etc/nginx/sites-enabled/default。咱们打开默认的配置文件，大部份内容都是加注释的，须要咱们修改。

events {
    worker_connections  1024;
}
http {
    include       mime.types;    
    default_type  application/octet-stream;    
    sendfile        on;    
    keepalive_timeout  65;

    server {
        listen       80;         //默认的web访问端口
        server_name  xxx.xxx.xxx.xxx;     //你的公网ip
        #charset koi8-r;
        access_log  /home/www/WebBlogold/logs/access.log;    //服务器接收的请求日志，
                                                             //须要在项目文件夹下建立
                                                             //logs文件夹，下同。
        error_log  /home/www/WebBlogold/logs/error.log;         //错误日志

        location / {

            include        uwsgi_params;     //这里是导入的uwsgi配置

            uwsgi_pass     127.0.0.1:8001;   //须要和uwsgi的配置文件里socket项的地址
                                             //相同,不然没法让uwsgi接收到请求。

            uwsgi_param UWSGI_PYHOME /home/www/WebBlogold/venv;   //python的位置(虚拟环境下)

            uwsgi_param UWSGI_CHDIR  /home/www/WebBlogold;     //项目根目录

            uwsgi_param UWSGI_SCRIPT manage:app;     //启动项目的主程序(在本地上运行
                                                     //这个主程序能够在flask内置的
                                                     //服务器上访问你的项目)

        }
    }
}
下面是一堆#，全都是注释，不用管它。

在启动nginx时，若是发现报错"98:Address already in use",不要着急，颇有多是由于你的nginx已经启动了。

经过 netstat -ntlp 查看端口占用状况，看看是否是你的nginx占用的80端口。若是发现有其余程序占用了nginx的默认的80端口，能够杀掉这些进程，再启动nginx。

到此，咱们终于完成了全部的工做，立刻就能够访问本身的项目了。

如今，检查一下nginx的配置文件是否应用 nginx -t 没有成功应用的话，检查一下配置文件。

1. 键入 nginx 来启动nginx

2. 键入uwsgi uwsgiconfig.ini 启动uwsgi

这时uwsgi会告诉你你的项目是否有错误，若是本地运行良好，通常是没有错误的。

有可能会报的错是项目相关模块的引入路径不对，修改一下即可。没有报错的话，打开浏览器，输入你的服务器IP地址，或者若是你有相应的域名，并解析到了你的IP，输入域名也能够。

若是一切顺利的话，显示的就是你想要的页面了，若是不是，首先查看一下日志文件，他们在你的项目根目录下logs文件夹里。