Debian Apache如何支持Python

方案一 使用 mod_wsgi 部署 WSGI 应用（推荐）

想在 Debian 上让 Apache 跑 Python 应用？目前来看，mod_wsgi 是社区公认的首选方案。它专为运行符合 WSGI 标准的应用而设计，无论是 Flask、Django 还是其他框架，都能获得稳定且高性能的托管环境。下面就把部署的关键步骤和容易踩坑的地方，给你捋清楚。

安装组件并启用模块

第一步，自然是把基础环境搭建起来。打开终端，执行下面这条命令，一次性安装 Apache、Python3 以及关键的 WSGI 模块：

sudo apt update && sudo apt install apache2 python3 python3-pip libapache2-mod-wsgi-py3

安装完成后，别忘了启用 wsgi 模块，让 Apache 知道它的存在：

sudo a2enmod wsgi

准备应用与 WSGI 入口

模块就绪了，接下来准备你的应用。假设我们在 /var/www/yourapp 目录下创建一个简单的 Flask 应用 app.py：

from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello, World from Flask via mod_wsgi"

if __name__ == "__main__":
    app.run()

关键来了：mod_wsgi 需要一个特定的入口文件来加载你的应用。在同一个目录下创建 wsgi.py，内容如下：

import sys
sys.path.insert(0, "/var/www/yourapp")
from app import app as application  # 对象名必须为 application

这里有个必须注意的细节：最后暴露给 mod_wsgi 的变量名，一定要是 application，这是它认准的“接头暗号”。

配置虚拟主机

现在，我们需要告诉 Apache 如何服务这个应用。在 /etc/apache2/sites-a vailable/ 目录下新建一个配置文件，比如 yourapp.conf：

    ServerName yourdomain.com
    WSGIDaemonProcess yourapp python-home=/var/www/yourapp/venv python-path=/var/www/yourapp
    WSGIProcessGroup yourapp
    WSGIScriptAlias / /var/www/yourapp/wsgi.py

    
        Require all granted
    

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

配置里的几个参数是核心：WSGIDaemonProcess 定义了进程组，python-home 指向虚拟环境（如果用的话），python-path 添加了应用目录到 Python 路径，而 WSGIScriptAlias 则将网站根目录映射到我们刚写的入口文件。

保存后，启用站点并重启 Apache 服务：

sudo a2ensite yourapp.conf && sudo systemctl restart apache2

说明

实际部署中，还有两个常见情况需要处理：

使用虚拟环境：这是生产环境的标配。只需将上面配置中的 python-home 参数指向你的虚拟环境目录（例如 /var/www/yourapp/venv），同时确保 python-path 包含了应用本身目录即可。

处理旧版 .egg 包：如果你的依赖包含一些老式的 .egg 包，可能会遇到权限错误。这时，需要设置一个可写的 PYTHON_EGG_CACHE 环境变量目录，问题通常就能解决。

方案二 使用 CGI 运行 Python 脚本（简单脚本场景）

如果你的需求只是偶尔运行几个简单的、独立的 Python 脚本，那么启用 CGI（通用网关接口）可能是更轻量、更直接的选择。它的原理是 Apache 为每个请求启动一个独立的 Python 解释器进程来执行脚本。

启用 CGI 模块并准备脚本

首先，启用 Apache 的 CGI 模块：

sudo a2enmod cgi

接着，在 CGI 的默认目录（通常是 /usr/lib/cgi-bin/）下创建一个脚本。例如 hello.py：

#!/usr/bin/env python3
print("Content-Type: text/html")
print()
print("Hello, World from CGI")

注意脚本第一行必须指定解释器，并且别忘了给它加上执行权限：

sudo chmod +x /usr/lib/cgi-bin/hello.py

配置站点

然后，我们需要在站点的配置文件中，告诉 Apache 如何处理 /cgi-bin/ 路径下的 .py 文件。编辑默认站点配置（或其他对应站点的配置）：

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/

    AllowOverride None
    Options +ExecCGI
    AddHandler cgi-script .py
    Require all granted

配置完成后，重启 Apache 使改动生效：

sudo systemctl restart apache2

现在，访问 http://你的服务器地址/cgi-bin/hello.py，就能看到脚本的输出结果了。也可以用命令快速验证：

curl http://localhost/cgi-bin/hello.py

方案三 使用 mod_python（历史方案，不推荐新项目使用）

最后，我们简单回顾一下 mod_python。在 WSGI 规范成为主流之前，它曾是高性能 Python Web 部署的一个重要选项。其原理是将 Python 解释器直接嵌入到 Apache 进程中，避免了 CGI 模式每次请求都启动进程的开销。

安装与启用

在 Debian 上安装和启用它并不复杂：

sudo apt-get install libapache2-mod-python libapache2-mod-python-doc
sudo a2enmod python

测试与示例

安装后，可以添加一个测试句柄来验证模块是否工作（注意：测试完成后务必移除，以免带来安全风险）：

    SetHandler mod_python
    PythonHandler mod_python.testhandler
    
        Require all granted
    

一个简单的自定义处理器可能长这样（保存为 /var/www/py/hello.py）：

from mod_python import apache

def handler(req):
    req.content_type = 'text/html'
    req.send_http_header()
    req.write('Hello World from mod_python')
    return apache.OK

然后在站点配置中，指定某个目录使用这个处理器：

    AddHandler mod_python .py
    PythonHandler hello
    PythonDebug On

说明

虽然 mod_python 在性能上曾有其优势，但它的生态已经停滞。无论是官方还是社区，重心都已全面转向更灵活、框架无关的 WSGI 标准。对于新项目，几乎没有理由再选择它，了解其存在更多是为了维护那些可能遇到的、有历史包袱的老系统。

常见问题与排错要点

部署过程很少一帆风顺，遇到问题别慌。按照下面这个排查路径，大部分问题都能定位。

服务与语法检查

首先，确认 Apache 服务本身在正常运行：

sudo systemctl status apache2

如果服务启动失败，很可能是配置文件有语法错误。在每次修改配置后，养成习惯先做语法检查：

sudo apache2ctl configtest

检查通过后再重启。如果页面访问出错，错误日志是你的第一手资料：

tail -f /var/log/apache2/error.log

权限与路径

这是两大高频“坑点”。

权限问题：CGI 脚本必须拥有可执行权限（chmod +x）。对于 WSGI，要确保 Apache 用户（通常是 www-data）对应用目录和文件有读取权限，配置中的 区块里也必须有 Require all granted。

路径问题：仔细核对配置文件中的每一个路径。检查 python-home（虚拟环境路径）、python-path（应用路径）和 WSGIScriptAlias（入口文件路径）是否都正确无误。同时，反复确认 WSGI 入口文件中的对象名是不是 application。

虚拟环境与依赖

如果使用虚拟环境，务必在虚拟环境内安装所有依赖：

pip install -r requirements.txt

如果日志中间出现了关于 .egg 文件的权限错误，尝试设置一个可写的缓存目录，例如在 WSGI 配置中或虚拟环境的激活脚本中设置：

export PYTHON_EGG_CACHE=/tmp/.python-eggs

防火墙与端口

最后，如果从外部网络无法访问，别忘了检查服务器防火墙。确保 80（HTTP）或 443（HTTPS）端口是开放的。在 UFW 防火墙中，可以这样放行：

sudo ufw allow 'Apache Full'

或者单独放行端口：

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp