Apache 核心指令 Options 与 AllowOverride 指南-Apache-PHP中文网

options定义目录可启用的服务器特性（如indexes、followsymlinks），allowoverride控制.htaccess是否生效及允许覆盖的指令类型（如fileinfo、authconfig）；二者职责分离，需协同配置。

apache 核心指令 options 与 allowoverride 指南

Apache 的 Options 和 AllowOverride 是两个常被混用、但职责完全不同的核心目录级指令。它们不控制权限本身，而是分别决定“这个目录能做什么”和“这个目录能不能自己改规则”。配错一个字母，就可能触发 403 或 500 错误，且无明确提示。

Options 指令定义 Apache 在该目录下允许启用哪些服务器特性。它不是二值开关（开/关），而是一组可叠加、可增减的选项组合。

Indexes：仅当目录中没有匹配 DirectoryIndex（如 index.html）的文件时，才显示目录列表；否则该选项根本不会生效
FollowSymLinks：无条件跟随符号链接——只要 Apache 进程有读权限，就能跳到任意路径，存在越权风险
SymLinksIfOwnerMatch：只在链接文件与目标文件 UID 完全一致时才跟随，更安全，但每次访问需额外 stat 检查
ExecCGI：仅表示“允许执行 CGI 脚本”，不等于支持 PHP/Python；真正运行脚本还需 mod_cgi 启用、AddHandler 绑定后缀、文件有 +x 权限、且首行含正确解释器路径
写法支持增减语法，例如 Options +Indexes -ExecCGI 表示启用列表但禁用 CGI 执行

AllowOverride 控制 Apache 是否读取并解析该目录下的 .htaccess 文件，以及允许其中使用哪些类别的指令。它不直接控制功能，而是授权“谁来定规则”。

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

None：完全跳过 .htaccess，哪怕文件存在也无视——性能最优，推荐用于根目录或静态资源目录
FileInfo：允许重写文件相关行为，比如 AddType、ErrorDocument、DirectoryIndex，也是启用 URL 重写的最低要求
AuthConfig：允许身份验证类指令，如 AuthUserFile、Require
Options：允许在 .htaccess 中使用 Options 指令（注意：这和主配置里的 Options 不是同一层，是“授权子配置改行为”的权限）
All：开放全部支持项（不含 MultiViews），等价于 FileInfo AuthConfig Indexes Limit Options

这两个指令常出现在同一个 <directory></directory> 块中，但逻辑上互不替代，错误叠加会导致预期失效。

开了 Options Indexes 却看不到列表？先检查是否已有 index.html，再确认父级目录没设 Options None，最后验证是否配了 Require all granted（Apache 2.4+ 权限优先于索引）
想用 .htaccess 写 rewrite 规则？必须同时满足：AllowOverride FileInfo（或更高）、Options FollowSymLinks（或 SymLinksIfOwnerMatch），否则 mod_rewrite 无法定位目标路径
虚拟主机中典型安全配置：AllowOverride None + 明确列出所需 Options，避免依赖 .htaccess；若必须用 .htaccess，优先选 FileInfo 或 AuthConfig 等最小集，而非 All
SELinux 启用时，即使配置全对，也可能因策略拦截导致 403；可用 ausearch -m avc -ts recent 查看拒绝日志

两者都只能在 <directory></directory>、<location></location>（仅 Options 无效）、<virtualhost></virtualhost> 等上下文中使用，不能出现在全局配置顶层。

在 <location></location> 中设置 Options 会被忽略，Apache 直接跳过处理
AllowOverride 在 <location></location> 中虽可写，但无意义，因为它只作用于文件系统路径（即 <directory></directory> 对应的真实目录）
子目录继承父目录配置，但若子目录显式声明了 Options 或 AllowOverride，则以子目录为准（非合并，而是覆盖）