宝塔面板中需手动配置Nginx或Apache以启用SSI支持:Nginx需在站点配置中添加ssi on、ssi_silent_errors on及ssi_types,并使用.shtml后缀;Apache需在Directory段启用Includes选项并添加AddType和AddOutputFilter指令;最后通过test.shtml验证解析是否生效。

如果您在宝塔面板中部署了需依赖服务器端包含(SSI)功能的静态网站,但页面中的<!--#include file="xxx"-->等指令未被解析执行,则说明Nginx或Apache尚未启用SSI支持。以下是针对宝塔面板配置服务器端SSI指令支持的具体操作步骤:
一、Nginx环境下开启SSI支持
Nginx本身不原生支持SSI,需通过启用ngx_http_ssi_module模块并正确配置location块来实现基本SSI解析能力。宝塔面板默认已编译该模块,仅需修改站点配置文件即可生效。
1、登录宝塔面板,进入【网站】列表,找到对应站点,点击右侧【设置】按钮。
2、在弹出窗口中,切换至【配置文件】选项卡。
3、在location ~ .*\.(htm|html)?$或location /区块内,插入以下三行配置(若已存在ssi相关配置,请核对是否启用):
ssi on;
ssi_silent_errors on;
ssi_types text/html shtml htm html;
4、保存配置文件后,点击右上角【重载配置】按钮使Nginx重新加载配置。
5、将需要SSI解析的文件扩展名统一改为.shtml(如index.shtml),并在Nginx配置中确保ssi_types包含该后缀。
二、Apache环境下开启SSI支持
Apache对SSI支持更成熟,通过启用Includes选项并配合.htaccess或主配置可直接启用。宝塔面板中Apache站点默认禁用此功能,需手动开启。
1、进入宝塔面板【网站】→ 对应站点【设置】→ 【配置文件】选项卡。
2、定位到<Directory "/www/wwwroot/your-domain.com">段落(路径需与实际站点根目录一致)。
3、在该段落内查找Options行,确保其包含Includes,例如:
Options FollowSymLinks ExecCGI IncludeNOEXEC Indexes MultiViews
若无Includes,请将其添加至Options值末尾(注意空格分隔)。
4、在同一<Directory>块内,添加以下两行:
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
5、保存配置,点击【重载配置】使Apache生效。
三、验证SSI是否生效
配置完成后,需通过实际文件测试SSI解析是否正常工作,避免因权限、路径或扩展名不匹配导致失败。
1、在网站根目录新建一个测试文件test.shtml,内容如下:
<!--#echo var="DATE_LOCAL" -->
2、使用浏览器访问https://your-domain.com/test.shtml(注意必须用.shtml后缀)。
3、若页面显示当前服务器本地时间,则表明SSI已成功启用;若显示原始注释文本或404/500错误,则需检查配置语法、文件权限(需为644)、路径是否可读及后缀是否匹配ssi_types或AddType定义。
4、如使用<!--#include file="header.html"-->,请确认header.html位于同一目录且Nginx/Apache有读取权限。










