Cara paling cepat dan aman untuk memeriksa kesalahan penulisan (syntax error) pada berkas konfigurasi Nginx di server Linux adalah dengan menjalankan perintah pengujian bawaan melalui terminal, yaitu nginx -t. Langkah ini wajib dilakukan setiap kali Anda selesai mengubah berkas konfigurasi seperti nginx.conf atau berkas blok server di dalam direktori sites-available, guna mencegah kegagalan sistem saat layanan dimuat ulang atau direstart.
Perintah Dasar Pengecekan Syntax Nginx
Untuk menjalankan pengujian konfigurasi secara standar, Anda hanya memerlukan hak akses administratif (sudo) dan mengetikkan satu baris perintah di terminal server Anda.
sudo nginx -tPerintah tersebut akan memindai seluruh direktori konfigurasi utama, memverifikasi integritas direktori, dan membaca setiap baris perintah di dalam berkas konfigurasi untuk memastikan tidak ada kesalahan titik koma (;), tanda kurung kurawal yang kurang, atau kesalahan direktif.
Opsi Lanjutan untuk Pengujian Konfigurasi
Selain perintah dasar, Nginx menyediakan beberapa parameter tambahan yang sangat berguna untuk kebutuhan debugging tingkat lanjut maupun pengelolaan server produksi.
| Perintah Terminal | Fungsi Utama | Keterangan Penggunaan |
|---|---|---|
sudo nginx -t |
Menguji syntax dan jalur berkas | Standar pengecekan sebelum reload/restart layanan. |
sudo nginx -T |
Menguji dan menampilkan seluruh isi konfigurasi | Berguna untuk melihat gabungan konfigurasi yang sedang aktif di layar. |
sudo nginx -t -c /path/to/nginx.conf |
Menguji berkas konfigurasi khusus | Digunakan jika Anda ingin mengetes berkas di luar direktori default. |
sudo nginx -s reload |
Memuat ulang konfigurasi tanpa downtime | Hanya jalankan setelah nginx -t menyatakan sukses (syntax ok). |
Langkah-Langkah Menangani Error Konfigurasi
Jika pengujian gagal, Nginx akan mencetak pesan kesalahan secara spesifik yang mencakup nama berkas konfigurasi beserta nomor baris tempat terjadinya kesalahan tersebut.
- Perhatikan Pesan Error: Baca baris keluaran terminal yang menunjukkan lokasi berkas (contoh:
/etc/nginx/nginx.conf) dan nomor baris error. - Buka Berkas Konfigurasi: Gunakan editor teks seperti nano atau vim untuk membuka berkas yang bermasalah pada baris yang ditunjukkan.
- Periksa Tanda Baca: Pastikan setiap baris direktif diakhiri dengan tanda titik koma (
;) dan blok kode diapit dengan benar oleh kurung kurawal ({}). - Ulangi Pengecekan: Jalankan kembali perintah
sudo nginx -thingga terminal menampilkan pesan sukses.
Indikator Keberhasilan Pengecekan
Apabila konfigurasi server Nginx Anda sudah bersih dari kesalahan, terminal akan mengembalikan respons konfirmasi positif seperti contoh di bawah ini:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulSetelah kedua baris pesan tersebut muncul, Anda aman untuk melanjutkan proses penerapan konfigurasi baru dengan perintah sudo systemctl reload nginx atau sudo nginx -s reload.