为Nginx开启SSI模块以支持SHTML及include文件引入

最新推荐文章于 2025-05-22 13:03:16 发布

原创最新推荐文章于 2025-05-22 13:03:16 发布 · 4.9k 阅读

2 ·

CC 4.0 BY-SA版权

HTML 专栏收录该内容

1 篇文章

订阅专栏

本文介绍如何在Nginx中配置SSI(Server Side Include)，包括必要的设置步骤及SSI指令用法，帮助读者理解如何利用SSI特性增强HTML页面功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SSI 是 Server Side Include 的首字母缩略词。包含有嵌入式服务器方包含命令的 HTML 文本。在被传送给浏览器之前，服务器会对 SHTML 文档进行完全地读取、分析以及修改。

在 Nginx 中，开启 SSI 支持非常简单，通过向 nginx.conf 中添加几行设置命令即可实现。

将下面的3行代码添加到 nginx.conf 文件的 http{} 段中，以开启 SSI 模块的支持：

ssi on;
ssi_silent_errors on;
ssi_types text/shtml;

放第一个server段的前面

也可以直接在server段里加上

location ~ .*\.(shtm|shtml)?$ {
ssi on;
ssi_silent_errors on;
ssi_types text/shtml;
}

需要注意：

<!–#include file=”文件名称”–> 
<!–#include virtual=”文件名称”–>

file 文件名是一个相对路径，该路径相对于使用 #include 指令的文档所在的目录。被包含文件可以在同一级目录或其子目录中，但不能在上一级目录中。如表示当前目录下的的nav_head.htm文档，则为 file=”nav_head.htm”。
virtual 文件名是 Web 站点上的虚拟目录的完整路径。如表示相对于服务器文档根目录下hoyi目录下的nav_head.htm文件；则为virtual=”/hoyi/nav_head.htm”