Apache启用`mod_cgi`或`mod_cgid`模块运行CGI脚本配置详解

酷伟酱_9320

酷伟酱_9320

2026-09-18

825人浏览

原创

apache运行cgi脚本需启用mod_cgi或mod_cgid模块,配置addhandler指定后缀,通过scriptalias映射/cgi-bin/并用授权+execcgi,python脚本须有shebang、content-type头及空行。

apache 要运行 cgi 脚本(比如 python 的 .py 文件),核心不是装了 python,而是让 apache 有能力 fork 子进程去执行它。这必须启用 mod_cgimod_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
Apache 2.4.62

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 下跳过该步,但确保文件扩展名未被系统隐藏。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

apache

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

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

397

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

820

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

2352

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

796

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

689

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

354

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

2096

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

3852

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

627

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

Apache Maven 官方用户中心
Apache Maven 官方用户中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习