SSI仅支持基于预定义变量的静态条件判断，需启用Includes选项、配置.shtm扩展名及SSILegacyExprParser off，语法限单层#if/#else且无变量赋值或循环。
mod_include（SSI）不能实现真正的“服务端逻辑判断”，它只支持极简的条件表达式，且默认禁用。所谓“判断”，仅限于基于环境变量或请求头的静态比对，不涉及变量赋值、循环或复杂运算。
先确认SSI模块已启用并允许条件指令
Apache 默认关闭 #if 类高级指令，仅开放 #include 和 #echo。要使用条件判断，必须显式启用 Includes（而非仅 IncludesNOEXEC），并在配置中放开表达式解析：
- 启用模块：
a2enmod include（Debian/Ubuntu）或确认LoadModule include_module modules/mod_include.so已加载 - 在虚拟主机或目录配置中添加：
Options +IncludesAddType text/html .shtmlAddOutputFilter INCLUDES .shtml - 关键一步：添加
SSILegacyExprParser off（Apache 2.4.12+ 推荐）并确保未设置Options -Includes覆盖
可用的条件语法与典型写法
SSI 的 #if 指令仅支持单层判断，无 elif 或嵌套。表达式必须用双引号包裹，且只能引用预定义变量（如 HTTP_USER_AGENT、DOCUMENT_URI、DATE_LOCAL 等），不能自定义变量。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 判断路径是否含特定字符串：
<!--#if expr=""$DOCUMENT_URI" = "/blog/"" -->博客专用样式<!--#endif --> - 匹配用户代理（注意转义引号）：
<!--#if expr=""$HTTP_USER_AGENT" = /MSIE|Trident/" --><script src="/js/ie-fix.js"></script><!--#endif --> - 结合日期做简单版本控制：
<!--#config timefmt="%Y-%m" --><!--#if expr=""$DATE_LOCAL" >= "2026-05"" -->新版页脚<!--#else -->旧版页脚<!--#endif -->
常见失败原因与绕过技巧
页面直接显示 <!--#if ... --> 原文，基本是以下三类问题：
-
文件后缀不匹配：用
.html但没配AddOutputFilter INCLUDES .html；推荐统一用.shtml避免误伤 -
路径权限限制：
#if不涉及文件读取，但若配合#include使用，file参数仍受目录限制（不支持../） -
变量不可用：Apache 默认不透传全部 HTTP 头，
HTTP_USER_AGENT可用，但HTTP_X_FORWARDED_FOR等需手动映射为环境变量（通过SetEnvIf）
若条件逻辑稍复杂（比如多分支、状态组合），建议放弃 SSI，改用前端 JS 判断，或升级到 mod_lua（轻量钩子）或真实后端语言。
