讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在Apache架构中利用mod_proxy_uwsgi连接高性能Python后端服务指南

阿婷同学_6074

阿婷同学_6074

发布时间:2026-05-01 10:11:19

|

397人浏览过

|

来源于php中文网

原创

Apache通过mod_proxy_uwsgi代理uWSGI是成熟安全的部署方式,需启用proxy、proxy_http、proxy_uwsgi三模块,uWSGI须监听TCP端口(如127.0.0.1:8080),Apache配置中使用uwsgi://协议反向代理并排除静态路径。

如何在apache架构中利用mod_proxy_uwsgi连接高性能python后端服务指南

Apache 通过 mod_proxy_uwsgi 连接 uWSGI 是一种成熟、安全且轻量的 Python 应用部署方式,特别适合已有 Apache 环境、不便替换为 Nginx 的场景。它绕开了老旧的 mod_wsgi(需编译、耦合强),也避免了手动编译 mod_uwsgi 的麻烦,直接复用 Apache 自带的代理框架,稳定性和兼容性更好。

一、确认并启用核心模块

Apache 必须加载三个基础模块才能支持 uWSGI 协议代理:

  • mod_proxy:代理功能主模块
  • mod_proxy_http:虽不直接用于 uwsgi:// 协议,但部分健康检查或调试路径可能依赖其工具函数,建议启用
  • mod_proxy_uwsgi:专为 uWSGI 协议设计的代理模块(不是可选插件,是必需组件)

在 Debian/Ubuntu 上执行:

sudo a2enmod proxy proxy_http proxy_uwsgi

在 CentOS/RHEL 上检查 /etc/httpd/conf.modules.d/00-proxy.conf,确保以下三行未被注释:

立即学习“Python免费学习笔记(深入)”;

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_uwsgi_module modules/mod_proxy_uwsgi.so

启用后重启 Apache:sudo systemctl restart apache2(或 httpd)。

二、配置 uWSGI 启动服务(监听 TCP 端口)

mod_proxy_uwsgi 只支持 uwsgi 协议的 TCP socket(即 127.0.0.1:port),不支持 Unix socket(如 /tmp/uwsgi.sock)。因此 uWSGI 必须以 TCP 模式运行:

YandexGPT Proxy
YandexGPT Proxy

用于Yandex云基础模型(YandexGPT)的OpenAI兼容翻译代理

下载

示例 uwsgi.ini:

[uwsgi]
chdir = /var/www/myapp
module = myapp.wsgi:application
master = true
processes = 4
socket = 127.0.0.1:8080
chmod-socket = 660
vacuum = true
die-on-term = true
logto = /var/log/uwsgi/myapp.log

关键点:

  • socket = 127.0.0.1:8080 —— 必须是 IP:PORT 格式,推荐绑定本地回环,禁止暴露公网
  • 无需 protocol = uwsgi(默认就是)
  • 不要启用 http = ... 或 http-socket = ...,否则会绕过 Apache,失去代理控制权

三、Apache 虚拟主机中配置 ProxyPass

在站点配置(如 /etc/apache2/sites-available/myapp.conf)中添加反向代理规则:


  ServerName myapp.example.com

  # 将所有请求转发给 uWSGI
  ProxyPass / uwsgi://127.0.0.1:8080/
  ProxyPassReverse / uwsgi://127.0.0.1:8080/

  # 静态文件由 Apache 直接服务,不走 uWSGI
  
    ProxyPass !
  

  
    ProxyPass !
  


  # 可选:透传原始 Host 头(对 Django ALLOWED_HOSTS 等校验有用)
  ProxyPreserveHost On

注意细节:

  • uwsgi:// 协议前缀必须小写,不能写成 UWSGI://
  • ProxyPass 和 ProxyPassReverse 末尾的 / 必须一致,否则路径重写出错
  • ProxyPass ! 表示排除该路径,让 Apache 自己处理静态资源,大幅提升性能

四、增强稳定性与安全性

生产环境建议补充以下配置:

  • 超时控制:在 <virtualhost></virtualhost> 内添加
    ProxyTimeout 30
    ProxyBadHeader Ignore
  • 错误页接管:uWSGI 崩溃时返回 503,可自定义响应
    ErrorDocument 503 /503.html
  • 访问限制:限制仅本机可连 uWSGI(防火墙或 uWSGI 自身)
    # 在 uWSGI 配置中加:
    socket = 127.0.0.1:8080
    socket-bind-addrs = 127.0.0.1
  • 日志追踪:开启 Apache 代理日志便于排障
    ProxyRequests Off
    LogLevel proxy:info

不复杂但容易忽略

相关文章

数码产品性能查询
数码产品性能查询

该软件包括了市面上所有手机CPU,手机跑分情况,电脑CPU,电脑产品信息等等,方便需要大家查阅数码产品最新情况,了解产品特性,能够进行对比选择最具性价比的商品。

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2723

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6870

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

6326

2024.03.19

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1831

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4884

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1789

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

29217

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3487

2023.08.04

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

40

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn