Ubuntu环境下使用uWSGI服务器【以flask应用部署为例】

0、前置内容说明

首先要知道WSGI是什么,关于WSGI服务器 的介绍看这篇:WSGI(Web Server Gateway Interface)服务器

由于从Python 3.11开始限制了在系统级 Python 环境中使用 pip 安装第三方包,以避免与系统包管理器(如 apt)产生冲突。所以开发时选择使用虚拟环境

关于该限制及如何创建虚拟环境看这篇:使用pip3安装软件包报错externally-managed-environment的几种解决方式


1、安装uWSGI

bash 复制代码
pip3 install uwsgi

这里是使用python的包管理器pip安装uWSGI.

如果是想要使用apt全局安装,除了uWSGI还要安装对应的python插件。

如果遇到网络不好,可以在安装的时候使用 国内 PyPI 镜像源:

bash 复制代码
pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple/ uwsgi

2、配置uWSGI

创建配置文件,比如uwsgi.ini,参考示例如下。实际使用要调整自己项目的目录、实例名、监听地址、日志存放路径等。

bash 复制代码
[uwsgi]
# Flask项目的目录
chdir = /root/code/web_proj
# Flask应用的WSGI模块,这里app是Flask应用实例的名称
module = app:app
# 自动更新模板文件
touch-reload = /root/code/web_proj/templates/
# 监听的socket地址
socket = 127.0.0.1:8001

# 开启主进程模式
master = true
# 工作进程数量
processes = 4
# 线程数量
threads = 2

# 当uWSGI停止时清理临时文件
vacuum = true
# 后台运行,指定日志文件(需确保目录存在且有写入权限)
daemonize = /root/code/web_proj/log/myapp.log 

uwsgi.ini配置分以下几个部分:

应用相关配置

  • chdir :指定 Flask 项目的根目录,即 /root/code/web_proj。当 uWSGI 启动时,会将工作目录切换到该目录下,确保能正确找到项目中的文件和模块。
  • module :指定 Flask 应用的 WSGI 模块,格式为 模块名:应用实例名。这里 app:app 表示在 app.py 文件中定义的 Flask 应用实例 app

自动重载配置

  • touch - reload :设置了一个目录 /root/code/web_proj/templates/。当该目录下的文件有修改时,uWSGI 会自动重新加载应用,这样可以及时看到模板文件修改后的效果。

网络监听配置

  • socket :指定 uWSGI 监听的地址和端口,这里是 127.0.0.1:8001,表示监听本地回环地址的 8001 端口,其他进程或应用可以通过这个地址和端口与 uWSGI 进行通信。

进程和线程配置

  • master :设置为 true 表示开启主进程模式。
    主进程负责管理和监控子进程,当子进程出现异常时,主进程可以进行相应的处理,提高应用的稳定性。
  • processes :设置工作进程的数量为 4。
    多个工作进程可以同时处理不同的请求,提高应用的并发处理能力。
  • threads :每个工作进程中的线程数量设置为 2。
    线程可以在进程内部并发执行,进一步提高处理请求的效率。

清理和日志配置

  • vacuum :设置为 true 表示当 uWSGI 停止时,会自动清理临时文件,避免临时文件占用磁盘空间。
  • daemonize :指定 uWSGI 以守护进程的方式在后台运行,并将日志输出到 /root/code/web_proj/log/myapp.log 文件中。使用守护进程模式可以让 uWSGI 在后台持续运行,不影响终端的使用。同时,需要确保指定的日志目录存在且 uWSGI 有写入权限,否则可能会出现日志记录失败的问题。

3、启动uWSGI

启动uWSGI,使用--ini指明配置文件。

bash 复制代码
uwsgi --ini uwsgi.ini

如果一切配置正确,uWSGI 服务器将在后台启动,并监听指定的地址和端口。

如果出问题了,需要知道uWSGI的运行情况,可以查看配置文件中所述的日志文件。

还可以简单地使用ps来查看下进程状态,按照上面的配置,有1个主进程,4个子进程,每个子进程内部有多个线程,如图:

相关推荐
望获linux2 小时前
【实时Linux实战系列】硬实时与软实时设计模式
linux·运维·服务器·数据库·操作系统·rtos·嵌入式软件
沉默的八哥4 小时前
Linux中LVM逻辑卷扩容
linux·运维·服务器
YZJenny4 小时前
没有管理员权限,在服务器安装使用 Jupyter + R 内核
服务器·jupyter
wanhengidc5 小时前
服务器机柜与网络机柜各自的优势
服务器·网络·智能路由器
颖川初尘7 小时前
端口到底是个什么鬼?回答我!
服务器·网络·tcp/ip·node.js
stark张宇7 小时前
Linux 文件创建、删除、移动、复制基础知识整理
linux·服务器·centos
将心ONE7 小时前
使用 lstrip() 和 rstrip() 方法
运维·服务器
Two_brushes.9 小时前
【linux网络】深入理解 TCP/UDP:从基础端口号到可靠传输机制全解析
linux·运维·服务器
全干engineer9 小时前
Flask 入门教程:用 Python 快速搭建你的第一个 Web 应用
后端·python·flask·web
FJW0208149 小时前
【Linux】系统引导修复
linux·运维·服务器