Technical SEO

Server-Side Includes (SSI)

Cơ chế chèn nội dung động vào trang HTML tại thời điểm xử lý trên máy chủ, thường dùng để tối ưu hóa tái sử dụng mã.

3 lượt xem Cập nhật: 29/05/2026

Server-Side Includes (SSI) là gì?

Server-Side Includes (SSI) là một cơ chế đơn giản để chèn nội dung động vào file HTML tại thời điểm máy chủ xử lý yêu cầu, trước khi gửi trang về trình duyệt người dùng. SSI không phải ngôn ngữ lập trình, cũng không phải framework — mà là một tập hợp các chỉ thị (directives) được máy chủ web (như Apache hoặc Nginx với module hỗ trợ) nhận diện và thực thi khi trả về trang.

Các chỉ thị SSI thường có dạng , ví dụ . Máy chủ đọc file HTML, tìm các chỉ thị này, thay thế chúng bằng nội dung tương ứng (file khác, biến môi trường, kết quả lệnh…), rồi mới gửi toàn bộ HTML đã xử lý xong cho trình duyệt.

Tại sao quan trọng trong SEO?

SSI hỗ trợ SEO gián tiếp nhưng hiệu quả ở ba khía cạnh chính:

Tối ưu cấu trúc mã nguồn: Giúp tái sử dụng các phần chung như header, footer, menu, banner — giảm trùng lặp mã, tăng tính nhất quán giữa các trang.
Giảm kích thước file HTML gửi đi: Thay vì nhúng cứng toàn bộ nội dung chung vào từng file, SSI giữ logic ở mức server — giúp file HTML gốc nhẹ hơn, tải nhanh hơn (đặc biệt khi kết hợp với nén Gzip/Brotli).
Hỗ trợ cập nhật tập trung: Khi cần thay đổi thẻ meta, script theo dõi, hoặc liên kết nội bộ trong header/footer, chỉ cần sửa một file — toàn bộ trang dùng SSI sẽ tự động cập nhật, tránh sai sót do quên chỉnh sửa ở nhiều nơi.

Lưu ý: SSI không tạo nội dung động theo người dùng (như PHP hay JavaScript phía client), nên không ảnh hưởng đến khả năng thu thập của bot Google — toàn bộ nội dung sau xử lý SSI đều hiện đầy đủ trong HTML gửi tới crawler.

Cách hoạt động

Khi người dùng hoặc bot yêu cầu một trang (ví dụ /about.html), máy chủ kiểm tra:

File có phần mở rộng được cấu hình hỗ trợ SSI (thường là .shtml, .html hoặc .htm tùy thiết lập).
Máy chủ bật module SSI (Apache: mod_include; Nginx: cần cấu hình shtml qua ssi on và add_before_body/add_after_body hoặc dùng sub_filter hạn chế).
Nếu file chứa chỉ thị SSI hợp lệ, máy chủ thực thi từng lệnh: đọc file, chạy lệnh hệ thống (nếu được phép), lấy biến môi trường… rồi thay thế chỉ thị bằng kết quả.
HTML hoàn chỉnh được gửi đi — bot Google thấy đúng như trang tĩnh đã được “dàn dựng sẵn”.

SSI không can thiệp vào quá trình render phía trình duyệt, nên không gây vấn đề với Core Web Vitals nếu được dùng hợp lý.

Hướng dẫn thực hiện

Dưới đây là các bước triển khai SSI trên Apache (phổ biến nhất). Với Nginx, khả năng hỗ trợ hạn chế hơn và thường cần cấu hình thủ công hoặc thay thế bằng giải pháp khác (như Edge Side Includes – ESI).

Bật mod_include: Kiểm tra bằng lệnh a2enmod include (Linux Debian/Ubuntu) hoặc thêm LoadModule include_module modules/mod_include.so trong httpd.conf.
Cấu hình xử lý SSI cho phần mở rộng: Trong .htaccess hoặc virtual host:
```
<Files "*.shtml">
    AddType text/html .shtml
    AddHandler server-parsed .shtml
</Files>
```
Hoặc áp dụng cho .html: AddHandler server-parsed .html (cảnh báo: ảnh hưởng hiệu năng nếu áp dụng toàn bộ site).
Tạo file bao gồm (ví dụ header.html) với nội dung chuẩn HTML — không cần thẻ <html> hay <body> riêng.
Chèn vào trang đích bằng chỉ thị:
 (đường dẫn tương đối)
 (đường dẫn tuyệt đối từ root).
Khởi động lại Apache: sudo systemctl restart apache2.

Lỗi thường gặp

Dưới đây là những sự cố phổ biến và cách khắc phục:

Lỗi	Nguyên nhân	Cách khắc phục
Chỉ thị SSI hiển thị nguyên văn trên trang	Máy chủ chưa bật mod_include hoặc file không thuộc loại được xử lý	Kiểm tra `mod_include` đang hoạt động; đảm bảo phần mở rộng file khớp với `AddHandler`
404 khi include file	Đường dẫn sai, file thiếu quyền đọc, hoặc nằm ngoài thư mục được phép truy cập	Dùng `virtual` thay vì `file` để đảm bảo đường dẫn tuyệt đối; kiểm tra quyền `chmod 644` cho file include
500 Internal Server Error	Sử dụng lệnh `#exec` bị tắt (mặc định bị vô hiệu hóa vì rủi ro bảo mật), hoặc cú pháp chỉ thị sai	Tránh dùng `#exec`; kiểm tra cú pháp bằng dấu ngoặc kép đúng, không dùng ký tự đặc biệt trong giá trị tham số

Ví dụ thực tế

Một trang sản phẩm product-a.shtml:

<!DOCTYPE html>
<html>
<head>
  <title>Sản phẩm A | Công ty XYZ</title>
  <!--#include virtual="/includes/meta-tags.html" -->
</head>
<body>
  <!--#include virtual="/includes/header.shtml" -->
  <main>
    <h1>Sản phẩm A</h1>
    <p>Mô tả chi tiết…</p>
  </main>
  <!--#include virtual="/includes/footer.shtml" -->
</body>
</html>

Khi truy cập, máy chủ sẽ thay thế từng chỉ thị bằng nội dung thực tế từ các file tương ứng — kết quả gửi tới bot Google là HTML hoàn chỉnh, có đầy đủ thẻ meta, header, footer — giống như một trang tĩnh được viết tay.

Câu hỏi thường gặp

SSI có làm chậm tốc độ tải trang không?

Có thể làm chậm nhẹ do máy chủ phải đọc thêm file và xử lý chỉ thị — nhưng mức độ ảnh hưởng rất nhỏ nếu file include nhỏ, được lưu trên cùng ổ đĩa và không dùng lệnh #exec. Với trang tĩnh, SSI thường nhanh hơn việc gọi API hoặc render server-side phức tạp.

Googlebot có đọc được nội dung sau khi SSI xử lý?

Có. Googlebot nhận được HTML đã được xử lý hoàn tất từ máy chủ — không biết có dùng SSI hay không. Nội dung trong header.html, footer.shtml đều xuất hiện đầy đủ trong mã nguồn trang, nên được lập chỉ mục bình thường.

Có thể dùng SSI thay cho PHP hoặc JavaScript để tối ưu SEO?

SSI chỉ phù hợp cho nội dung tĩnh hoặc gần như tĩnh (thay đổi theo cấu hình máy chủ, không theo người dùng). Không thể dùng SSI để hiển thị nội dung cá nhân hóa, dữ liệu từ cơ sở dữ liệu, hoặc xử lý form — những trường hợp này cần PHP, Node.js hoặc SSR. Dùng SSI thay PHP khi không cần logic phức tạp — giúp giảm tải server và tăng độ ổn định.