flask可以快速的搭建http服务,但是为了搭建网站还是需要web服务器和相关监控管理操作,一套flask、uwsgi、supervisor、nginx是较好的完整解决方案。
本文对自己学习做一个记录,以一个简单的显示‘Hello Flask!’程序来测试,跑通整个流程,方式是在局域网服务器上部署,在个人电脑上访问。
服务器系统是centos7 安装了pyenv
pyenv 切换到python3.5版本,不懂版本切换的可以参考我这边文章https://my.oschina.net/u/3851199/blog/1941983
新建一个简单程序test_flask.py
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
return 'Hello Flask!'
if __name__ == '__main__':
app.run(host='0.0.0.0',port=8080)
测试局域网访问
在服务器上运行# 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
安装完,直接输入启动命令:
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环境变量的目录,现在不需要这个参数,直接:
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
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
打开全局配置文件(先找到配置文件路径: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=root
autostart=true # supervisor启动的时候是否随着同时启动
autorestart=true # 当程序跑出exit的时候,这个program会自动重启
startsecs=3 # 程序重启时候停留在runing状态的秒数
#日志地址
stdout_logfile=/root/zlw/web_flask/uwsgi_supervisor.log
supervisor 相关操作:
启动: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服务
从上面的讲解中,我们知道,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 不知道高到哪里去了。
-
如果服务器主机上运行了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!