在 Ubuntu 上使用 Nginx 部署 Flask 应用

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

我职业生涯的大部分都在使用微软的架构，最近我决定走出技术的舒适区，步入开源软件世界。我现在日常工作的项目是一个 RESTful 服务，这个服务需要在主流硬件上运行，且能够按照需要进行水平拓展。为完成这项工作我决定使用 Flask 和 Nginx。Flask 是一个轻量级的 Python Web 框架，Nginx 是一个非常稳定的 Web 服务器，它们在廉价硬件平台上工作良好。

在这篇文章中我将指导你完成使用 Nginx 服务器托管 Flask 应用的安装、配置过程。我所使用的操作系统是 Ubuntu 13.04。

前提条件

在我们开始安装 Nginx 及其他所需软件之前先安装一些前提软件。首先，我们需要 PIP 与 virtualenv：

sudo apt-get install python-setuptools
sudo easy_install pip
sudo pip install virtualenv

使用 apt-get 安装 Nginx 的话，我们需要添加 Nginx 库到 apt-get source 中：

sudo add-apt-repository ppa:nginx/stable

注意：如果“add-apt-repository”命令在你的 Ubuntu 版本中不存在的话，你需要安装“software-properties-common”包，使用命令：sudo apt-get software-properties-common（感谢 get_with_it 在评论中提到）

升级已有的包，确保系统上有 uWSGI 所需的编译器和工具：

sudo apt-get update && sudo apt-get upgrade

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

Nginx

安装并运行 Nginx：

sudo apt-get install nginx
sudo /etc/init.d/nginx start

Nginx 是一个提供静态文件访问的 web 服务，然而，它不能直接执行托管 Python 应用程序，而 uWSGI 解决了这个问题。让我们先安装 uWSGI，稍候再配置 Nginx 和 uWSGI 之间的交互。

sudo pip install uwsgi

里程碑 #1

打开浏览器访问你的服务器，你应该能看到 Nginx 欢迎页：

示例应用

我们将托管的应用是经典的“Hello, world!”。这个应用只有一个页面，已经猜到页面上将有什么内容了吧。将所有应用相关的文件存放在 /var/www/demoapp 文件夹中。下面创建这个文件夹并在其中初始化一个虚拟环境：

sudo mkdir /var/www
sudo mkdir /var/www/demoapp

由于我们使用 root 权限创建了这个文件夹，它目前归 root 用户所有，让我们更改它的所有权给你登录的用户（我的例子中是 ubuntu）

sudo chown -R ubuntu:ubuntu /var/www/demoapp/

创建并激活一个虚拟环境，在其中安装 Flask：

cd /var/www/demoapp
virtualenv venv
. venv/bin/activate
pip install flask

使用下面的代码创建 hello.py 文件：

from flask import Flask
app = Flask(__name__)
 
@app.route(“/”)
def hello():
    return “Hello World!”
 
if __name__ == “__main__”:
    app.run(host=’0.0.0.0′, port=8080)

里程碑 #2

让我们执行我们刚创建的脚本：

python hello.py

现在你可以通过浏览器访问你服务器的 8080 端口，看，应用生效了：

注意：因为 80 端口已被 Nginx 使用，这里我使用 8080 端口。

现在应用是由 Flask 内置的 web 服务托管的，对于开发和调试这确实是个不错的工具，但不推荐在生产环境中使用。让我们配置 Nginx 来挑起这个重担吧。

更多详情见请继续阅读下一页的精彩内容：http://www.linuxidc.com/Linux/2015-09/123597p2.htm

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 的默认配置文件：

sudo rm /etc/nginx/sites-enabled/default

注意：如果你安装了其他版本的 Nginx，默认配置文件可能在 /etc/nginx/conf.d 文件夹下。

创建一个我们应用使用的新配置文件 /var/www/demoapp/demoapp_nginx.conf：

server {
    listen      80;
    server_name localhost;
    charset    utf-8;
    client_max_body_size 75M;
 
    location / {try_files $uri @yourapplication;}
    location @yourapplication {
        include uwsgi_params;
        uwsgi_pass unix:/var/www/demoapp/demoapp_uwsgi.sock;
    }
}

将刚建立的配置文件使用符号链接到 Nginx 配置文件文件夹中，重启 Nginx：

sudo ln -s /var/www/demoapp/demoapp_nginx.conf /etc/nginx/conf.d/
sudo /etc/init.d/nginx restart

里程碑 #3

访问服务器的公共 ip 地址，你会看到一个错误：

别担心，这个错误是正常的，它代表 Nginx 已经使用了我们新创建的配置文件，但在链接到我们的 Python 应用网关 uWSGI 时遇到了问题。到 uWSGI 的链接在 Nginx 配置文件的第 10 行定义：

uwsgi_pass unix:/var/www/demoapp/demoapp_uwsgi.sock;

这代表 Nginx 和 uWSGI 之间的链接是通过一个 socket 文件，这个文件位于/var/www/demoapp/demoapp_uwsgi.sock。因为我们还没有配置 uWSGI，所以这个文件还不存在，因此 Nginx 返回“bad gateway”错误，让我们马上修正它吧。

配置 uWSGI

创建一个新的 uWSGI 配置文件/var/www/demoapp/demoapp_uwsgi.ini：

[uwsgi]
#application’s base folder
base = /var/www/demoapp
 
#python module to import
app = hello
module = %(app)
 
home = %(base)/venv
pythonpath = %(base)
 
#socket file’s location
socket = /var/www/demoapp/%n.sock
 
#permissions for the socket file
chmod-socket    = 666
 
#the variable that holds a flask application inside the module imported at line #6
callable = app
 
#location of log files
logto = /var/log/uwsgi/%n.log

创建一个新文件夹存放 uWSGI 日志，更改文件夹的所有权：

sudo mkdir -p /var/log/uwsgi
sudo chown -R Ubuntu:ubuntu /var/log/uwsgi

里程碑 #4

执行 uWSGI，用新创建的配置文件作为参数：

uwsgi –ini /var/www/demoapp/demoapp_uwsgi.ini

接下来访问你的服务器，现在 Nginx 可以连接到 uWSGI 进程了：

我们现在基本完成了，唯一剩下的事情是配置 uWSGI 在后台运行，这是 uWSGI Emperor 的职责。

uWSGI Emperor

uWSGI Emperor (很拉风的名字，是不？) 负责读取配置文件并且生成 uWSGI 进程来执行它们。创建一个初始配置来运行 emperor – /etc/init/uwsgi.conf：

description “uWSGI”
start on runlevel [2345]
stop on runlevel [06]
respawn
 
env UWSGI=/usr/local/bin/uwsgi
env LOGTO=/var/log/uwsgi/emperor.log
 
exec $UWSGI –master –emperor /etc/uwsgi/vassals –die-on-term –uid www-data –gid www-data –logto $LOGTO

最后一行运行 uWSGI 守护进程并让它到 /etc/uwsgi/vassals 文件夹查找配置文件。创建这个文件夹，在其中建立一个到链到我们刚创建配置文件的符号链接。

sudo mkdir /etc/uwsgi && sudo mkdir /etc/uwsgi/vassals

sudo ln -s /var/www/demoapp/demoapp_uwsgi.ini /etc/uwsgi/vassals

同时，最后一行说明用来运行守护进程的用户是 www-data。为简单起见，将这个用户设置成应用和日志文件夹的所有者。

sudo chown -R www-data:www-data /var/www/demoapp/

sudo chown -R www-data:www-data /var/log/uwsgi/

注意：我们先前安装的 Nginx 版本使用“www-data”这个用户来运行 Nginx，其他 Nginx 版本的可能使用“Nginx”这个替代用户。

由于 Nginx 和 uWSGI 都由同一个用户运行，我们可以在 uWSGI 配置中添加一个安全提升项。打开 uWSGI 配置文件，将 chmod-socket 值由 666 更改为 644：

…

#permissions for the socket file

chmod-socket    = 644

现在我们可以运行 uWSGI 了：

sudo start uwsgi

最后，Nginx 和 uWSGI 被配置成启动后立即对外提供我们的应用服务。

问题解决

如果出现错误的话，第一个检查的地方是日志文件。Nginx 默认将错误信息写到 /var/log/nginx/errors.log 文件。

我们已经配置了 uWSGI emperor 将日志写到/var/log/uwsgi/emperor.log。这个文件夹还包含着每个配置应用的单独日志。我们的例子是 – /var/log/uwsgi/demoapp_uwsgi.log。

静态文件

如果你的应用提供静态文件的话，将下面的规则添加到 demoapp_nginx.conf 文件：

location /static {
    root /var/www/demoapp/;
}

上面配置的结果就是所有在 /var/www/demoapp/static 文件夹中的文件将由提供 Nginx 对外服务(谢谢 Bastianh 指出)

托管多个应用

如果你想在一台服务器上托管多个 Flask 应用，为每个应用创建一个单独的文件夹，像我们前面所做的一样，创建 Nginx 及 uWSGI 配置文件到应用文件夹的符号链接。

使用 Distribute 部署应用

使用 distribute 部署 Flask 应用的话，首先，按照 Flask 文档里的步骤将应用转化成 package，然后复制 distribute 通用安装包到服务器上，使用虚拟环境中的 Python 来安装它。如下：

python setup.py install

最后且同样重要的是，uwsgi 配置里应用属性的值要设置成包含 Flask 应用的包的名称。

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

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

英文原文：Serving Flask With Nginx

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

我职业生涯的大部分都在使用微软的架构，最近我决定走出技术的舒适区，步入开源软件世界。我现在日常工作的项目是一个 RESTful 服务，这个服务需要在主流硬件上运行，且能够按照需要进行水平拓展。为完成这项工作我决定使用 Flask 和 Nginx。Flask 是一个轻量级的 Python Web 框架，Nginx 是一个非常稳定的 Web 服务器，它们在廉价硬件平台上工作良好。

在这篇文章中我将指导你完成使用 Nginx 服务器托管 Flask 应用的安装、配置过程。我所使用的操作系统是 Ubuntu 13.04。

前提条件

在我们开始安装 Nginx 及其他所需软件之前先安装一些前提软件。首先，我们需要 PIP 与 virtualenv：

sudo apt-get install python-setuptools
sudo easy_install pip
sudo pip install virtualenv

使用 apt-get 安装 Nginx 的话，我们需要添加 Nginx 库到 apt-get source 中：

sudo add-apt-repository ppa:nginx/stable

注意：如果“add-apt-repository”命令在你的 Ubuntu 版本中不存在的话，你需要安装“software-properties-common”包，使用命令：sudo apt-get software-properties-common（感谢 get_with_it 在评论中提到）

升级已有的包，确保系统上有 uWSGI 所需的编译器和工具：

sudo apt-get update && sudo apt-get upgrade

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

Nginx

安装并运行 Nginx：

sudo apt-get install nginx
sudo /etc/init.d/nginx start

Nginx 是一个提供静态文件访问的 web 服务，然而，它不能直接执行托管 Python 应用程序，而 uWSGI 解决了这个问题。让我们先安装 uWSGI，稍候再配置 Nginx 和 uWSGI 之间的交互。

sudo pip install uwsgi

里程碑 #1

打开浏览器访问你的服务器，你应该能看到 Nginx 欢迎页：

示例应用

我们将托管的应用是经典的“Hello, world!”。这个应用只有一个页面，已经猜到页面上将有什么内容了吧。将所有应用相关的文件存放在 /var/www/demoapp 文件夹中。下面创建这个文件夹并在其中初始化一个虚拟环境：

sudo mkdir /var/www
sudo mkdir /var/www/demoapp

由于我们使用 root 权限创建了这个文件夹，它目前归 root 用户所有，让我们更改它的所有权给你登录的用户（我的例子中是 ubuntu）

sudo chown -R ubuntu:ubuntu /var/www/demoapp/

创建并激活一个虚拟环境，在其中安装 Flask：

cd /var/www/demoapp
virtualenv venv
. venv/bin/activate
pip install flask

使用下面的代码创建 hello.py 文件：

from flask import Flask
app = Flask(__name__)
 
@app.route(“/”)
def hello():
    return “Hello World!”
 
if __name__ == “__main__”:
    app.run(host=’0.0.0.0′, port=8080)

里程碑 #2

让我们执行我们刚创建的脚本：

python hello.py

现在你可以通过浏览器访问你服务器的 8080 端口，看，应用生效了：

注意：因为 80 端口已被 Nginx 使用，这里我使用 8080 端口。

现在应用是由 Flask 内置的 web 服务托管的，对于开发和调试这确实是个不错的工具，但不推荐在生产环境中使用。让我们配置 Nginx 来挑起这个重担吧。

更多详情见请继续阅读下一页的精彩内容：http://www.linuxidc.com/Linux/2015-09/123597p2.htm

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