💡 ULASAN & REFERENSI • DIPERBARUI: 21 October 2026 • REDAKSI AZWINN

Cara Mengaktifkan SSI di Nginx dengan Cepat dan Aman

Mengaktifkan Server Side Includes (SSI) di Nginx dilakukan dengan menambahkan direktif ssi on; ke dalam blok konfigurasi server atau lokasi, lalu memastikan tipe media yang didukung telah didefinisikan dengan benar melalui direktif ssi_types. SSI memungkinkan penyisipan konten file lain (seperti header, footer, atau tanggal) ke dalam halaman web secara dinamis sebelum dikirimkan ke peramban klien.

Langkah-Langkah Mengaktifkan SSI di Nginx

Untuk mengaktifkan fitur SSI pada peladen web Nginx, lakukan langkah-langkah konfigurasi berikut pada berkas virtual host Anda:

  1. Buka berkas konfigurasi Nginx Anda, biasanya terletak di direktori /etc/nginx/sites-available/default atau di dalam direktori /etc/nginx/conf.d/.
  2. Tambahkan baris ssi on; di dalam blok server { } atau blok location { } yang ingin Anda terapkan.
  3. Tentukan tipe berkas yang akan memproses SSI menggunakan direktif ssi_types (misalnya text/html).
  4. Uji sintaks konfigurasi Nginx untuk memastikan tidak ada kesalahan.
  5. Muat ulang (reload) layanan Nginx agar perubahan diterapkan.

Contoh Blok Konfigurasi Nginx

Berikut adalah contoh blok konfigurasi server Nginx yang sudah diaktifkan fitur SSI-nya:

server {
    listen 80;
    server_name contohdomain.com;
    root /var/www/html;

    index index.html index.htm;

    # Mengaktifkan SSI
    ssi on;
    ssi_types text/html text/xml text/plain;

    location / {
        try_files $uri $uri/ =404;
    }
}

Parameter Utama Konfigurasi SSI Nginx

Tabel berikut merinci direktif utama yang digunakan saat mengatur Server Side Includes di Nginx:

Direktif Nilai Default Fungsi
ssi off Mengaktifkan (on) atau menonaktifkan (off) pemrosesan SSI pada respons.
ssi_types text/html Menentukan tipe MIME apa saja yang akan diproses SSI selain tipe default.
ssi_silent_errors off Menyembunyikan pesan kesalahan SSI di halaman web jika bernilai on.
ssi_value_length 256 Menentukan panjang maksimum parameter dalam perintah SSI.

Pengujian Konfigurasi dan Troubleshooting

Setelah melakukan perubahan konfigurasi, jalankan perintah berikut di terminal untuk memeriksa validitas sintaks:

sudo nginx -t

Jika hasil pengujian menunjukkan pesan sukses (syntax is ok dan test is successful), lanjutkan dengan memuat ulang Nginx:

sudo systemctl reload nginx

Untuk menguji apakah SSI berfungsi, buat berkas HTML dengan tag SSI standar, misalnya:

<!--# include virtual="/footer.html" -->

Jika isi berkas footer.html tampil dengan benar di peramban tanpa menampilkan tag mentahnya, maka konfigurasi SSI pada Nginx telah berhasil diaktifkan.

🔍 Orang Lain Juga Mencari Ini