Ubuntu 部署 Flask + WSGI + Nginx 详解

共计 6578 个字符，预计需要花费 17 分钟才能阅读完成。

入手了一台阿里云服务器，是 Ubuntu 14.04 32 位版本，最初考虑是用来尝尝鲜只是买了个最低配的，价格算起来与在国外买个空间的价格相当吧（可能一年才贵 100 多），但用起来感觉就很不错，速度那是一个字：快。

自从倒戈向 Linux 世界后，对于一切大而全的开发框架与软件都有一种不讨喜的感觉，个人更喜欢于使用那些小而精，高性能高产生力的软件和开发框架，So 我现在的第一语言是 Python 和 Coffee，开发框架就当然是 AngularJS (前端) + Flask (后端)，关于 AngularJS 与 Flask 不在本文的叙述范围之内，本文解决的是 Flask 最后一公里的问题：Linux 部署。

我采用的部署方案是：

• Web 服务器采用 uwsgi host Flask
• 用 Supervisor 引用 uwsgi 作常规启动服务
• 基于 Nginx 作反向代理

首先, 阿里云服务器可以通过 SSH 指令在本机的终端进行远程连接

ssh root@ 云服务器地址 

输入密码进入后所有的操作与本地终端完全一至。

安装 Python 环境

接下来是 python , Ubuntu 的默认环境已经预装 python 2.7 所以只需要安装 python 的 pip 安装工具即可。pip 用于安装一些基于 python 应用的软件工具，在下文中将会频繁使用。

PIP

如果用 python 而不懂 [pip|http://pypi.python.org/] 那最好就快点脑补吧, 指令如下：

sudo apt-get install pip

VirtualEnv

不同的项目可能会引用各种不同的依赖包，为了避免版本与和应用之间的冲突而造成的“依赖地狱”
[Virtualenv | https://virtualenv.readthedocs.org/en/latest/] 就是我们 python 项目的必须品了。VirtualEnv 可以为每个 Python 应用创建独立的开发环境，使他们互不影响，Virtualenv 能够做到：

• 在没有权限的情况下安装新套件
• 不同应用可以使用不同的套件版本
• 套件升级不影响其他应用

安装：

sudo pip install virtualenv

安装 VirtualEnv 后只需要在项目目录内运行 virtualenv 目录名 就可以建立一个虚拟环境文件夹，然后启用 activate 指令即可启用该 python 虚拟环境，具体操作如下：

假定我的项目目录叫 /home/www/my_flask，首先安装虚拟环境 (我习惯使用的虚拟环境目录叫 venv )

my_flask root$ virtualenv venv

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

在项目目录下就会建立一个新的 venv 目录，里面就是运行 python 的基本环境的工具与指令，和包。然后启用该环境，使用当前命令行状态进入虚拟环境，进入虚拟环境后，一切安装 python 的操作都会将包和引用装在虚拟环境内，而不会影响到全局的 python 环境。

my_flask root$ source venv/bin/activate 

(venv)my_flask root$ 

调用 activate 指令后命令符前就会出现 (venv) 字样。可通过 deactivate 退出虚拟环境。

安装 uWSGI

Flask 的实际生产运行环境选择并不多，比较成熟的是 [Gunicorn|http://gunicorn.org/] 和 [uWSGI|https://github.com/unbit/uwsgi]，听说 Gunicorn 的配置很简单，但可惜我一直没有配置成功过，我现采用的是 uWSGI。接下来就安装 uWSGI 吧。

(venv)my_flask root$ pip install uwsgi

在虚拟环境下不需要使用 sudo，因为 virtualenv 是没有权限要求的。

这个安装很迅速，基本是秒成。安装完成后我们可以先放下 uWSGI 不表，在后面再回过来配置他，因为我们首先要将关键的 Flask 环境和我们的项目文件传到服务器目录内。

安装 Flask

我是用清单文件一次性安装 Flask 和他的相关依赖的，这样会更快。我的引用清单是这样的：
requirements.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
Flask-Script==2.0.5
Flask-WTF==0.10.2
Flask-Cache==0.13.1
Flask-Restless==0.15.0
Flask-Uploads==0.1.3
Jinja2==2.7.3
Mako==1.0.0
Markdown==2.5.1
MarkupSafe==0.23
SQLAlchemy==0.9.8
WTForms==2.0.1
Werkzeug==0.9.6
html5lib==1.0b3
itsdangerous==0.24
six==1.8.0
awesome-slugify==1.6

可以想像，如果一个一个装非疯了不可。
安装清单文件：

(venv)my_flask root$ pip install -r requirements.txt

在此还是重重地提一下：一定要注意在运行这个安装之前启用了 python 虚拟环境，否则会直接安装到全局去的！

项目文件

接下来就是上传 Flask 的项目文件，之前我在各大的“转载专业户”里找了好多的资料，在这一步中大多只是在上面加个标准的 Flask 运行文件，虽说做个范例可以但说实在的这很让人迷惑，为什么？先看看代码吧：

from flask import Flask
 
app = Flask(__name__)
 
@app.route("/")
def hello():
    return "Hello World!"

生产环境内，谁会用这样的代码呢，这只是 Flask 的最简入门范，我的 Flask 项目中 app 是被做在包内的，相信很多人都是这样做的，在包外我们采用 Flask Script 写一个 manage.py 文件 作为启动文件，这更方便于支持各种的项目，包括可以安装到 window 下的 FastCGI 中。

那么我的 这个 manage.py 是这个样子的：

#!/usr/bin/env python
import os

if os.path.exists('.env'):
    print('Importing environment from .env...')
    for line in open('.env'):
        var = line.strip().split('=')
        if len(var) == 2:
            os.environ[var[0]] = var[1]

from app import create_app
from flask.ext.script import Manager, Shell

# 通过配置创建 app 
app = create_app(os.getenv('FLASK_CONFIG') or 'default')
manager = Manager(app)

def make_shell_context():
    return dict(app=app)


manager.add_command("shell", Shell(make_context=make_shell_context))

@manager.command
def deploy():
    """Run deployment tasks."""
    pass


if __name__ == '__main__':
    manager.run()

这样做我地开发环境可以这样运行 Flask:

python manage.py runserver

更详细的做法请参考 [Flask Script|http://flask-script.readthedocs.org/en/latest/] 扩展

好吧，我们可以用 支持 SSH 的 FTP 工具将 Flask 项目文件上传到服务器上，下面是整个项目文件结构：

www/
└── my_flask  
│   ├── logs
│   └── venv  // 虚拟目录 
│   │   ├── bin
│   │   │         ├── activate
│   │   │         ├── easy_install
│   │   │         ├── gunicorn
│   │   │         ├── pip
│   │   │         └── python
│   │   ├── include
│   │   │          └── python2.7 -> /usr/include/python2.7
│   │   ├── lib
│   │   │         └── python2.7
│   │   ├── local
│   │   │         ├── bin -> /home/shenye/shenyefuli/bin
│   │   │         ├── include -> /home/shenye/shenyefuli/include
│   │   │         └── lib -> /home/shenye/shenyefuli/lib
│   └── app  //Flask 程序目录 
│   │           └──  __init__.py // 这是程序包文件。这个目录下还有其它的文件此处略过 
│   ├── manage.py	
│   ├── requirements.txt			    

配置 uwsgi

好了，项目的准备工作已经做完了，是时候回过头去配置 uwsgi 了，它的具体指令可以去看它的官方文档，我们在这里采用其中的一种指令方式：配置起动。我采用 .ini 文件作为配置，在项目目录下创建一个 confg.ini（具体见下文）写好后可以这样执行

(venv)my_flask root$ uwsgi config.ini

我认为是最简单的方式，也容易更改。好了重要部分来了，config.ini 是这样写的：

[uwsgi]

# uwsgi 启动时所使用的地址与端口 
socket = 127.0.0.1:8001 

# 指向网站目录 
chdir = /home/www/ 

# python 启动程序文件 
wsgi-file = manage.py 

# python 程序内用以启动的 application 变量名 
callable = app 

# 处理器数 
processes = 4

# 线程数 
threads = 2

# 状态检测地址 
stats = 127.0.0.1:9191

注意：callable=app 这个 app 是 manage.py 程序文件内的一个变量，这个变量的类型是 Flask 的 application 类。

运行 uwsgi

“`
(venv)my_flask root$ uwsgi config.ini

[uWSGI] getting INI configuration from config.ini

*** Starting uWSGI 2.0.8 (64bit) on [Fri Dec 19 14:34:11 2014]
// 此处略去那些无用的启动信息
Stats server enabled on 127.0.0.1:9191 fd: 15 ***
“`

OK，此时已经正常启动 uwsgi 并将 Flask 项目载入其中了，ctrl+c 关闭程序。但这只是命令启动形式，要使其随同服务器启动并作为后台服务运行才是运营环境的实际所需要。因此接下来我们需要安装另一个工具来引导 uwsgi。

安装 Supervisor

[Supervisor|http://supervisord.org/configuration.html] 可以同时启动多个应用，最重要的是，当某个应用 Crash 的时候，他可以自动重启该应用，保证可用性。

sudo apt-get install supervisor

Supervisor 的全局的配置文件位置在：

/etc/supervisor/supervisor.conf

正常情况下我们并不需要去对其作出任何的改动，只需要添加一个新的 *.conf 文件放在

/etc/supervisor/conf.d/

下就可以，那么我们就新建立一个用于启动 my_flask 项目的 uwsgi 的 supervisor 配置 (命名为：my_flask_supervisor.conf)：

[program:my_flask]
# 启动命令入口 
command=/home/www/my_flask/venv/bin/uwsgi /home/www/my_flask/config.ini

# 命令程序所在目录 
directory=/home/www/my_flask
# 运行命令的用户名 
user=root
		
autostart=true
autorestart=true
# 日志地址 
stdout_logfile=/home/www/my_flask/logs/uwsgi_supervisor.log		   

启动服务

sudo service supervisor start

终止服务

sudo service supervisor stop

安装 Nginx

[Nginx|http://nginx.com/] 是轻量级、性能强、占用资源少，能很好的处理高并发的反向代理软件。

sudo apt-get install nginx

配置 Nginx

Ubuntu 上配置 Nginx 也是很简单，不要去改动默认的 nginx.conf 只需要将

/ext/nginx/sites-available/default

文件替换掉就可以了。

新建一个 default 文件:

	server {listen  80;
	  server_name XXX.XXX.XXX; # 公网地址 
	
	  location / {include      uwsgi_params;
		uwsgi_pass   127.0.0.1:8001;  # 指向 uwsgi 所应用的内部地址, 所有请求将转发给 uwsgi 处理 
		uwsgi_param UWSGI_PYHOME /home/www/my_flask/venv; # 指向虚拟环境目录 
		uwsgi_param UWSGI_CHDIR  /home/www/my_flask; # 指向网站根目录 
		uwsgi_param UWSGI_SCRIPT manage:app; # 指定启动程序 
	  }
	}

将 default 配置文件替换掉就大功告成了！
还有，更改配置还需要记得重启一下 nginx:

sudo service nginx restart

总结

阿里云的服务器运行速度很不错，加上 Flask+uWSGI+nginx 这种高性能结构，整个网站响应速度极为之快，每页响应速度不到 0.1s , 与之相比我之前使用 C# 部署在 Avarix 上的网站（同一个程序，不同语言实现）每页响应速度至少 2s 这简直是 200:1 的性能，当然我还没有闲到去专们用软件去测这两者之间的差值，写本文的目的也是对此作一记录，以便以后回顾。

Ubuntu Server 14.04.2 LTS 配置 Nginx + Uwsgi + Django  http://www.linuxidc.com/Linux/2015-04/116397.htm

Ubuntu 12.04 下部署 Nginx+uWSGI+Flask http://www.linuxidc.com/Linux/2014-01/96007.htm

你应该使用 Nginx + uWSGI http://www.linuxidc.com/Linux/2013-07/87286.htm

uWSGI + Nginx 部署 Flask Web 应用 http://www.linuxidc.com/Linux/2013-06/85828.htm

Django+Nginx+uWSGI 部署 http://www.linuxidc.com/Linux/2013-02/79862.htm

Linux 下 Nginx+uWSGI 部署 Python 应用 http://www.linuxidc.com/Linux/2012-10/72443.htm

Ubuntu Server 12.04 安装 Nginx+uWSGI+Django 环境 http://www.linuxidc.com/Linux/2012-05/60639.htm

CentOS 5.5 + Nginx 0.8.50 + uWSGI + Django 1.2.3 部署 Django 项目 http://www.linuxidc.com/Linux/2011-05/36399.htm

Nginx 的详细介绍 ：请点这里
Nginx 的下载地址 ：请点这里

更多 Ubuntu 相关信息见 Ubuntu 专题页面 http://www.linuxidc.com/topicnews.aspx?tid=2

本文永久更新链接地址 ：http://www.linuxidc.com/Linux/2015-09/123593.htm