Mengatasi "Internal Server Error" di Nextcloud TrueNAS SCALE (Remote Address)

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!