wsgi(web server gateway interface):wsgi 是一个 python web 应用程序与 web 服务器之间的接口规范,它定义了应用程序和服务器之间的标准接口,使得应用程序可以在不同的 web 服务器上运行。wsgi 规范规定了应用程序必须实现的接口方法和服务器需要支持的方法。wsgi 协议使得不同的 python web 框架(例如 flask、django 等)能够在不同的 web 服务器上运行,这些服务器可以是 apache、nginx 等。uwsgi:uwsgi 是一个 web 服务器,它是一个用 c 语言编写的 web 应用程序容器,支持运行 python、ruby、perl 等多种编程语言。uwsgi 服务器可以作为一个独立的应用服务器,也可以与其他 web 服务器(如 nginx、apache)一起使用,通过 wsgi 协议与 python 应用程序通信。uwsgi:uwsgi 是一个与 uwsgi 服务器相关的协议。uwsgi 协议是一种二进制协议,它定义了 uwsgi 服务器与应用程序之间的通信协议。使用 uwsgi 协议,uwsgi 服务器可以与 python 应用程序通信,而不需要像 cgi 那样启动一个新的进程来处理每个请求。uwsgi 协议允许 uwsgi 服务器与应用程序之间进行双向通信,从而提高了性能。因此,uwsgi 是一个 web 服务器,可以通过 wsgi 协议与 python 应用程序通信,并使用 uwsgi 协议进行通信。wsgi 是 python web 应用程序与 web 服务器之间的接口规范,定义了应用程序和服务器之间的标准接口。而 uwsgi 则是 uwsgi 服务器与应用程序之间的二进制通信协议。
二、安装 uwsgi 模块uwsgi 是一种 web 服务器网关接口(web server gateway interface),它可以用于将 python web 应用程序与 web 服务器(如 nginx 或 apache)集成在一起。
在使用uwsgi模块时,需要安装uwsgi模块,并在python web应用程序中导入uwsgi模块,并使用uwsgi模块提供的函数来配置和管理web应用程序的运行。常见的uwsgi模块函数包括uwsgi.optin()、uwsgi.route()、uwsgi.applications()等。另外,uwsgi模块还提供了一些高级特性,如master/worker模式、进程管理、负载均衡、自动扩展等,使得web应用程序可以更好地适应高并发和大流量的情况。1)配置pip源国内源地址:
pypi 清华大学源:https://pypi.tuna.tsinghua.edu.cn/simplepypi 腾讯源:http://mirrors.cloud.tencent.com/pypi/simplepypi 阿里源:https://mirrors.aliyun.com/pypi/simple/mkdir~/.pip/ cat >~/.pip/pip.conf<
三、示例演示(uwsgi + nginx 配置)
1)安装 nginxyum update -y yum install epel-release yum -y install nginx
2)创建 app.py 文件创建一个名为 app.py 的文件,添加以下代码:
from flask import flask app = flask(__name__) @app.route('/') def hello(): return 'hello, world!' if __name__ == '__main__': app.run()
3)创建 uwsgi 配置文件创建一个 uwsgi 配置文件,例如 uwsgi.ini,其中包含以下信息:
[uwsgi] module = app:app # 相当于命令下面两行 #wsgi-file = app.py # 项目入口文件 #callable = app #flask应用对象 # 支持http+socket两种方式,这里选用socket,也可以选择http-socket,下面会讲解这三种区别 # http = 127.0.0.1:8000 socket = 0.0.0.0:8000 # 也可以使用socket文件,在nginx配置文件中配置也对应,仅限本机通信,一般也很少使用 # socket = /app/myapp.sock # 注意记得提前创建目录 chdir = /opt/myapp pidfile=/opt/myapp/myapp.pid processes = 4 threads = 2 master = true vacuum = true py-autoreload = 1 daemonize = /tmp/uwsgi.log
uwsgi.ini常用配置参数详解:
chdir=/xxx/xxx # 指定项目目录, 这里写上程序根目录(即app.py文件所在目录)对应上述目录结构为srchome=/xxx/xxx # 指定虚拟环境变量wsgi-file=xxx # 指定加载wsgi文件socket=xxx # 指定uwsgi的客户端将要连接的socket的路径(使用unix socket的情况)或者地址(使用网络地址的情况)。#socket协议,用于和nginx通讯,端口可配置成别的端口;如果有nginx在uwsgi之前作为代理的话应该配socket 如:socket=0.0.0.0:5000。当然也可以使用http-socket #而如果客户端请求不经过(不搭建)nginx代理服务器,服务请求直接到uwsgi服务器的话那么就配http。如:http=0.0.0.0:5000;ip和端口与项目启动文件app.py中一致; 127.0.0.1虽然是表示本地ip,但想要在网络上访问必须设置host=0.0.0.0才不受ip限制。callable=app # 这个 app 指的是 flask 项目启动程序中定义的 flask name 的名字,我的启动程序是 app.py , 里面定义的 flask 的名字是 app 。module = mysite.wsgi # 加载一个wsgi模块,这里加载mysite/wsgi.py这个模块`master=true # 指定启动主进程`processes=4 # 设置工作进程的数量threads=2 # 设置每个工作进程的线程数vacuum=true # 当服务器退出时自动删除unix socket文件和pid文件logfile-chmod=644 # 指定日志文件的权限daemonize=%(chdir)/xxx.log # 进程在后台运行,并将日志打印到指定文件pidfile=%(chdir)/xxx.pid # 在失去权限前,将主进程pid写到指定的文件uid=xxx # uwsgi服务器运行时的用户idgid=xxx # uwsgi服务器运行时的用户组idprocname-prefix-spaced=xxx # 指定工作进程名称的前缀chdir=/xxx/xxx # 指定项目目录, 这里写上程序根目录(即app.py文件所在目录)对应上述目录结构为/opt/uwsgi/listen = 120 # 设置socket的监听队列大小(默认:100)4)启动 uwsgi在命令行中启动 uwsgi:
uwsgi --ini uwsgi.ini ###或者 uwsgi uwsgi.ini ### 重启 uwsgi --reload /opt/myapp/myapp.pid ###关闭 uwsgi --stop /opt/myapp/myapp.pid
【温馨提示】其实也可以通过一条命令带上对应的参数即可启动,但是不推荐,测试可以。一般使用配置文件的方式启动服务。
使用http协议启动uwsgi的命令为:
uwsgi --http :8000 --ini uwsgi_conf.ini -d ./uwsgi.log --pidfile=uwsgi.pid
--http 指定用5800端口启动http协议--ini 指定上述的启动配置文件-d 指定uwsgi的log,方便我们调试--pidfile 将启动的进程号写到uwsgi.pid文件中,方便我们在需要停止服务器时kill掉。5)配置 web 服务器将 web 服务器配置为反向代理 uwsgi,例如,在 nginx 中,可以使用以下配置文件:
# vi /etc/nginx/conf.d/myapp.conf server { listen 8080; server_name myapp.com; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8000; } }
其中,uwsgi_params 文件包含以下内容:
uwsgi_paramquery_string $query_string; uwsgi_paramrequest_method $request_method; uwsgi_paramcontent_type $content_type; uwsgi_paramcontent_length $content_length; uwsgi_paramrequest_uri$request_uri; uwsgi_parampath_info$document_uri; uwsgi_paramdocument_root$document_root; uwsgi_paramserver_protocol$server_protocol; uwsgi_paramrequest_scheme $scheme; uwsgi_paramhttps$https if_not_empty; uwsgi_paramremote_addr$remote_addr; uwsgi_paramremote_port$remote_port; uwsgi_paramserver_port$server_port; uwsgi_paramserver_name$server_name;
【特别注意】uwsgi_params 在nginx conf文件夹下自带,uwsgi_pass一定要跟uwsgi_conf.ini中写的地址完全一致。
6)重启 web 服务器重启 web 服务器以使配置生效。
# 重启 systemctl restart nginx # 如果是之前nginx服务已经存在,只是修改了配置,可建议使用reload加载 nginx -t && nginx -s reload # 或者 systemctl reload nginx
访问(浏览器访问,curl访问也行)
7)nginx upstream 负载均衡nginx上游(upstream)是指一组后端服务器,nginx可以与其通信并将客户端请求转发到这些服务器。换句话说,上游服务器是nginx代理请求的后端服务器。
nginx的upstream支持5种 分配方式,其中 轮询(默认)、权重、ip散列这三种为nginx原生支持的分配方式,fair 和 url_hash 为第三方支持的分配方式。
1、轮询(默认)轮询是upstream的默认分配方式,即每个请求按照时间顺序轮流分配到不同的后端服务器,如果某个后端服务器 down 掉后,能自动剔除。
upstream backend { server 192.168.182.110:8000; server 192.168.182.111:8000; }
2、权重(weight)轮询的加强版,既可以指定轮询比率,weight 和访问几率成正比,主要应用于后端服务器异质的场景下。
upstream backend { server 192.168.182.110:8000 weight=1; server 192.168.182.111:8000 weight=2; }
3、ip散列(ip_hash)每个请求按照访问 ip(即nginx的前置服务器或客户端ip)的 hash结果分配,这样每个访客会固定访问一个后端服务器,可以解决 session 一致问题。
upstream backend { ip_hash; server 192.168.182.110:8000 weight=1; server 192.168.182.111:8000 weight=2; }
先在另外一个节点上再起一个uwsgi服务,将上面示例配置修改:
# vi /etc/nginx/conf.d/myapp.conf upstream backend { server 192.168.182.110:8000; server 192.168.182.111:8000; } server { listen 8080; server_name myapp.com; location / { include uwsgi_params; uwsgi_pass backend; } }
192.168.182.110 节点 app.py
from flask import flask app = flask(__name__) @app.route('/') def hello(): return 'hello, world 192.168.182.110!n' if __name__ == '__main__': app.run()
192.168.182.111 节点 app.py
from flask import flask app = flask(__name__) @app.route('/') def hello(): return 'hello, world 192.168.182.111!n' if __name__ == '__main__': app.run()
验证
curl127.0.0.1:8080
从上图可知,请求轮询调度,这才是企业一般想要的效果,负载均衡。
8)http、http-socket 和 socket 区别http和http-socket的区别在于,如果我们想直接将uwsgi用作服务器(例如apache和nginx那样)直接暴露在公网那么就使用http;如果有单独的服务器(例如apache或者nginx),由服务器将请求转发给uwsgi处理,并且使用http协议,那么此时使用http-socket。http: 自己会产生一个http进程(可以认为与nginx同一层)负责路由http请求给worker, http进程和worker之间使用的是uwsgi协议。http-socket: 不会产生http进程, 一般用于在前端webserver不支持uwsgi而仅支持http时使用, 他产生的worker使用的是http协议。因此, http 一般是作为独立部署的选项; http-socket 在前端webserver不支持uwsgi时使用, 如果前端webserver支持uwsgi, 则直接使用socket即可(tcp or unix)。【1】socket 示例(uwsgi.ini):
[uwsgi] module = app:app #socket = 127.0.0.1:8000 socket = 0.0.0.0:8000 chdir = /opt/myapp pidfile=/opt/myapp/myapp.pid processes = 4 threads = 2 master = true vacuum = true py-autoreload = 1 daemonize = /tmp/uwsgi.log
nginx配置
upstream backend { server 192.168.182.110:8000; server 192.168.182.111:8000; } server { listen 8080; server_name myapp.com; location / { include uwsgi_params; uwsgi_pass backend; } }
【2】http 示例(uwsgi.ini):
[uwsgi] module = app:app socket = 0.0.0.0:8000 chdir = /opt/myapp pidfile=/opt/myapp/myapp.pid processes = 4 threads = 2 master = true vacuum = true py-autoreload = 1 daemonize = /tmp/uwsgi.log
nginx配置
upstream backend { server 192.168.182.110:8000; server 192.168.182.111:8000; } server { listen 8080; server_name myapp.com; location / { include uwsgi_params; proxy_pass http://backend; } }
【3】http-socket 示例(uwsgi.ini):
[uwsgi] module = app:app http = 0.0.0.0:8000 chdir = /opt/myapp pidfile=/opt/myapp/myapp.pid processes = 4 threads = 2 master = true vacuum = true py-autoreload = 1 daemonize = /tmp/uwsgi.log
nginx配置
upstream backend { server 192.168.182.110:8000; server 192.168.182.111:8000; } server { listen 8080; server_name myapp.com; location / { include uwsgi_params; proxy_pass http://backend; } }
9)tcp 与 uinx 区别tcp和unix套接字(unix domain socket)是两种不同类型的套接字。
tcp套接字是基于tcp/ip协议的网络套接字,用于在网络上进行进程间通信。tcp套接字需要指定ip地址和端口号,以便其他进程可以连接到该套接字进行通信。tcp套接字是一种跨网络边界的套接字,可以在不同的计算机之间进行通信。tcp套接字常用于客户端/服务器架构中,如web服务器、数据库服务器等。unix套接字是基于unix域套接字(unix domain socket)的本地套接字,用于在同一台计算机上进行进程间通信。unix套接字只需要指定一个文件路径,而不需要使用ip地址和端口号。unix套接字是一种进程间通信(ipc)机制,它提供了高效、可靠和安全的进程间通信方式。unix套接字通常用于本地服务器和本地客户端之间的通信,例如x window系统中的客户端和服务器。因此,tcp套接字用于在网络上进行通信,而unix套接字用于在同一台计算机上进行通信。虽然tcp套接字可以通过网络连接到不同的计算机,但是unix套接字提供了更高效的进程间通信机制,并且更适合于需要在同一台计算机上运行的进程间通信。
【tcp 示例】常用uwsgi.ini:
[uwsgi] module = app:app socket = 127.0.0.1:8000 chdir = /opt/myapp pidfile=/opt/myapp/myapp.pid processes = 4 threads = 2 master = true vacuum = true py-autoreload = 1 daemonize = /tmp/uwsgi.log
【unix 示例】仅限于本机通信,很少使用。uwsgi.ini:
[uwsgi] module = app:app socket = /opt/myapp/myapp.socket chdir = /opt/myapp pidfile=/opt/myapp/myapp.pid processes = 4 threads = 2 master = true vacuum = true py-autoreload = 1 daemonize = /tmp/uwsgi.log
nginx配置
server { listen 8080; server_name myapp.com; location / { include uwsgi_params; proxy_pass unix:///opt/myapp/myapp.sock; } }
python 中 web开发中的 wsgi、uwsgi 和 uwsgi 三者介绍就先到这里了
以上就是python 之 wsgi、uwsgi 和 uwsgi 介绍的详细内容。
