Apache启用SSI必须在Directory块中配置Options +Includes，且需配合AddType与AddOutputFilter设置.shtm后缀、file/virtual路径语义严格区分、被包含文件权限644并检查error_log。
Apache 中启用 SSI（服务端包含）来动态生成页面头部，核心不是 Directory 自身“配合”SSI，而是必须在 Directory 配置块中明确开启 SSI 解析权限和行为。Directory 本身是作用范围容器，它决定了哪些目录下的文件能被解析为 SSI——漏配或错配，<!--#include --> 就只是注释，不会生效。
Directory 必须启用 Includes 选项
在 <Directory> 块中加入 Options +Includes，这是强制要求。不能只写在全局配置或虚拟主机顶层，必须落到具体目录路径上：
- 例如网站根目录：
<Directory "/var/www/html"> Options +Includes </Directory> - 若只想对子目录生效，比如
/blog/，就单独配：<Directory "/var/www/html/blog"> Options +Includes </Directory> - 如果同时需要禁用脚本执行（更安全），可用
Options +Includes -ExecCGI
路径写法必须匹配 file/virtual 语义
Directory 配置生效后，<!--#include --> 中的路径才真正起作用。关键在于区分两种语法：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
file="header.html"：相对当前主页面的路径，不支持../或以/开头；适用于同级或子目录下的文件 -
virtual="/includes/header.html"：相对于网站根目录（DocumentRoot），必须以/开头；适用于集中存放的公共组件 - 错误示例：
file="/includes/header.html"会直接导致 500 错误；virtual="includes/header.html"（缺开头斜杠）则静默失败
文件后缀与类型处理必须成对设置
Directory 配置只管“允许解析”，但 Apache 还得知道“哪些文件要解析”。这靠 AddType 和 AddOutputFilter 实现，且必须放在同一作用域（如 Directory 块内或全局）：
- 推荐使用
.shtml后缀：AddType text/html .shtml+AddOutputFilter INCLUDES .shtml - 主页面（如
index.shtml）必须用该后缀，否则指令被跳过 - 被包含文件（如
header.html）可保持.html，但权限需为 644，SELinux 下还需确认httpd_read_content
调试重点看 error_log 和路径权限
配置完成后没效果？80% 的问题出在以下两点：
- 查 Apache 错误日志：
tail -f /var/log/httpd/error_log，常见报错如“unable to include”、“Permission denied”、“File does not exist” - 验证被包含文件路径是否真实存在、大小写是否正确、是否在 DocumentRoot 范围内
- 检查文件权限（644）、SELinux 状态（
getsebool httpd_read_content）、以及 mod_include 模块是否已加载（httpd -M | grep include）
