apache运行cgi脚本需启用mod_cgi或mod_cgid模块,配置addhandler指定后缀,通过scriptalias映射/cgi-bin/并用授权+execcgi,python脚本须有shebang、content-type头及空行。
apache 要运行 cgi 脚本(比如 python 的 .py 文件),核心不是装了 python,而是让 apache 有能力 fork 子进程去执行它。这必须启用 mod_cgi 或 mod_cgid,并配对路径授权与执行权限,缺一不可。
确认并启用 CGI 模块
打开 Apache 主配置文件(Windows:`C:/xampp/apache/conf/httpd.conf`;Linux/macOS:`/opt/lampp/etc/httpd.conf` 或 `/etc/apache2/apache2.conf`),搜索以下两行:
-
LoadModule cgi_module modules/mod_cgi.so—— 单进程模型,适用于 prefork MPM -
LoadModule cgid_module modules/mod_cgid.so—— 守护进程模型,推荐用于 worker/event 等多线程 MPM
XAMPP 8.2+ 默认使用 mod_cgid,若只看到其中一行被注释(前面有 #),删掉即可;若两行都不存在,说明需手动添加(注意路径是否真实存在)。Debian/Ubuntu 用户可直接运行 a2enmod cgi 启用。
声明 CGI 脚本后缀类型
仅启用模块还不够,Apache 还得知道哪些文件是“可执行的 CGI”。在配置文件中加入:
AddHandler cgi-script .py .cgi .pl
这行告诉 Apache:遇到这些后缀的文件,按 CGI 方式处理。注意,Go 编译出的二进制文件(如 hello)不依赖此设置——只要目录启用了 +ExecCGI 且文件有 x 权限,就能运行。
配置 ScriptAlias 与 Directory 授权
CGI 脚本不能放在任意目录。必须通过 ScriptAlias 映射 Web 路径,并用匹配的 <directory></directory> 块开放执行权限:
Apache 2.4.62 官方 tar.gz 源码包是 Linux 及类 Unix 系统构建 Web 服务器的核心基础。通过源码编译安装,开发者能够灵活定制模块、优化性能并精准控制安装路径,满足多样化的业务需求。
ScriptAlias /cgi-bin/ "/opt/lampp/cgi-bin/"
紧接着必须写:
<directory>
AllowOverride None
Options +ExecCGI
Require all granted
</directory>
Windows 用户注意路径写法:用正斜杠 / 或双反斜杠 \,例如 "C:/xampp/cgi-bin/"。旧版 Apache(如 XAMPP 7.4)仍用 Order allow,deny + Allow from all 语法,别混用新旧规则。
脚本本身要符合 CGI 规范
哪怕配置全对,脚本写错也会返回 500 错误。Python 脚本必须满足三点:
- 首行指定解释器路径,如
#!/usr/bin/env python3或#!/usr/bin/python(XAMPP Windows 可写#!C:/xampp/python/python.exe,但更推荐用env提高可移植性) - 输出
Content-Type头加一个空行,例如:print("Content-Type: text/html ") - 后续内容才是 HTML 或纯文本,不能漏掉换行或编码声明(建议加
# -*- coding: utf-8 -*-)
保存后,给脚本加执行权限:chmod +x /opt/lampp/cgi-bin/test.py(Linux/macOS);Windows 下跳过该步,但确保文件扩展名未被系统隐藏。










