Flask学习之旅--Flask项目部署

一、写在前面

　　flask 作为一个轻量级的 web 框架，具有诸多优点，灵活方便，扩展性强，开发文档也很丰富。在开发调试的过程中，我们往往会使用 flask 自带的 web 服务器，但如果要投入到生产环境中，就需要选择使用功能完整的服务器了。说到部署 flask，就不得不提 wsgi 了，那么 wsgi 又是什么呢？ flask 项目又要怎么部署呢？

 

二、基础知识

1.wsgi

　　wsgi（python web server gateway interface）：python web 服务器网关接口，是 python 语言定义的 web 服务器和 web 应用程序之间一种简单通用的接口。wsgi 分为两个部分，一个是“服务器”或“网关”，一个是“应用程序”或“应用框架”，在处理一个请求时，服务器为应用程序提供环境信息及一个回调函数，当应用程序完成处理请求后，通过回调函数将结果回传给服务器。

2.几种部署方式

1）mod_wsgi(apache)

　　apache 是一个模块化的服务器，由于其多平台和安全性，成为世界排名第一的 web 服务器软件，它可以运行在几乎所有广泛使用的计算机平台上。apache 是以进程为基础的结构，进程比线程开销大，因而不适用于多处理器环境。要使用 apache 来部署 flask 的时候，需要先安装 mod_wsgi。

2）独立的 wsgi 容器

　　（1）gunicorn：是一个 unix 上被广泛使用的高性能的 wsgi http 服务器，和大多数的web框架兼容，并具有实现简单，轻量级，高性能等特点。gunicorn 会开启大量进程，等待并处理接收到的请求，每个单独进程能同时处理它们接收到的请求，避免进程启动和销毁的开销。

　　（2）tornado：是一款开源的可伸缩、非阻塞式的 web 服务器和工具集，在高并发的应用场景中有不错的效果。同样，要想通过 tornado 来部署 flask 也是很简便的。

　　（3）gevent：是一个基于协同程序的python库，与tornado的部署方式类似，通过gevent部署flask也是十分的便利。

3）uwsgi

 　　uwsgi 也是部署 flask 的途径之一，类似的部署途径还有 。使用 uwsgi 协议来部署 wsgi 应用的先决条件是 需要一个 uwsgi 服务器。 uwsgi 既是一个协议也是一个服务器，如果作为一个服务器， 它可以服务于 uwsgi 、 fastcgi 和 http 协议。

 

三、windows 下部署 flask 项目

1.安装 python 和 flask

　　python 版本：3.7.0，下载地址：。

　　flask 版本：1.1.1，下载安装：pip install flask==1.1.1。

2.安装 apache

　　apache 版本：2.4，下载地址：https://www.apachelounge.com/download/vs16/binaries/httpd-2.4.41-win64-vs16.zip。下载完成后解压，例如解压到 e:/apache 目录下。

　　在 cmd 中切换到该目录，再进入 bin 目录，然后输入 httpd，打开浏览器，输入 ，若页面上显示 “it works!”，则表明 apache 启动成功。

　　1）若输入 httpd 后报错：syntax error on line 39 of e:/apache24/conf/httpd.conf: serverroot must be a valid directory

　　解决办法：根据显示的目录信息找到 httpd.conf 文件，打开后找到 define srvroot "" 这一行，"" 内的内容改为 apache 路径，保存后重启 apache，则问题解决。

　　2）若输入 httpd 后报错： could not reliably determine the server's fully qualified domain name...

　　解决办法：还是找到 httpd.conf 文件，打开后找到 servername www.example.com:80 这一行，若这行被注释则取消注释，若找不到则添加此内容。

3.安装 mod_wsgi　　

　　mod_wsgi 要下载对应的版本，比如我的电脑是 windows 64位，python 版本是3.7，apache 版本是2.4，最后下载的 mod_wsgi 就是 ，至于具体的版本，可以在查找和下载。下载完成之后将 .whl 文件移动到 python/scripts 下，然后使用 pip 进行安装。

pip install "mod_wsgi-4.5.24+ap24vc14-cp37-cp37m-win_amd64.whl"

　　安装成功之后，在 scripts 目录下运行如下命令：

mod_wsgi-express module-config

　　运行成功之后会输出三行结果，截图如下：

　　

 　　将这三行内容复制下来，打开 apache/conf/httpd.conf ，其中有几十条 loadmodule 命令，然后将复制的内容粘贴到后面，再将下面两条命令的注释取消掉。

loadmodule rewrite_module modules/mod_rewrite.so

loadmodule vhost_alias_module modules/mod_vhost_alias.so 

 　　保存后重启 apache 即可。

4.flask 项目创建

　　假设 flask 项目目录为：e:/code/flask_test，其中有两个文件：app.py 和 test.wsgi。

　　app.py 中的代码为：

 1 from flask import flask
 2 
 3 
 4 app = flask(__name__)
 5 
 6 
 7 @app.route('/hello')
 8 def hello():
 9     return "<h1>hello world</h1>"
10 
11 
12 if __name__ == '__main__':
13     app.run()

　　test.wsgi 中的内容为：

1 import sys
2 
3 sys.path.insert(0, "e:/code/flask_test")
4 
5 from app import app as application

5.apache 配置

　　打开 httpd.conf 文件，找到 listen 80，修改为 listen 8000。然后添加如下配置信息：

<virtualhost *:8000>    
    serveradmin [e-mail]
    wsgiscriptalias / e:/code/flask_test/test.wsgi
    <directory 'e:/code/flask_test/'>
        require all granted
        require host ip    
    </directory>
</virtualhost>

　　保存后重启 apache 服务器。

6.测试

　　打开浏览器，输入，若网页上显示“hello world”，则表明部署成功，除此之外，还可以使用 postman 进行测试，地址为 http://<本机ip>:8000/hello。

 

四、ubuntu 下部署 flask 项目

1.环境配置

　　由于我使用的 ubuntu 自带有 python3.6，因此就不用再安装 python 了，需要做的就是安装 pip、flask 和 uwsgi，使用的命令如下：

sudo apt-get update

sudo apt-get install python3-pip

pip3 install flask uwsgi

　　除了安装 python 和相应的库之外，还需要安装 nginx，使用 sudo apt-get install nginx 安装即可。环境配置的过程不都是一帆风顺的，下面记录几个可能出现的问题及解决方案：

　　1）在安装 pip 时报如下错误：unable to fetch some archives, maybe run apt-get update or try with --fix-missing?

　　解决办法： sudo apt-get install python3-pip --fix-missing

　　2）安装 uwsgi 时出错：plugins/python/uwsgi_python.h:2:10: fatal error: python.h: no such file or directory

　　出错原因时系统缺少 python-dev，解决办法：先安装 python-dev，再安装 uwsgi

sudo apt-get install python-dev

sudo apt-get install python36-dev （若上面的命令执行失败可以尝试用这一条，版本依据你自己实际情况而定）

pip3 install uwsgi

2.创建 flask 项目

 　　假设 flask 项目目录为：/home/tm/desktop/flask_test，其中一个文件：app.py，其中的代码为：

 1 from flask import flask
 2 
 3 
 4 app = flask(__name__)
 5 
 6 
 7 @app.route('/hello')
 8 def hello():
 9     return "<h1>hello world</h1>"
10 
11 
12 if __name__ == '__main__':
13     app.run()

3.使用 uwsgi 部署

　　使用 uwsgi 来部署 flask 项目只需要换一种方式启动服务即可，使用到的命令为：

uwsgi --socket 0.0.0.0:8000 --protocol=http -p 3 -w app:app

　　其中几个参数的含义如下：

　　--socket 0.0.0.0:8000：指定暴露端口号8000；

　　--protocol=http：指定使用的协议为 htpp 协议；

　　-p 3：表示启动的服务占用3个进程；

　　-w app:app：-w 指明要启动的模块，第一个 app 指明 py 文件，第二个 app 指明 flask 实例。

　　启动完成之后，就可以在任意网络连通的机器*问了，下面是在浏览器中访问的示例截图：

　　

 　　至此，我们就已经成功使用 uwsgi 部署 flask 项目了。

4.使用 nginx + uwsgi 部署

　　首先需要编写一个配置文件，那样我们启动服务的时候就不用手动输入参数了，例如编辑 /home/tm/desktop/flask_test/uwsgi.ini：

[uwsgi]
module = app:app
master = true
processes = 3
chdir = /home/tm/desktop/flask_test
socket = 127.0.0.1:8000
chmod-socket = 660
vacuum = true

　　此时，就可以使用如下命令开启 uwsgi 服务了：

uwsgi --ini /home/tm/desktop/flask_test/uwsgi.ini

　　此时，我们已经正常启动了uwsgi服务，但是无法直接访问，需要继续部署nginx服务。下面需要编辑 nginx 的配置文件 /home/tm/desktop/flask_test/nginx.conf：

worker_processes 4;
events { worker_connections 1024; }
http {
　　include mime.types;
　　default_type application/octet-stream;
　　server {
　　　　listen 80;
　　　　location / {
　　　　　　include uwsgi_params;
　　　　　　uwsgi_pass 127.0.0.1:8000;
　　　　}
　　}
}

　　配置结束之后运行如下命令启动 nginx 服务，启动无误后，由于 nginx 监听的是80端口，所以我们就可以通过本机地址访问了。

nginx -c /home/tm/desktop/flask_test/nginx.conf

　　在运行的时候可能会报错，下面是几个可能出现的问题及对应的解决方案：

　　1）报错信息：nginx: [alert] could not open error log file: open() "/var/log/nginx/error.log" failed (13: permission denied)

　　解决方案：报此错误信息是因为权限不够，加上权限执行即可。

　　2）报错信息：open() "/home/sgx/desktop/flask_test/mime.types" failed (2: no such file or directory) 

　　解决方案：报此错误信息是因为项目目录下没有 mime.types 文件，找到 nginx 目录，将目录下的 mime.types 文件复制到项目目录即可。