CentOS 上 Flask + uWSGI + Nginx 部署

导入uWSGI和Nginx相关知识



uWSGI是什么?


       Flask 开发中自带了 web server,通过 Werkzeug,我们可以搭建 WSGI 服务,运行我们的网站,但 Flask 是 Web 框架,并不是 Web 服务器,尽管 Werkzeug 很强大,但只能用于开发,不能用于生产,对于 Web 服务器,我们有更专业的选择,那就是 uWSGI。
       uWSGI 是一个全站式的托管服务,它实现了应用服务器(支持多种编程语言)、代理、进程管理器、监视器。取名为 uWSGI 是因为它最早实现的是 Python 语言的 WSGI。

       uWSGI 是 C 语言写的,性能比较高。uWSGI 包括四个部分:

            1)uwsgi协议  

            2)web server 内置支持协议模块  

            3)application 服务器协议支持模块  

            4)进程控制程序

        uWSGI 是一个web服务器,实现了WSGI协议(Web Server Gateway Interface),uwsgi,http协议等,它可以接收和处理请求,发出响应等。所以不用Nginx,只用uWSGI也是可以的。

Nginx是什么?


        Nginx 是高效的 Web 服务器和反向代理服务器,可以用作负载均衡(当有 n 个用户访问服务器时,可以实现分流,分担服务器的压力),可以进行安全过滤,防DDOS攻击等。与 Apache 相比,Nginx 支持高并发,可以支持百万级的 TCP 连接,十万级别的并发连接,部署简单,内存消耗少,成本低,但 Nginx 的模块没有 Apache 丰富。
        Nginx 支持 uWSGI 的 uwsgi 协议,因此我们可以将 Nginx 与 uWSGI 结合起来,Nginx 通过 uwsgi_pass 将动态内容交给 uWSGI 处理。

既然 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 就是必选项了。因为我们需要一个转发的服务。
        所以说,Nginx 基本也是必选项。所以说虽然uWSGI本身就是一个web服务,这里再次引入Nginx就是为了把Nginx作为一个反向代理,这样,一些图片、js等静态资源就可以用Nginx提供服务,而其他的转发给uWSGI,这也是我们这套部署架构的最终目的。


Flask + uWSGI + Nginx 部署搭建


我的系统环境

        CentOS 7
        Python 2.7.5
        nginx 1.12.2
        uwsgi 2.0.17

1.项目路径


    /var/www/webapp

2.项目结构


    .
    ├── run.py
    ├── uwsgi.ini
    └── venv

3.安装uWSGI


    (venv)[root@root webapp]# pip install uwsgi

4.添加uWSGI配置文件 uwsgi.ini


内容如下:

    [uwsgi]
    socket = 127.0.0.1:8008
    pythonpath = /var/www/webapp
    module = run
    callable = app
    processes = 4
    threads = 2
    stats = 127.0.0.1:9191
    daemonize = ./uwsgi.log
    
    =====================
    各参数说明:
    socket:套接字通讯端口,相当于为外界留出一个uWSGI服务器的接口,负责与Nginx通信,但注意socket是无法直接通过http请求成功访问。
    pythonpath:项目目录。
    module:指定项目启动脚本名字,我们可以在本地用python run.py启动flask项目
    callable:程序内启用的application变量名,一般而言都是app=Flask(__name__)的所以这里是app。
    processes:处理器个数。
    threads:线程数。
    processes和threads指出了启动uwsgi服务器之后,服务器会打开几个并行的进程,每个进程会开几条线程来等待处理请求,显然这个数字应该合理,太小会使得处理性能不好而太大则会给服务器本身带来太大负担。
    stats:获取uwsgi统计信息的服务地址
    daemonize:使uWSGI进程在后台运行,并将日志打到指定的日志文件或者udp服务器.
  
或者:

    [uwsgi]
    socket = 127.0.0.1:8008
    chdir = /var/www/webapp
    wsgi-file = run.py
    callable = app
    processes = 4
    threads = 2
    stats = 127.0.0.1:9191
    daemonize = ./server.log
    touch-reload = /var/www/webapp
    
    =====================
    参数说明:
    socket:套接字通讯端口,相当于为外界留出一个uWSGI服务器的接口,负责与Nginx通信。
    chdir:项目目录。
    wsgi-file:指出真正启动脚本的文件名,我们可以在本地用python run.py启动flask项目
    touch-reload:动态监控文件变化,然后重载服务。在部署上线之后对项目内容进行修改的时候十分有用。

5.启动uWSGI


    # uwsgi uwsgi.ini
    
    或者不用uWSGI配置文件,直接用命令运行
    uwsgi --socket 127.0.0.1:8008 --wsgi-file run.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

访问http://127.0.0.1:8008时,页面打不开,后台日志提示错误:
invalid request block size: 21573 (max 4096)...skip
这是因为配置文件中,socket = :8008,即uWSGI被配置成使用socket方式(为tcp协议)进行通信,浏览器请求uwsgi的方式为http协议,而不是socket方式。所以就导致uwsgi的log文件中打出上面的错误信息。
只要在 uwsgi.ini 配置文件中,把socket = :8008 替换成 http = :8008,只用uWSGI服务器,web应用就可以访问。
但如果用Nginx,就可以配置uWSGI使用socket与Nginx通信。
        即如果有Nginx在uWSGI之前作为代理的话应该配socket,而如果想让请求直接甩给uWSGI的话那么就要配http。
    
    或者不用uWSGI配置文件,直接用命令运行
    uwsgi --http :8008 --wsgi-file run.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

6.安装Nginx


    # yum install nginx

7.配置Nginx服务器


配置文件的路径不尽相同,centos上用yum安装时,一般配置文件在/etc/nginx/nginx.conf

修改nginx.conf配置文件:(只修改下面用#########标示的地方即可)

====================================================

# For more information on configuration, see:
#   * Official English Documentation: http://nginx.org/en/docs/
#   * Official Russian Documentation: http://nginx.org/ru/docs/

user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

# Load dynamic modules. See /usr/share/nginx/README.dynamic.
include /usr/share/nginx/modules/*.conf;

events {
    worker_connections 1024;
}

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 2048;

    include             /etc/nginx/mime.types;
    default_type        application/octet-stream;

    # Load modular configuration files from the /etc/nginx/conf.d directory.
    # See http://nginx.org/en/docs/ngx_core_module.html#include
    # for more information.
    include /etc/nginx/conf.d/*.conf;

    server {
        listen       80 default_server;
        listen       [::]:80 default_server;
##############################
        server_name  服务器公网IP;
##############################
        root         /usr/share/nginx/html;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {
##############################
include        uwsgi_params;
uwsgi_pass     127.0.0.1:8008;
uwsgi_param UWSGI_PYHOME /var/www/webapp/venv;
uwsgi_param UWSGI_CHDIR /var/www/webapp;
uwsgi_param UWSGI_SCRIPT run:app;
##############################
        }

        error_page 404 /404.html;
            location = /40x.html {
        }

        error_page 500 502 503 504 /50x.html;
            location = /50x.html {
        }
    }
}

=========================================================

修改的地方:

    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:8008;
    }

根据uWSGI官方文档解释:
    This means “pass every request to the server bound to port 8008 speaking the uwsgi protocol”.
    这意味着 : Nginx会转发到服务器8008端口的每一个请求,来与uwsgi协议通信

8.另一种Nginx配置方式(推荐)


默认安装的Nginx配置文件/etc/nginx/nginx.conf内有如下配置
 
include /etc/nginx/conf.d/*.conf;

即从外部目录/etc/nginx/conf.d/文件夹下还引入了其他配置文件。
这样,我们不修改默认配置,只在/etc/nginx/conf.d/目录下增加一个***.conf,来在外面增加新配置。

在/etc/nginx/conf.d/增加webapp.conf,内容如下:

        server {
            listen      9000;
            server_name  localhost;
            charset    utf-8;
            
            access_log  /var/www/webapp/access.log;
            error_log  /var/www/webapp/error.log;

            client_max_body_size 100M;

            location / {
                include        uwsgi_params;
                uwsgi_pass     127.0.0.1:8008;
                uwsgi_param UWSGI_PYHOME /var/www/webapp/venv;
                uwsgi_param UWSGI_CHDIR /var/www/webapp;
                uwsgi_param UWSGI_SCRIPT run:app;
            }
        }
        
    ==================================================
    各参数说明:
    listen:监听的端口
    server_name:服务器名或IP
    charset:字符集
    access_log:Nginx服务器接收的请求日志,目录若不存在需要创建,否则Nginx报错
    error_log:Nginx服务器记录的错误日志
    include:导入的uWSGI配置
    uwsgi_pass:需要和uWSGI的配置文件里socket项的地址相同,否则无法让uWSGI接收到请求。
    uwsgi_param UWSGI_PYHOME:python的位置(虚拟环境下)
    uwsgi_param UWSGI_CHDIR:项目根目录
    uwsgi_param UWSGI_SCRIPT:启动项目的主程序(在本地上运行这个主程序可以在flask内置的服务器上访问你的项目)

9.启动Nginx


    # nginx

10. 访问web


    http://服务器公网IP:9000


uWSGI官方文档:https://uwsgi-docs.readthedocs.io/en/latest/
uWSGI快速向导:http://uwsgi-docs.readthedocs.io/en/latest/WSGIquickstart.html
Nginx官方文档:http://nginx.org/en/docs/
Nginx教程:http://openresty.org/download/agentzh-nginx-tutorials-zhcn.html
参考链接 https://blog.csdn.net/Squeen_/article/details/54944582
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页