Saat mencoba mengakses layanan private cloud Nextcloud yang di-host di TrueNAS SCALE dari luar jaringan (menggunakan reverse proxy Corvus AWG dan VPN Tailscale), kita mungkin pernah mendapati halaman putih dengan tulisan besar:Internal Server Error.
Masalah ini cukup sering membingungkan karena pesan di browser sangat minim informasi. Berikut adalah dokumentasi lengkap dari proses pelacakan (troubleshooting) hingga menemukan akar masalah dan solusinya secara tuntas.
1. Gejala Masalah
Saat membuka alamat Nextcloud dari luar jaringan, browser menampilkan tampilan galat bawaan Nextcloud:
Plaintext
Internal Server Error
The server was unable to complete your request.
Technical details:
Remote Address: 172.16.2.1
Request ID: ...
Meskipun konfigurasi IP proxy (
172.16.2.1) sudah diperiksa di bagian trusted_proxies pada file config.php, galat tersebut tetap muncul dan server tidak bisa diakses.2. Cara Melacak Akar Masalah via Terminal
Jangan langsung berasumsi bahwa masalah ada di jaringan atau konfigurasi IP. Cara terbaik untuk mengetahui penyebab pasti adalah dengan memeriksa log file langsung dari dalam kontainer Nextcloud.
Langkah 1: Cek ID Kontainer Nextcloud yang Aktif
Buka terminal/shell TrueNAS SCALE, lalu jalankan perintah:
Bash
docker ps
Cari nama kontainer Nextcloud (misalnya
ix-nextcloud-nextcloud-1 dengan ID kontainer seperti d94849042f14).Langkah 2: Masuk ke Dalam Kontainer
Gunakan perintah
docker exec menggunakan ID kontainer tersebut:Bash
docker exec -it d94849042f14 /bin/bash
Langkah 3: Periksa File Log Utama Nextcloud
Setelah berada di dalam kontainer, baca 50 baris terakhir dari file
nextcloud.log:Bash
tail -n 50 /var/www/html/data/nextcloud.log
3. Temuan Akar Masalah
Dari hasil pembacaan log, ditemukan baris fatal error berikut:
Plaintext
{"reqId":"...","level":3,"message":"/appinfo/app.php is not supported anymore, use \\OCP\\AppFramework\\Bootstrap\\IBootstrap on the application class instead.","data":{"app":"documents"}}
{"reqId":"...","level":3,"message":"Class \"OCA\\Documents\\AppInfo\\Application\" not found","CustomMessage":"Class \"OCA\\Documents\\AppInfo\\Application\" not found"}
Analisis:
Penyebab utama dari Internal Server Error ini bukanlah kendala jaringan atau kesalahan IP proxy, melainkan adanya sisa folder aplikasi lama bernama
documents (aplikasi editor dokumen usang/legacy) di dalam folder custom_apps.Aplikasi
documents tersebut tidak lagi didukung di versi Nextcloud terbaru, sehingga menyebabkan PHP Fatal Error saat Nextcloud mencoba memuat route aplikasi ketika menerima permintaan HTTP.4. Langkah Perbaikan Tuntas
Berikut adalah langkah-langkah untuk membersihkan aplikasi bermasalah tersebut:
Langkah 1: Hapus Folder Aplikasi Usang
Masih di dalam terminal kontainer Nextcloud, hapus direktori
custom_apps/documents secara permanen:Bash
rm -rf /var/www/html/custom_apps/documents
Langkah 2: Jalankan Perbaikan Sistem (OCC Repair)
Setelah folder dihapus, jalankan perintah
occ untuk membersihkan cache dan memperbarui pustaka sistem Nextcloud:Bash
php occ maintenance:repair
Tunggu hingga proses selesai. Sistem akan membersihkan frontend cache, memperbarui indeks database, dan menyinkronkan ulang modul-modul yang aktif tanpa error.
Langkah 3: Pastikan Konfigurasi Proxy di config.php Benar
Untuk memastikan IP gateway dari reverse proxy Corvus (
172.16.2.1) diizinkan selamanya, periksa file config.php (di path /mnt/.ix-apps/app_mounts/nextcloud/html/config/config.php) dan pastikan baris trusted_proxies dikonfigurasi seperti ini:PHP
'trusted_proxies' =>
array (
0 => '127.0.0.1',
1 => '172.16.0.0/12',
2 => '172.16.2.1',
3 => '100.64.0.0/10',
4 => '192.168.18.101',
),
Langkah 4: Restart Kontainer / Aplikasi Nextcloud
Kembali ke dasbor TrueNAS SCALE di menu Apps > Installed Applications, lakukan Restart pada aplikasi Nextcloud.
Kesimpulan
Pesan galat Internal Server Error di Nextcloud sangat umum dan bisa disebabkan oleh banyak hal. Mengamati log sistem melalui
docker exec dan tail -n 50 nextcloud.log adalah metode yang paling efektif untuk menemukan penyebab sebenarnya.Dalam kasus ini, menghapus aplikasi usang
documents yang bentrok dengan versi Nextcloud terbaru langsung menyelesaikan masalah secara total, dan halaman login Nextcloud kembali terbuka dengan lancar!
