宝塔面板需按Web服务器类型配置SSI：Apache需在Directory区块添加Options +Includes和AddType text/html .shtml；Nginx需在server块中启用shtml并配置ssi on；文件须用.shtml后缀且语法规范。
如果您在宝塔面板中部署的网站需要使用服务器端包含（SSI）指令（如<!--#include file="header.html" -->），但页面未被解析执行，说明Apache或Nginx尚未启用SSI支持。以下是针对宝塔面板配置SSI功能的具体操作步骤：
一、确认Web服务器类型并启用SSI模块
宝塔面板支持Apache和Nginx两种Web服务器，SSI功能实现方式不同：Apache原生支持通过AddType和Includes选项启用；Nginx需借助shtml模块及shtml后缀识别。必须先确认当前站点使用的服务器类型，再执行对应配置。
1、登录宝塔面板，点击左侧菜单【网站】，找到目标站点，点击右侧【设置】。
2、在站点设置页顶部查看【运行环境】栏，确认显示为“Apache”或“Nginx”。
3、若为Apache环境，继续执行第二步；若为Nginx环境，跳至第三步。
二、Apache环境下开启SSI支持
Apache需启用includes模块，并在站点配置中允许解析.shtml文件及执行SSI指令。宝塔不提供图形化开关，需手动修改配置文件并重启服务。
1、在站点设置页，点击【配置文件】选项卡。
2、在配置文件编辑区域，定位到<Directory>区块（通常位于<VirtualHost>内，路径类似"/www/wwwroot/your-domain.com"）。
3、在该<Directory>区块内添加以下两行配置：
Options +Includes
AddType text/html .shtml
4、在<Directory>区块内确保存在如下行（若无则补充）：
AllowOverride All
5、保存配置文件，返回站点设置页，点击【SSL】选项卡，确认未勾选【强制HTTPS】时暂不影响SSI；若已启用，需确保.shtm(l)资源路径可被正常加载。
6、点击【重载配置】按钮，使Apache重新加载配置。
三、Nginx环境下启用SSI功能
Nginx默认不解析SSI指令，需启用shtml模块，并将响应Content-Type设为text/html，同时指定shtml为有效后缀。宝塔需手动注入shtml相关指令到server块中。
1、在站点设置页，点击【配置文件】选项卡。
2、在server { } 区块内，找到location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ { } 等静态资源匹配段落之后的位置。
3、插入以下配置：
shtml on;
add_header Content-Type "text/html";
4、在server区块的root指令下方或同级位置，添加：
location ~ \.shtml$ {
ssi on;
ssi_silent_errors off;
ssi_types text/html;
}
5、保存配置文件，点击【重载配置】按钮，使Nginx生效新配置。
四、设置文件后缀与验证SSI语法
无论Apache或Nginx，SSI指令仅对特定后缀文件生效。必须将含SSI指令的页面保存为.shtm或.shtml后缀，且指令格式须严格符合规范，否则将被当作纯文本输出。
1、将需启用SSI的HTML文件重命名为以.shtml结尾（例如index.html → index.shtml）。
2、在文件中使用标准SSI语法，例如：
<!--#include virtual="/header.shtml" -->
3、确保被包含文件（如header.shtml）存在于网站根目录或指定路径，且具有可读权限（建议644）。
4、在浏览器中直接访问该.shtm(l)文件URL，观察是否渲染出包含内容而非原始注释代码。
五、排查常见失效原因
SSI配置完成后仍不生效，多因权限、路径或语法错误导致。需逐项核验基础条件是否满足。
1、检查被包含文件路径是否为相对于当前文件的完整URI路径（virtual方式）或相对于网站根目录的文件系统路径（file方式，仅Apache支持）。
2、确认网站根目录下对应文件存在且无拼写错误，大小写敏感需严格一致。
3、在Apache环境下，若使用file参数，需确保
4、在Nginx环境下，确认shtml模块已编译进当前Nginx版本（宝塔默认安装版均支持），可通过命令nginx -V 2>&1 | grep -o with-http_ssi_module验证。
5、检查宝塔防火墙或系统防火墙是否拦截了HTTP响应头中的SSI相关字段（极罕见，但需排除）。
