在 Ubuntu 上使用 Nginx 部署 Flask 应用

Posted 2021-04-13 Python开发者

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了在 Ubuntu 上使用 Nginx 部署 Flask 应用相关的知识，希望对你有一定的参考价值。

译文：开源中国

英文：Vladik

www.oschina.net/translate/serving-flask-with-nginx-on-ubuntu

我职业生涯的大部分都在使用微软的架构，最近我决定走出技术的舒适区，步入开源软件世界。我现在日常工作的项目是一个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

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端口，看，应用生效了：

在 Ubuntu 上使用 Nginx 部署 Flask 应用

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

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

配置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

在 Ubuntu 上使用 Nginx 部署 Flask 应用

别担心，这个错误是正常的，它代表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