Cara Mengatasi "413 Request Entity Too Large" di NGINX

Kesalahan "413 Request Entity Too Large" di NGINX sering kali terjadi ketika ukuran request yang dikirim oleh klien melebihi batas yang diizinkan. Ini umumnya terjadi saat mengunggah file besar ke server web. Panduan ini akan membantu Anda mengatasi masalah ini dengan langkah-langkah terperinci.

Prasyarat

• Server dengan NGINX terinstal.
• Akses root atau sudo ke server.
• Pengetahuan dasar tentang konfigurasi server NGINX.

Langkah Utama

Ikuti langkah-langkah berikut untuk mengatasi kesalahan "413 Request Entity Too Large".

1. Cek Konfigurasi NGINX

Langkah pertama adalah memeriksa file konfigurasi NGINX untuk batas ukuran unggahan. Buka file konfigurasi utama NGINX Anda, biasanya terletak di /etc/nginx/nginx.conf atau di direktori spesifik site dalam /etc/nginx/sites-available/.

sudo nano /etc/nginx/nginx.conf

2. Tambahkan atau Ubah Parameter client_max_body_size

Di dalam blok server atau http, tambahkan atau ubah parameter client_max_body_size. Ini mengatur batas ukuran unggahan file. Misalnya, untuk menetapkan batas 100MB:

server {
...
client_max_body_size 100M;
...
}

Jika parameter ini tidak ada, Anda bisa menambahkannya. Pastikan untuk menyimpannya setelah melakukan perubahan.

3. Uji Konfigurasi NGINX

Setelah mengubah konfigurasi, pastikan untuk memeriksa kesalahan sintaksis dengan perintah berikut:

sudo nginx -t

Jika tidak ada kesalahan, Anda akan melihat pesan yang menyatakan bahwa konfigurasi berhasil diverifikasi.

4. Restart NGINX

Setelah memverifikasi bahwa tidak ada kesalahan, restart NGINX agar perubahan konfigurasi berlaku:

sudo systemctl restart nginx

Konfigurasi Lanjutan

Jika Anda menggunakan beberapa aplikasi web di belakang NGINX, Anda mungkin ingin menyesuaikan client_max_body_size untuk setiap situs. Anda dapat melakukannya dengan cara yang sama seperti langkah sebelumnya, tetapi membuat perubahan dalam file konfigurasi spesifik untuk setiap situs.

Pastikan untuk merestart NGINX setelah melakukan perubahan pada setiap file konfigurasi untuk menerapkan pengaturan baru.

Best Practices

• Setel client_max_body_size sesuai kebutuhan aplikasi Anda, tidak terlalu kecil dan tidak terlalu besar.
• Selalu buat cadangan file konfigurasi sebelum melakukan perubahan.
• Setelah melakukan perubahan, lakukan uji coba untuk memastikan semuanya berfungsi dengan baik.
• Gunakan sistem log untuk melacak dan menganalisis kesalahan yang mungkin terjadi.

Troubleshooting

Jika Anda masih mengalami masalah setelah mengikuti langkah-langkah di atas, pertimbangkan beberapa langkah berikut:

• Periksa file log NGINX untuk informasi lebih lanjut mengenai kesalahan:

sudo tail -f /var/log/nginx/error.log

• Pastikan tidak ada pengaturan client_max_body_size lain yang bertentangan di file konfigurasi lain.
• Periksa pengaturan firewall atau proxy yang mungkin membatasi ukuran permintaan.

Kesimpulan

Kesalahan "413 Request Entity Too Large" di NGINX dapat diatasi dengan menyesuaikan parameter client_max_body_size dalam file konfigurasi. Dengan mengikuti langkah-langkah di atas, Anda dapat menghindari masalah ini dan memastikan bahwa server Anda dapat menangani unggahan file besar dengan baik. Pastikan untuk memantau dan menguji setelah perubahan untuk memastikan sistem berfungsi sesuai harapan.