使用 uWSGI + Nginx 部署 Flask 应用

首先，我用的Flask是0.8版本的，uwsgi是0.9.9.2版，nginx是1.0版本，这个版本很重要，因为uwsgi的0.9.8版和0.9.9.2版在command line上有些option是不同的，具体可以安装完uwsgi，在terminal里敲"wsgi -h"的帮助里看命令的option信息；nginx1.0版和nginx0.8版也有差别，nginx1.0里采用了和apache相似的sites-available和sites-enable来实现配置的virtual host组件化，而nginx0.8版里还是老风格，因为在我查资料时经常碰到别人的配置部署就OK，但在我的环境下就不行，其实一部分原因是和环境有关。操作系统我用的是ubuntu11.10

1）安装Flask，uwsgi，nginx

Flask：sudo apt-get install python-flask

uwsgi：可以看下http://library.linode.com/web-servers/nginx/python-uwsgi/ubuntu-10.10-maverick

nginx：sudo apt-get install nginx

2）创建Flask工程

这里就用最简单的HelloWorld，创建一个工程目录：myapp，里面包含以下文件：

文件名：myapp.py

代码：

from flask import Flask

app = Flask(__name__)

@app.route('/')

def hello():

     return 'Hello World'

if __name__ == '__main__':

       app.run()

3）配置 uwsgi

在刚才创建的myapp目录下创建一个uwsgi的xml配置文件myapp_config.xml:

<uwsgi>

     <pythonpath>[你的工程的根目录]</pythonpath>

     <module>[模块名，这里用myapp]</module>

     <callable>[因为app是启动整个服务的入口，所以是app]</callable>

     <socket>/tmp/uwsgi.sock</socket>       #注：这里的sock文件不是某个现成的文件，也不需要事先创建，运行时会自动创建，文件名也是自己定的，路径也是可以自己定的

     <master/>

     <processes>4</processes>                #注：跑几个线程，这里用4个线程

     <memory-report/>

</uwsgi>

4）配置 nginx

在/etc/nginx/sites-available/目录下，创建一个站点文件：site

server {
        listen 80;
        server_name www.myapp.com;

        location / {
                include uwsgi_params;
                uwsgi_pass unix:/tmp/uwsgi.sock;   #注：这里的sock文件和uwsgi的sock文件配的是同一个文件，因为nginx和uwsgi需要通过这个socket进行交互
        }
}

 然后用Linux的ln命令创建一个link到/etc/nginx/sites-enable/里，link的名字也叫site，删除sites-enable目录下的default的link

5）开始部署

启动uwsgi，命令是 sudo uwsgi -x myapp_config.xml，会打出很多的字，如果没有加载工程成功可以从打出的信息中看出，然后不要关闭该Terminal，新打开一个Terminal，在里面启动nginx：sudo /etc/init.d/nginx start，然后在浏览器里访问localhost，这时如果出现502页面，可以看下日志，我的日志是在/var/log/nginx/error.log，如果里面显示是sock文件因为权限问题无法访问，那只要利用chmod命令给sock文件赋上权限：chmod 777 /tmp/uwsgi.sock，然后uwsgi和nginx再重启一下，现在访问localhost就可以看到“Hello World！”，OK！