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个子进程,每个子进程内部有多个线程,如图:

相关推荐
Logan Lie12 分钟前
在 Ubuntu 终端中配置网络代理:优化 npm、apt等的下载速度
linux·ubuntu·npm·代理模式
网硕互联的小客服1 小时前
如何安全配置数据库(MySQL/PostgreSQL/MongoDB)
linux·运维·服务器·网络·windows
开挖掘机上班3 小时前
linux自有服务
linux·运维·服务器
小黄人软件3 小时前
OpenSSL 与 C++ 搭建一个支持 TLS 1.3 的服务器
服务器·开发语言·c++
wanhengidc3 小时前
算力服务器和GPU服务器之间的联系
运维·服务器
长流小哥5 小时前
STM32:Modbus通信协议核心解析:关键通信技术
服务器·网络·stm32·单片机·嵌入式硬件·信息与通信·modbus
kaikaile19955 小时前
基于MATLAB实现传统谱减法以及两种改进的谱减法(增益函数谱减法、多带谱减法)的语音增强
java·linux·服务器
傅里叶的耶6 小时前
Docker系列(四):容器操作全栈技术指南 --- 从入门到生产级管控
linux·ubuntu·docker·容器·dockerfile
枷锁—sha7 小时前
【HW系列】—web常规漏洞(CSRF与SSRF)
服务器·前端·网络·笔记·安全·网络安全·csrf
傻啦嘿哟8 小时前
基于Python与Flask的新能源汽车可视化大屏系统技术解析
python·flask·汽车