Daftar isi
Hosting bot di panel itu mudah, sampai bot-nya tidak mau online dan kamu tidak tahu kenapa. Dari pertanyaan yang paling sering masuk, kesalahan pemula hampir selalu itu-itu saja. Kabar baiknya, kelimanya mudah dihindari.
1. Menulis token langsung di kode
Yang terjadi: token bot ditulis di dalam file index.js. Aman-aman saja sampai kodenya diunggah ke GitHub, dikirim ke teman, atau dilihat orang yang membantumu.
Kenapa berbahaya: siapa pun yang punya token bisa mengendalikan bot-mu.
Cara menghindari: simpan token di file .env, lalu baca dari kode dengan process.env. Langkahnya ada di Cara menyimpan token dengan aman pakai .env.
2. Versi Node.js tidak cocok dengan project
Yang terjadi: bot jalan di komputermu, tapi di panel langsung crash dengan Cannot find module atau Unsupported engine.
Kenapa terjadi: versi Node.js di komputermu berbeda dengan Docker Image di panel. Paket yang butuh Node.js 20 gagal terpasang di server yang memakai 18.
Cara menghindari: cek versi di komputermu dengan node -v, lalu samakan Docker Image di tab Startup. Panduannya ada di Cara mengganti versi Node.js lewat Docker Image dan Mengatasi error "Cannot find module".
3. Mengunggah folder yang salah
Yang terjadi: ada dua versi masalahnya. Pertama, folder node_modules ikut diunggah sehingga proses upload lama dan sering gagal. Kedua, package.json terunggah di dalam folder lain, sehingga panel tidak menemukannya.
Cara menghindari:
- Jangan upload
node_modules. Panel memasangnya sendiri. - Pastikan
package.jsonada langsung di folder utama di tab Files. - Kalau memakai zip, kompres isi project-nya, bukan folder pembungkusnya.
Detail upload ada di Mengunggah file dengan File Manager dan SFTP. Kalau project-mu sudah di Git, lebih mudah lagi: Cara upload project ke GitHub dari nol.
4. Memakai port sendiri
Yang terjadi: bot punya dashboard, webhook, atau API, dan kodenya ditulis app.listen(3000). Di panel, muncul EADDRINUSE, atau websitenya tidak bisa dibuka.
Kenapa terjadi: tiap server punya port sendiri yang sudah ditentukan. Port buatan sendiri tidak akan terhubung ke luar.
Cara menghindari: pakai port yang disediakan server (process.env.SERVER_PORT), dan lihat alamatnya di tab Network. Penjelasan lengkap di Port dan Allocation dan Arti error umum di Console.
5. Tidak memantau RAM dan log
Yang terjadi: bot jalan lancar beberapa hari, lalu tiba-tiba mati sendiri. Kamu baru sadar setelah pengguna mengeluh.
Kenapa terjadi: RAM terpakai pelan-pelan sampai menyentuh batas, lalu server dimatikan. Tanda-tandanya sebenarnya terlihat di grafik dan log sejak awal.
Cara menghindari:
- Biasakan melihat grafik Memory di tab Console. Lihat Membaca grafik CPU, RAM, dan disk.
- Baca log saat ada yang aneh, jangan hanya menekan Restart.
- Atur restart otomatis dengan Schedules kalau RAM naik terus.
- Simpan backup file penting, terutama
.env, data, dan folder sesi bot.
Bonus: memberikan password panel ke orang lain
Ini bukan soal teknis, tapi dampaknya paling besar. Ketika bot bermasalah, jangan kirim login panelmu ke orang yang menawarkan bantuan. Beri akses lewat sub user dengan izin seperlunya. Alasan dan caranya ada di Jangan kasih password panel ke sembarang orang.
Daftar cek sebelum menyalakan bot
- Token disimpan di
.env, bukan di kode. - Versi Node.js di panel sama dengan di komputer.
package.jsonada di folder utama, dannode_modulestidak diunggah.- Port memakai port server (kalau botmu punya web).
- Sudah tahu cara melihat grafik RAM dan membaca log.
- Punya salinan file penting.
Kelima hal itu menyelesaikan sebagian besar masalah pemula. Kalau masih ada yang membingungkan, kunjungi Pusat Bantuan kami.
Apakah artikel ini membantu?
