本文详解 apache 下运行 go 编译生成的 cgi 可执行文件的关键配置要点，包括目录权限、handler 设置误区、文件扩展名选择及安全实践，帮助开发者避免“下载而非执行”的常见问题。
Go 语言编写的 CGI 程序与传统脚本（如 Python 或 Perl）有本质区别：它不是解释型脚本，而是静态编译的二进制可执行文件。因此，在 Apache 中配置时，核心目标不是“指定解释器”，而是确保 Apache 以 CGI 方式调用并执行该二进制文件。这意味着：.go 或 .exe 等扩展名本身无意义（Go 二进制不依赖后缀），关键在于目录权限、CGI 启用方式和执行上下文。
✅ 正确配置步骤
-
使用标准 cgi-bin 目录（推荐）
大多数 Apache 安装已预配置 /usr/lib/cgi-bin 或 /var/www/cgi-bin 为 CGI 执行目录。优先将 Go 可执行文件（如 hello）放入该目录，并确保其具备可执行权限：chmod 755 /var/www/cgi-bin/hello
⚠️ 注意：不要使用 .go 或 .exe 作为扩展名——Go 二进制无须后缀，且 Apache 不会因扩展名自动识别为 CGI；强行添加 .exe 反而可能触发 MIME 类型误判（如 application/x-msdownload），导致浏览器下载而非执行。
-
启用 ExecCGI 并禁用 AddHandler（关键！）
AddHandler cgi-script .xxx 仅对解释型脚本有效（需匹配 #! 解释器行），而 Go 二进制无需解释器。若错误启用，Apache 可能尝试用 /bin/sh 执行二进制，引发 Exec format error。
正确做法是：仅启用 ExecCGI，不设置 AddHandler（尤其避免 .go/.exe）：Options +ExecCGI AllowOverride None Require all granted 若必须在非标准路径（如 /var/www/html/cgi）运行，请确保该目录明确启用 ExecCGI，且移除所有 AddHandler cgi-script ... 行——这是解决“点击即下载”问题的最常见原因。
-
验证文件权限与所有权
Apache 子进程（如 www-data 或 apache 用户）必须对二进制文件及其所在目录具备读取与执行权限：ls -l /var/www/cgi-bin/hello # 应显示: -rwxr-xr-x 1 root www-data ... /var/www/cgi-bin/hello
错误权限（如 644）或错误属主（如仅 root 可执行）将导致 500 错误或静默下载。
? 常见误区与修复
- ❌ AddHandler cgi-script .go → Go 不是脚本，此配置无效且有害
- ❌ 将 Go 二进制放在普通 HTML 目录（如 /var/www/html/）并期望执行 → 默认禁止，易触发下载
- ❌ 使用 777 权限 → 过度开放，存在安全风险；755 足够（所有者可读写执行，组/其他可读执行）
✅ Go CGI 程序示例（确保符合 CGI 协议）
package main
import (
"fmt"
"os"
)
func main() {
// 输出标准 CGI 响应头
fmt.Println("Content-Type: text/html\n")
fmt.Println("Hello from Go CGI!
")
fmt.Printf("QUERY_STRING: %s
", os.Getenv("QUERY_STRING"))
}
编译为 Linux 可执行文件（确保与服务器架构一致）：
GOOS=linux GOARCH=amd64 go build -o hello hello.go
? 安全与可维护性建议
- 坚持使用系统默认 cgi-bin 目录，避免自定义
配置——既降低配置复杂度，也提升跨服务器迁移兼容性； - 禁用 FollowSymLinks 和 Indexes（除非必要），防止路径遍历或目录泄露；
- 生产环境避免 AllowOverride All，应显式声明所需指令（如 AllowOverride None）；
- 如需更高性能与安全性，建议逐步迁移到 FastCGI（如 fcgi 包）或反向代理（Nginx + Go HTTP server），CGI 模式已逐渐被现代部署方案取代。
通过聚焦权限、禁用误导性 Handler、遵循 CGI 目录规范，即可让 Go 二进制在 Apache 中稳定响应 Web 请求，彻底告别“下载 Unix Executable File”的困扰。
