flask+uwsgi+supervisor+nginx在局域网服务器上部署实践

flask可以快速的搭建http服务，但是为了搭建网站还是需要web服务器和相关监控管理操作，一套flask、uwsgi、supervisor、nginx是较好的完整解决方案。

本文对自己学习做一个记录，以一个简单的显示‘Hello Flask!’程序来测试，跑通整个流程，方式是在局域网服务器上部署，在个人电脑上访问。

服务器系统是centos7
安装了pyenv
pyenv 切换到python3.5版本，不懂版本切换的可以参考我这边文章https://www.jianshu.com/p/492853d0e683

新建一个简单程序test_flask.py

from flask import Flaskapp = Flask(__name__)@app.route('/')
def hello_world():return 'Hello Flask!'if __name__ == '__main__':app.run(host='0.0.0.0',port=8080)

测试局域网访问

flask部署到nginx，在服务器上运行# python test_flask.py，出现如下:

此时，在个人电脑浏览器输入10.12.28.27:8080，（10.12.28.27是我服务器ip），出现如下错误：

ok,此时原因可能是服务器防火墙打开了，需要关闭，在服务器上输入关闭防火墙命令（注意系统不同命令也不同）:

关闭后，在个人电脑浏览器输入10.12.28.27:8080，出现hello,Flask!（注意web进程一定要设置ip:0.0.0.0，公网才能访问到）

搭建uWSGI服务

Flask 是一个 Web 应用框架，框架的作用在于处理 request 和 reponse，使用的是 Python 自带的 simple HTTPServer 创建的，在安全性和效率上都是不行的，而uWSGI 是一个全功能的 HTTP 服务器，他要做的就是把 HTTP 协议转化成语言支持的网络协议。比如把 HTTP 协议转化成 WSGI 协议，让 Python 可以直接使用。 uwsgi 是一种 uWSGI 的内部协议，使用二进制方式和其他应用程序进行通信。
现在，我们结束上面的flask服务，在服务器上安装uWSGI，直接输入如下命令

pip install uwsgi

安装完，直接输入启动命令：

nginx反向代理。uwsgi --http 0.0.0.0:8080 --home env --wsgi-file test_flask.py --callable app --master

出现如下错误

Fatal Python error: Py_Initialize: Unable to get the locale encoding
ImportError: No module named 'encodings'

原因是--home参数，以前uwsgi需要这个参数来指定python环境变量的目录，现在不需要这个参数，直接:

nginx。uwsgi --http 0.0.0.0:8080 --wsgi-file test_flask.py --callable app --master

运行成功：

在个人电脑浏览器输入10.12.28.27:8080，出现Hello,Flask!（注意uwsgi配置ip:0.0.0.0，公网才能访问到）
当然，为了减少输入命令麻烦，可以用配置文件来启动uwsgi， 在当前目录新建 vi uwsgi_config.ini:

[uwsgi]
# uwsgi 启动时所使用的地址与端口
# socket = 0.0.0.0:8080 
# 外网访问端口，如果直接用uWSGI外网，这里由于使用了Nginx，故注释掉
http= 0.0.0.0:8080
# 指向项目地址
chdir = /root/zlw/web_flask/
# python 启动程序文件，应该在上面的目录中
wsgi-file = test_flask.py 
# python 程序内用以启动的 application 变量名
# app 是 manage.py 程序文件内的一个变量，这个变量的类型是 Flask的 application 类
callable = app 
# 处理器数
processes = 4
# 线程数
threads = 2
#状态检测地址
stats = 127.0.0.1:9191

配置文件启动uwsgi（这里uwsgi_config.ini是在当前目录下）:

uwsgi uwsgi_config.ini

flask部署到服务器，ok，此时，你的应用已经获得了高并发的处理能力，但对于静态文件的处理uwsgi比较笨拙，并且这种方式安全性也不高，所以要加上Nginx反向代理服务。

在增加Nginx服务之前，我们还有一个事情要做，考虑一下：我现在有一个进程需要每时每刻不断的跑，但是这个进程又有可能由于各种原因有可能中断。当进程中断的时候我希望能自动重新启动它，此时，我就需要使用到了Supervisor，supervisor管理进程，是通过fork/exec的方式将这些被管理的进程当作supervisor的子进程来启动，所以我们只需要将要管理进程的可执行文件的路径添加到supervisor的配置文件中就好了。此时被管理进程被视为supervisor的子进程，若该子进程异常中断，则父进程可以准确的获取子进程异常中断的信息，通过在配置文件中设置autostart=ture，可以实现对异常中断的子进程的自动重启。

搭建supervisor进程管理

没有supervisor之前启动uwsgi服务是这样：uwsgi uwsgi_config.ini
现在我准备使用Supervisor，故uwsgi启动命令仅供测试的时候用。
安装supervisor:

yum install supervisor

apache和nginx哪个好。打开全局配置文件（先找到配置文件路径：find / -name supervisord.conf）

vi /etc/supervisord.conf

在末尾加入：

[program:Test-flask]
# 启动命令入口
command=uwsgi /root/zlw/web_flask/uwsgi_config.ini# 命令程序所在目录
directory=/root/zlw/web_flask
#运行命令的用户名
user=rootautostart=true   # supervisor启动的时候是否随着同时启动
autorestart=true  # 当程序跑出exit的时候，这个program会自动重启
startsecs=3   # 程序重启时候停留在runing状态的秒数
#日志地址
stdout_logfile=/root/zlw/web_flask/uwsgi_supervisor.log

supervisor 相关操作：

flask gunicorn？启动：supervisord
打开命令行： supervisorctl
命令行中查看命令： help
命令行中查看状态： status

或者
supervisorctl status //查看状态
supervisorctl stop [进程名] //停止
supervisorctl start [进程名]

输入命令supervisord启动，子程序uwsgi服务将随之启动。
这个时候输入： ps -ef | grep uwsgi
能看到运行的uwsgi程序：

在个人电脑浏览器输入10.12.28.27:8080，出现Hello,Flask!（注意uwsgi配置ip:0.0.0.0，公网才能访问到）
supervisor搭建完毕。

搭建Nginx服务

nginx wsgi、从上面的讲解中，我们知道，uWSGI 可以起到 Web 服务器的作用，那么为什么有了 uWSGI 还需要 Nginx 呢？

最普遍的说法是 Nginx 对于处理静态文件更有优势，性能更好。其实如果是小网站，没有静态文件需要处理，只用 uWSGI 也是可以的，但加上 Nginx 这一层，优势可以很具体：

• 对于运维来说比较方便，如果服务器被某个 IP 攻击，在 Nginx 配置文件黑名单中添加这个 IP 即可，如果只用 uWSGI，那么就需要在代码中修改了。另一方面，Nginx 是身经百战的 Web 服务器了，在表现上 uWSGI 显得更专业，比如说 uWSGI 在早期版本里是不支持 https 的，可以说 Nginx 更安全。

• Nginx 的特点是能够做负载均衡和 HTTP 缓存，如果不止一台服务器，Nginx 基本就是必选项了，通过 Nginx，将资源可以分配给不同的服务器节点，只有一台服务器，也能很好地提高性能，因为 Nginx 可以通过 headers 的Expires or E-Tag，gzip 压缩等方式很好地处理静态资源，毕竟是 C 语言写的，调用的是 native 的函数，针对 I/O做了优化，对于动态资源来说，Nginx 还可以实现缓存的功能，配合 CDN 优化（这是 uWSGI 做不到的）。Nginx 支持epoll/kqueue 等高效网络库，能够很好地处理高并发短连接请求，性能比 uWSGI 不知道高到哪里去了。

• linux nginx？如果服务器主机上运行了PHP，Python 等语言写的多个应用，都需要监听80端口，这时候 Nginx 就是必选项了。因为我们需要一个转发的服务。
  安装：

yum install nginx

打开全局配置文件(先找到配置文件路径：find / -name nginx.conf)

vi /etc/nginx/nginx.conf

修改配置：（注意先备份一份）

server {listen       80 default_server;listen       [::]:80 default_server;server_name  10.12.28.27;  # 这里是服务域名，请求的url必须包含该字段Nginx才能响应。#root         /usr/share/nginx/html;# Load configuration files for the default server block.# include /etc/nginx/default.d/*.conf;access_log /root/zlw/web_flask/nginx_access.log;  # 服务器接收的请求日志error_log /root/zlw/web_flask/nginx_error.log;  # 错误日志location / {include  uwsgi_params;uwsgi_pass 0.0.0.0:8080;  # 指向uwsgi 所应用的内部地址,所有请求将转发给uwsgi 处理uwsgi_param UWSGI_CHDIR  /root/zlw/web_flask; # 指向网站根目录uwsgi_param UWSGI_SCRIPT test_flask:app;  # 指定启动程序

nginx一些操作：

验证配置是否正确：nginx -t
启动: nginx
重启: nginx -s reload
停止: nginx -s quit

启动后，在个人电脑浏览器输入10.12.28.27:80,出现很卡的想象，一直出不来结果，等好久提示如下：

分析原因：配置出现问题。
重新设置配置，将默认配置/etc/nginx/nignx.conf还原为原来的配置。并且默配置文件内有如下配置

include /etc/nginx/conf.d/*.conf;

ok，新建一个配置：

vi /etc/nginx/conf.d/my_nginx.conf

输入如下内容：

server {listen      80;server_name  10.12.28.27;  # 服务器ip,charset    utf-8;client_max_body_size 100M;location / {include uwsgi_params;#uwsgi_pass  unix:/root/zlw/web_flask/flask_uwsgi.sock;  # sock方式跑不通，原因未知uwsgi_pass 127.0.0.1:8080;}
}

同时，修改之前的uwsgi_config.ini配置文件（注意自己的文件路径）:

vi /root/zlw/web_flask/uwsgi_config.ini
修改为：

[uwsgi]# uwsgi 启动时所使用的地址与端口socket = 127.0.0.1:8080
#socket = /root/zlw/web_flask/flask_uwsgi.sock  # 通过sock文件的方式行不通，原因未知#permissions for the socket file
#chmod-socket    = 666# 外网访问端口，如果直接用uWSGI外网，这里由于使用了Nginx，故注释掉
#http= 127.0.0.1:8080# 指向项目地址
chdir = /root/zlw/web_flask/# python 启动程序文件
wsgi-file = test_flask.py# python 程序内用以启动的 application 变量名
# app 是 manage.py 程序文件内的一个变量，这个变量的类型是 Flask的 application 类
callable = app# 处理器数
processes = 1# 线程数
threads = 2#状态检测地址
stats = 127.0.0.1:9191

保存好，重启supervisor，重启nginx

在个人电脑浏览器输入10.12.28.27:80，出现Hello,Flask!
输入10.12.28.27:8080将出现无法访问情况。因为uwsgi 服务ip设置为127.0.0.1了，其他电脑无法访问，只能通过nginx的监听端口80进行访问。若uwsgi 服务指定ip:0.0.0.0:8080，则，其他电脑输入10.12.28.27:8080也能重新hello,flask,当然10.12.28.27:80也能（uwsgi配置ip要和nginx配置一致）
---
到此能跑通也算大功告成了，但是不能满足，当我们服务器运行了多个flask时该怎么处理呢，下面我们就继续尝试管理多个进程时的相关配置操作。

---

启动多个Flask进程

我们分别建立两个测试项目:

• /root/web_flask
• /root/zlw

每个项目目录下分别有文件：

• test_flask1.py，uwsgi_config1.ini，logs/
• test_flask2.py，uwsgi_config2.ini，logs/

test_flask1.py 和test_flask2.py是和上面简单测试程序一样的，uwsgi配置启动端口和检测端口分别不一样。

uwsgi配置
uwsgi_config1.ini：

[uwsgi]
# uwsgi 启动时所使用的地址与端口socket = 127.0.0.1:8080 
# 指向项目地址
chdir = /root/web_flask/
# python 启动程序文件
wsgi-file = test_flask1.py
# python 程序内用以启动的 application 变量名
# app 是 manage.py 程序文件内的一个变量，这个变量的类型是 Flask的 application 类
callable = app 
# 处理器数
processes = 1
# 线程数
threads = 2
#状态检测地址
stats = 127.0.0.1:9191

uwsgi_config2.ini：

[uwsgi]
# uwsgi 启动时所使用的地址与端口socket = 127.0.0.1:7070 
# 指向项目地址
chdir = /root/zlw/
# python 启动程序文件
wsgi-file = test_flask2.py
# python 程序内用以启动的 application 变量名
# app 是 manage.py 程序文件内的一个变量，这个变量的类型是 Flask的 application 类
callable = app 
# 处理器数
processes = 1
# 线程数
threads = 2
#状态检测地址
stats = 127.0.0.1:7171

此时测试一下，uwsgi分别启动项目（注意只能单个分别启动，ctrl+c结束）
uwsgi /root/web_flask/uwsgi_config1.ini
uwsgi /root/zlw/uwsgi_config2.ini
分别都能启动成功，进行supervisor配置，通过supervisor来同时启动两个项目。

supervisor配置
我的supervisor默认配置是/etc/supervisor.conf，打开会找到类似这样的配置

[include]
files = supervisord.d/*.ini

因此可以在/etc/supervisord.d/目录下的构建两个进程的配置文件.ini各式。当然也可以直接在默认配置文件中增加进程配置。
以下是我的配置(增加两个进程配置文件，同时记得将默认配置文件原来设置的进程配置删除掉):
/etc/supervisord.d/my_flask1.ini

[program:Test-Flask1]
command=uwsgi /root/web_flask/uwsgi_config1.ini
stdout_logfile=/root/web_flask/logs/supervisor.log
autostart=true
autorestart=true
startsecs=5  # 启动5秒内没异常说明启动成功。
priority=1  # 启动优先级
stopasgroup=true  # 程序被终止是否通知用户组
killasgroup=true  #被kill是否通知用户组

/etc/supervisord.d/my_flask2.ini

[program:Test-Flask2]
command=uwsgi /root/zlw/uwsgi_config2.ini
stdout_logfile=/root/zlw/logs/supervisor.log
autostart=true
autorestart=true
startsecs=5  # 启动5秒内没异常说明启动成功。
priority=1  # 启动优先级
stopasgroup=true  # 程序被终止是否通知用户组
killasgroup=true  #被kill是否通知用户组

启动supervisord，打开supervisorctl能看到启动成功。

此时，已经可以在服务器电脑上分别访问127.0.0.1:8080和127.0.0.1:7070，都将返回Hello Flask。

配置Nginx
分别为每个进程配置一个nginx配置文件,文件目录/etc/nginx/conf.d/
有如下文件：
web_flask1.conf:(监听80端口指向127.0.0.1:8080)

server {listen      80;server_name  10.12.28.27;charset    utf-8;client_max_body_size 100M;access_log /root/web_flask1/logs/nginx_access.log;  # 服务器接收的请求日志error_log /root/web_flask1/logs/nginx_error.log;  # 错误日志location / {include uwsgi_params;#uwsgi_pass  unix:/root/web_flask/flask_uwsgi.sock;uwsgi_pass 127.0.0.1:8080;}
}

web_flask2.conf:（监听70端口指向127.0.0.1:7070）

server {listen      70;server_name  10.12.28.27;charset    utf-8;client_max_body_size 100M;access_log /root/web_flask2/logs/nginx_access.log;  # 服务器接收的请求日志error_log /root/web_flask2/logs/nginx_error.log;  # 错误日志location / {include uwsgi_params;#uwsgi_pass  unix:/root/web_flask/flask_uwsgi.sock;uwsgi_pass 127.0.0.1:7070;}
}

好了，配置结束。重启nginx

在个人电脑浏览器输入10.12.28.27:80，出现Hello,Flask!
在个人电脑浏览器输入10.12.28.27:70，出现Hello,Flask!