Linux mod_python安装步骤是什么？-杰瑞科技汇

Linux下mod_python安装全指南（2025最新版）：从零配置到故障排查

** 本文是一份详尽的Linux mod_python安装教程，涵盖了从环境准备、源码编译安装、配置Apache，到常见问题排查的全过程，无论你是Python Web开发者系统管理员，还是对Python与Apache集成感兴趣的学习者，这份指南都将帮助你顺利完成mod_python的部署,并在遇到问题时找到解决方案。

（图片来源网络，侵删）

引言：为什么我们还需要mod_python？

在当今FastCGI、uWSGI和WSGI（如mod_wsgi）盛行的时代，你可能会问：mod_python这个“老古董”还有必要安装吗？

答案是：有必要，但场景特定。

mod_python是Apache的一个模块，它允许Python代码直接在Apache进程内运行，实现了Python脚本与Apache服务器的深度集成,它的核心优势在于：

高性能： 由于脚本在Apache进程空间内执行，避免了传统CGI模式下的进程创建和销毁开销,理论上性能更高。
会话保持： 可以在请求之间保持Python对象的状态,实现高效的会话管理。
访问Apache内部API： 可以直接调用Apache的内部函数,实现更底层的控制和定制。

尽管mod_wsgi现在更为流行且被认为是更现代、更灵活的选择，但一些遗留系统、特定项目或研究场景下，mod_python仍然是不可或缺的技术，掌握它的安装和配置方法,依然是资深程序员的一项实用技能。

（图片来源网络，侵删）

安装前准备：检查你的Linux环境

在开始安装之前，请确保你的系统满足以下基本要求，我们以主流的 CentOS 7/8 和 Ubuntu 18.04/20.04 为例进行说明。

系统要求

操作系统： Linux发行版（如CentOS, Ubuntu, Debian等）。
Web服务器： Apache HTTP Server (httpd)。
编程语言： Python (建议2.7或3.x，注意版本兼容性)。
开发工具： C编译器（如GCC）、make等。

安装必要的依赖库

打开终端,根据你的发行版执行以下命令：

对于 CentOS / RHEL / Fedora:

# 更新系统包
sudo yum update -y
# 安装Apache、Python、开发工具和编译器
sudo yum install -y httpd python3-devel gcc make

对于 Ubuntu / Debian:

（图片来源网络，侵删）

# 更新系统包列表
sudo apt-get update
# 安装Apache、Python3、开发工具和编译器
sudo apt-get install -y apache2 python3-dev gcc make

关键点：

httpd 是CentOS下的Apache服务名。
apache2 是Ubuntu下的Apache服务名。
python3-devel (Ubuntu) 或 python3-devel (CentOS，可能需要EPEL源) 提供了编译Python模块所需的头文件和库。

获取并编译安装mod_python

mod_python已经不再像以前那样被大多数Linux发行版默认包含在软件仓库中,最可靠的方式是从源码编译安装。

下载mod_python源码

访问mod_python的官方项目页面，获取最新的稳定版源码下载链接,一个常用的维护版本托管在GitHub上。

# 创建一个临时工作目录
mkdir ~/mod_python_install
cd ~/mod_python_install
# 下载源码 (这里以一个较新的版本为例，请替换为最新版本号)
wget https://github.com/modpython/mod_python/archive/refs/heads/3.5.x.zip
# 如果没有wget，可以使用curl
# curl -L -o mod_python-3.5.x.zip https://github.com/modpython/mod_python/archive/refs/heads/3.5.x.zip
# 解压
unzip mod_python-3.5.x.zip
cd mod_python-3.5.x

配置、编译与安装

这是标准的Linux软件三步曲。

# 1. 配置：检查环境并生成Makefile
# --with-python= 指定你的Python解释器路径，使用 `which python3` 查看
./configure --with-python=/usr/bin/python3
# 2. 编译：将源码编译成可执行文件和库
make
# 3. 安装：将编译好的文件复制到系统目录
# 需要root权限
sudo make install

命令解释：

./configure: 这个脚本会检测你的系统环境，确保所有依赖都已满足，并生成一个Makefile文件。--with-python选项至关重要,它告诉mod_python要和哪个版本的Python绑定。
make: 根据生成的Makefile文件,执行编译操作。
sudo make install: 将编译好的模块文件（通常是.so文件）安装到Apache的模块目录下（如/usr/lib64/httpd/modules/或/usr/lib/apache2/modules/）。

配置Apache以使用mod_python

编译安装成功后,我们需要告诉Apache如何加载并使用这个新模块。

启用mod_python模块

编辑Apache的主配置文件或一个独立的配置文件，为了清晰和便于管理,我们推荐在Apache的配置目录下创建一个新文件。

对于 CentOS / RHEL / Fedora:

# 编辑主配置文件
sudo vi /etc/httpd/conf/httpd.conf
# 或者，在conf.d目录下创建一个新文件，更推荐
sudo vi /etc/httpd/conf.d/mod_python.conf

对于 Ubuntu / Debian:

# 在mods-available目录下创建配置文件
sudo vi /etc/apache2/mods-available/python3.conf

在文件中添加以下内容，以加载mod_python模块：

LoadModule python_module modules/mod_python.so

注意： 在Ubuntu上，你可能需要使用a2enmod python3命令来启用模块,系统会自动帮你处理这个配置。

创建一个测试用的Python处理器

为了验证安装是否成功，我们创建一个简单的Python脚本,并通过Apache来访问它。

在Apache的网站根目录下创建一个Python文件。

默认网站根目录：

CentOS: /var/www/html/
Ubuntu: /var/www/html/

# 创建一个测试脚本
sudo vi /var/www/html/test.py

在test.py文件中输入以下内容：

from mod_python import apache
def handler(req):
    # 设置HTTP响应头
    req.content_type = 'text/plain'
    # 写入响应内容
    req.write("Hello from mod_python!\n")
    req.write("The request URI is: %s\n" % req.uri)
    req.write("The server hostname is: %s\n" % req.hostname)
    # 返回状态码，apache.OK表示成功
    return apache.OK

配置Apache以处理.py文件

我们需要告诉Apache，所有以.py结尾的请求都应该交给我们的test.py脚本的handler函数处理。

回到你之前创建的模块配置文件（如/etc/httpd/conf.d/mod_python.conf或/etc/apache2/mods-available/python3.conf）,添加以下内容：

# 指定处理.py文件的Handler
# 格式: AddHandler handler-name file-extension
AddHandler mod_python .py
# 设置Python的执行配置
# 格式: PythonHandler handler_path|module_name
# 这里我们让所有.py文件都由同一个处理器处理，然后在脚本内部判断
# 更精确的配置如下，直接指向我们的test.py的handler函数
# <Location /test.py>
#     SetHandler mod_python
#     PythonHandler test
# </Location>
# 或者，更通用的配置，让所有.py文件都由一个模块处理
# 我们这里为了简单，直接使用上面的AddHandler，然后在test.py里处理逻辑

配置解析：

AddHandler mod_python .py: 这行指令告诉Apache，所有请求.py文件的请求，都使用mod_python处理器来处理。
<Location /test.py>: 这种方式更精确，它只对/test.py这个特定路径生效。
SetHandler mod_python: 确保该位置的请求被mod_python处理。
PythonHandler test: 指定要调用的Python处理函数，这里的test对应的是test.py文件中的handler函数名，如果处理函数在另一个模块中，则需要写成module.function的形式。

重启Apache服务

保存所有配置文件后,重启Apache以使配置生效。

对于 CentOS / RHEL / Fedora:

sudo systemctl restart httpd

对于 Ubuntu / Debian:

sudo systemctl restart apache2

验证安装与访问测试

打开你的浏览器，访问 http://your_server_ip/test.py。

如果一切顺利,你应该会看到类似下面的文本输出：

Hello from mod_python!
The request URI is: /test.py
The server hostname is: your_server_ip

看到这个输出，恭喜你！mod_python已经成功安装并运行在你的Apache服务器上了。

常见问题与故障排查

如果在安装或配置过程中遇到问题,可以参考以下排查步骤：

问题：`apxs`命令未找到

现象： 执行./configure时报错 apxs: command not found。
原因： apxs是Apache的扩展工具集,用于编译和安装模块。
解决：
- CentOS: sudo yum install httpd-devel
- Ubuntu: sudo apt-get install apache2-dev

问题：`ImportError: No module named mod_python`

现象： Python脚本运行时报错，找不到mod_python模块。
原因： Apache加载的mod_python.so与你运行Python脚本的环境不一致，或者mod_python.so没有被正确安装到Apache的模块目录。
解决：
1. 确认LoadModule python_module modules/mod_python.so指令在配置文件中存在且没有拼写错误。
2. 确认mod_python.so文件存在于Apache的模块目录下（/usr/lib64/httpd/modules/等）。
3. 检查--with-python配置的路径是否正确,确保它指向你想要绑定的Python解释器。

问题：500 Internal Server Error

现象： 访问.py文件时返回500错误。
原因： 这是最常见的问题，通常由Python脚本语法错误、权限问题或配置错误引起。
解决：
1. 检查Apache错误日志： 这是排查问题的首要步骤。
  - CentOS: sudo tail -f /var/log/httpd/error_log
  - Ubuntu: sudo tail -f /var/log/apache2/error.log 日志中会给出具体的错误信息，如SyntaxError或Permission denied。
2. 检查文件权限： 确保test.py文件对Apache用户（apache或www-data）有可读和可执行权限。
```
# CentOS
sudo chown apache:apache /var/www/html/test.py
sudo chmod 755 /var/www/html/test.py
# Ubuntu
sudo chown www-data:www-data /var/www/html/test.py
sudo chmod 755 /var/www/html/test.py
```
3. 检查Python脚本语法： 用python3 -m py_compile test.py检查脚本是否有语法错误。

总结与展望

本文详细介绍了在Linux系统下从零开始编译、安装和配置mod_python的全过程，虽然mod_python已不再是主流，但理解其工作原理和安装过程,对于维护旧系统或进行特定技术探索都非常有价值。

对于新的项目，我们更推荐使用更现代、更灵活的 mod_wsgi。mod_wsgi支持嵌入式和守护进程两种模式，与WSGI规范兼容得更好,是目前Python应用部署在Apache上的首选方案。

希望这份详尽的指南能帮助你成功解决问题，如果你有任何疑问或遇到新的问题,欢迎在评论区留言讨论！

关键词标签： Linux, mod_python, Apache, Python, 安装教程, 编译安装, 服务器配置, Web开发, 故障排查, mod_python.so

Linux mod_python安装步骤是什么？

Linux下mod_python安装全指南（2025最新版）：从零配置到故障排查

引言：为什么我们还需要mod_python？

安装前准备：检查你的Linux环境

系统要求

安装必要的依赖库

获取并编译安装mod_python

下载mod_python源码

配置、编译与安装

配置Apache以使用mod_python

启用mod_python模块

创建一个测试用的Python处理器

配置Apache以处理.py文件

重启Apache服务

验证安装与访问测试

常见问题与故障排查

问题：`apxs`命令未找到

问题：`ImportError: No module named mod_python`

问题：500 Internal Server Error

总结与展望

99ANYc3cd6

如何高效配置Linux下的Vim与Python环境？

Sublime 2如何运行Python代码？

Java字符串如何转换为XML格式？

Python中Unicode字符如何转为int整数？

Java static方法能直接调用非static成员吗？

Java Socket编程实例具体怎么实现？

Java Service Wrapper如何实现服务守护？

java android开发教程视频下载

particleillusion教程从哪里开始学？

ArrayList与List有何区别？

Python 3 UserWarning如何解决？

Adobe Audition录音教程从哪开始学？

Python replace与strip方法有何区别？

urban decay nake3教程

delicious retouch教程是什么？

Solidworks 2025安装教程详细步骤有哪些？

Linux mod_python安装步骤是什么？

Linux下mod_python安装全指南（2025最新版）：从零配置到故障排查

引言：为什么我们还需要mod_python？

安装前准备：检查你的Linux环境

系统要求

安装必要的依赖库

获取并编译安装mod_python

下载mod_python源码

配置、编译与安装

配置Apache以使用mod_python

启用mod_python模块

创建一个测试用的Python处理器

配置Apache以处理.py文件

重启Apache服务

验证安装与访问测试

常见问题与故障排查

问题：apxs命令未找到

问题：ImportError: No module named mod_python

问题：500 Internal Server Error

总结与展望

相关推荐

Java Socket编程实例具体怎么实现？

问题：`apxs`命令未找到

问题：`ImportError: No module named mod_python`