SSI (Server Side Includes) 是伺服器端包含文件的指令,**僅在啟用 SSI 的伺服器(配置 .shtml/.shtm/.stm 或映射)生效**,純靜態 HTML 直接打開無效。
<!-- #include file="relative/path.inc" -->
<!-- #include virtual="/absolute/from/root.inc" -->
| 類型 | 路徑基準 | 能否跨目錄 | 能否跨虛擬目錄/站點 |
|---|---|---|---|
file | 當前文檔所在目錄 | 可引用子目錄,不可引用父目錄 (../) | 否 |
virtual | Web 站點根目錄 (虛擬目錄根) | 可引用任意站內路徑 | 同一站點不同虛擬目錄可互引 |
<!-- 同目錄 -->
<!-- #include file="header.inc" -->
<!-- 虛擬目錄 /scripts/tools/ -->
<!-- #include virtual="/scripts/tools/global.inc" -->
<!-- 站點 A 引用站點 B (同 IIS 站點不同虛擬目錄) -->
<!-- #include virtual="/siteB/common/foot.inc" --> <!-- 正確 -->
<!-- #include file="../siteB/common/foot.inc" --> <!-- 錯誤:file 不允許 ../ -->
.inc 後綴,並配置拒絕直接訪問(防洩露)。/ 或 \ 均可,但建議統一 /。getStaticProps、Astro 組件組合。SSI 仍在舊系統、極簡靜態站、邊緣注入場景有價值,新專案建議遷移至現代方案。