Panduan Lengkap Mengatasi Masalah Panel Pterodactyl & Wings

Solusi Praktis, Cepat, dan Teruji

Panel Pterodactyl dan service Wings merupakan komponen penting dalam manajemen server game dan aplikasi berbasis Docker. Namun, dalam praktiknya sering muncul kendala seperti sertifikat SSL bermasalah, Wings tidak berjalan, atau kesalahan domain dan zona waktu.

Artikel ini menyajikan panduan teknis yang ringkas dan efektif untuk menangani berbagai masalah umum pada Pterodactyl & Wings.

1. Mengecek Status Sertifikat SSL (Certificate Validation)

Langkah awal yang wajib dilakukan saat panel atau Wings bermasalah adalah memastikan sertifikat SSL masih valid.

Perintah ini akan menampilkan seluruh sertifikat aktif beserta masa berlakunya.

2. Memperbarui Sertifikat SSL (Renew Certificate)

Jika sertifikat sudah kedaluwarsa atau hampir habis masa aktifnya, lakukan pembaruan dengan aman menggunakan langkah berikut:

systemctl stop nginx
certbot renew
systemctl start nginx
systemctl restart wings

Langkah ini memastikan:

Proses renewal berjalan tanpa konflik port

Wings kembali menggunakan sertifikat terbaru

3. Mengatur Zona Waktu Server ke Asia/Jakarta

Perbedaan zona waktu dapat menyebabkan error pada log, cron job, dan validasi sertifikat.

Ubah Time Zone:

sudo timedatectl set-timezone Asia/Jakarta

Verifikasi:

timedatectl

Pastikan zona waktu sudah berubah ke Asia/Jakarta.

4. Mengecek dan Memperbaiki Status Wings

Jika Wings tidak berjalan atau sering crash, lakukan pengecekan status:

systemctl status wings

Jika status menunjukkan error atau failed, reset dan restart service:

systemctl reset-failed wings
systemctl restart wings

Cara ini efektif untuk mengatasi Wings yang gagal start akibat error sebelumnya.

5. Install / Reinstall Wings (Jika Diperlukan)

Jika Wings rusak atau tidak terpasang dengan benar, lakukan instalasi ulang menggunakan installer resmi Pterodactyl:

sudo apt update -y && sudo apt upgrade -y
bash <(curl -s https://pterodactyl-installer.se)

Installer ini akan memandu instalasi Wings dengan konfigurasi standar dan aman.

6. Mengganti Domain Wings dengan Sertifikat Baru

Saat mengganti domain Wings, sertifikat lama harus dihapus dan diganti dengan yang baru.

Cek Sertifikat Lama:

sudo certbot certificates

Hapus Sertifikat Lama:

sudo certbot delete --cert-name old.example.com

Install / Update Certbot:

sudo snap install --classic certbot

Buat Sertifikat Baru:

sudo certbot certonly --standalone -d new.example.my.id

Restart Wings:

systemctl reset-failed wings
systemctl restart wings

Pastikan domain baru sudah mengarah ke IP server sebelum menjalankan perintah ini.

Kesimpulan

Sebagian besar masalah pada Pterodactyl Panel dan Wings berkaitan dengan:

Sertifikat SSL

Konfigurasi domain

Zona waktu server

Service Wings yang gagal berjalan

Dengan mengikuti panduan di atas, kamu dapat menyelesaikan masalah dengan cepat, aman, dan minim downtime.

Mengatasi Masalah Panel Pterodactyl dan Wings: Solusi Praktis dan Panduan