本文共 2028 字，大约阅读时间需要 6 分钟。

uwsgi 安装与虚拟环境配置指南

在实际开发过程中，特别是涉及到 Python 项目的部署时，uwsgi 是一个非常实用的工具。以下将详细介绍如何在 CentOS 系统中安装 uwsgi，并通过虚拟环境完成项目开发。

1. 安装 uwsgi

1.1 安装 uwsgi

首先，通过 pip 安装 uwsgi：

pip install uwsgi

1.2 解决 command not found 问题

安装完成后，可能会遇到 uwsgi: command not found 的错误。这种情况通常是由于 uwsgi 未被正确添加到系统的可执行路径中。解决方法是创建一个软链接：

ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi

注意：请根据实际情况确认 uwsgi 的安装路径。如果 uwsgi 安装在其他目录中，则需将其路径替换进去。例如：

ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi3

这样，uwsgi3 就被链接到了正确的位置。

2. 配置虚拟环境

在开发过程中，使用虚拟环境可以有效地隔离项目依赖，避免环境冲突。以下是两种常用的虚拟环境配置方式。

2.1 使用 venv 创建虚拟环境

通过以下命令创建一个虚拟环境：

python3 -m venv /home/pkuokuo/venv/recommendation_system

创建完成后，激活虚拟环境：

source /home/pkuokuo/venv/recommendation_system/bin/activate

此时，虚拟环境的前面会显示一个括号 (，表示已进入虚拟环境。在虚拟环境中，可以通过 pip 安装所需的依赖包。

2.2 使用 virtualenv 配置虚拟环境

如果您更习惯于使用 virtualenv 工具，可以通过以下命令创建虚拟环境：

virtualenv /home/pkuokuo/venv/recommendation_system

激活虚拟环境的命令与上述方法一致。

3. uwsgi 启动与配置

3.1 启动 uwsgi

在虚拟环境中，可以通过以下命令启动 uwsgi：

uwsgi uwsgiconf.ini

3.2 uwsgiconf.ini 配置

uwsgiconf.ini 文件是 uwsgi 的配置文件，内容示例如下：

http = :8111
chdir = /opt/recommendation_system
wsgi-file = /opt/recommendation_system/manage.py
callable = app
# 插件配置
plugins = python
master = true
vacuum = true
chmod-socket = 664
processes = 5
daemonize = /var/log/53kf/recommendation_system/recommendation_system.log
pidfile = /opt/recommendation_system/uwsgi.pid
# 虚拟环境路径
virtualenv = /home/pkuokuo/venv/recommendation_system

3.3 测试 uwsgi 配置

启动 uwsgi 后，可以通过浏览器访问 http://localhost:8111 查看 uwsgi 是否正常运行。

4. 常见问题解决

4.1 防火墙配置

如果 uwsgi 启动后访问失败，很可能是防火墙阻止了请求。检查防火墙状态并关闭防火墙：

systemctl status firewalld.service
systemctl stop firewalld.service

4.2 UnicodeEncodeError 错误

如果遇到 UnicodeEncodeError，通常是因为日志打印中文字符。可以通过在日志输出前检查字符编码，确保只打印 ASCII 字符。例如：

import logging
logger = logging.getLogger(__name__)
logger.info('初始化热门产品')

注意：请确保所有打印的日志字符都在 ASCII 范围内，避免使用非 ASCII 字符。

5. 进一步优化

为了提高 uwsgi 的性能，可以根据项目需求进行如下优化：

• 增加 uwsgi 进程数：根据负载增加 processes 参数。
• 启用 Gunicorn：如果 uwsgi 负载较大，可以考虑使用 Gunicorn 作为 uwsgi 的反向代理。
• 优化日志管理：将日志文件定期清理，防止磁盘占满。

通过以上步骤，您可以顺利安装并配置 uwsgi，以及正确使用虚拟环境进行项目开发。

转载地址：http://tazfz.baihongyu.com/