本文详解 apache 下运行 go 编译生成的 cgi 可执行文件的关键配置要点，包括目录权限、handler 设置误区、文件扩展名选择及安全实践，帮助开发者避免“下载而非执行”的常见问题。

Go 语言编写的 CGI 程序与传统脚本（如 Python 或 Perl）有本质区别：它不是解释型脚本，而是静态编译的二进制可执行文件。因此，在 Apache 中配置时，核心目标不是“指定解释器”，而是确保 Apache 以 CGI 方式调用并执行该二进制文件。这意味着：.go 或 .exe 等扩展名本身无意义（Go 二进制不依赖后缀），关键在于目录权限、CGI 启用方式和执行上下文。

✅ 正确配置步骤

1. 使用标准 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），导致浏览器下载而非执行。

2. 启用 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 … 行——这是解决“点击即下载”问题的最常见原因。

3. 验证文件权限与所有权
   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