Pemecahan Masalah BYOC
Solusi untuk server BYOC yang tertahan di Pending, aplikasi yang tidak terbuka, HTTPS yang tidak terbit, gagal menarik image, dan lainnya.
Sebagian besar masalah BYOC berujung pada salah satu dari tiga hal: firewall (biasanya milik penyedia cloud, bukan milik OS), DNS yang belum mengarah ke server Anda, atau server yang tidak bisa menjangkau Raklane ke arah luar. Ikuti bagian yang sesuai dengan yang Anda alami.
Dua perintah di server Anda menjawab sebagian besar pertanyaan:
sudo systemctl status raklane-agent # apakah agent berjalan?
sudo journalctl -u raklane-agent -f # apa yang sedang dikerjakan / dikeluhkan?
Untuk detail lebih banyak, atur RAKLANE_LOG_LEVEL=debug dan RAKLANE_LOG_FORMAT=text di /etc/default/raklane-agent lalu restart agent. Lihat Konfigurasi Agent BYOC.
Agent tidak mau menyala setelah pengaturannya diubah
- Periksa salah ketik di file:
sudo cat /etc/default/raklane-agent. Setiap baris harus berformatKEY=VALUE, tanpa spasi di sekitar=. - Apakah Anda memindahkan
RAKLANE_AGENT_STATE_DIR? Tanpa file-filenya, agent mencoba mendaftar ulang dan gagal, karena token sudah terpakai. Kembalikan file-filenya, atau arahkan pengaturannya kembali ke direktori lama. - Pengaturan durasi tidak berpengaruh? Nilai seperti
15satau1hyang tidak bisa dibaca diam-diam kembali ke nilai bawaan. - Apakah Anda menjalankan ulang perintah instalasi? Perintah itu menulis ulang file pengaturan dan menghapus baris kustom Anda. Tambahkan kembali.
Server tertahan di Pending
Server sudah terdaftar tetapi tidak pernah menyelesaikan pendaftaran.
- Apakah perintah instalasi selesai? Jalankan ulang — aman dijalankan lagi — dan perhatikan error-nya.
- Apakah token sudah terpakai, atau sudah diganti? Token hanya berlaku sekali, dan membuat token baru membatalkan yang lama. Gunakan Regenerate token dari menu server lalu jalankan perintah barunya.
- Bisakah server menjangkau Raklane? Dari server, jalankan
curl -Ike URL Raklane yang ada di perintah instalasi. Jika gagal, periksa aturan firewall keluar, resolusi DNS di server, atau proxy perusahaan. - Bisakah server menjangkau port koneksi agent? Pendaftaran bisa berhasil tetapi server tidak pernah menjadi Healthy jika port koneksi agent (
8443secara bawaan) diblokir ke arah luar. Log agent akan menampilkan error koneksi dalam kasus ini.
Server menjadi Offline
Agent kehilangan koneksinya ke Raklane.
- Apakah server menyala? Periksa konsol penyedia Anda, lalu coba
ssh. - Apakah agent berjalan?
sudo systemctl status raklane-agent. Jika berhenti,sudo systemctl restart raklane-agent. - Apakah ada yang berubah di jaringan? Aturan firewall baru, DNS resolver yang berganti, atau gangguan di sisi penyedia bisa memblokir koneksi keluar.
Agent terhubung kembali otomatis begitu memungkinkan. Aplikasi Anda biasanya tetap melayani pengunjung selama server tampil Offline — "unreachable" di dashboard berarti Raklane saat ini tidak bisa memastikan kondisinya, bukan berarti aplikasinya berhenti.
Server Healthy, tetapi URL aplikasi tidak terbuka
Hampir selalu karena port 80/443 diblokir di depan server.
Mulailah dari pemeriksaan Raklane sendiri. Setiap beberapa menit, Raklane mencoba port 80 dan 443 di server Anda dari internet, dan memastikan yang menjawab adalah Caddy di server Anda, bukan sekadar port yang terbuka. Jika pengunjung tidak bisa masuk, peringatan muncul di halaman Clusters dan di halaman aplikasi itu sendiri, berisi apa yang ditemukan dan apa yang perlu dilakukan:
| Yang ditampilkan | Biasanya berarti |
|---|---|
| Kedua port closed | Server tidak punya IP publik sendiri: berada di belakang NAT penyedia. Lihat langkah 6. |
| Kedua port time out | Ada firewall di depan server, atau NAT. Lihat langkah 1 dan 6. |
| Kedua port refused | Server menjawab, tetapi Caddy tidak berjalan di sana. Periksa sudo systemctl status caddy. |
| Server lain yang menjawab | Ada program lain (nginx, Apache, Caddy lain) yang memakai port itu. Lihat langkah 3. |
| Alamat privat | IP server adalah alamat LAN atau lokal yang tidak bisa dijangkau pengunjung dari internet. Atur External host-nya jika penyedia mem-forward IP publik ke server itu. |
Di server itu sendiri, agent juga memeriksa setiap kali menyala apakah IP publik yang dilaporkannya ada di salah satu network interface server. Jika tidak ada, journalctl -u raklane-agent | grep NAT menampilkan pesan bahwa server berada di belakang NAT.
Setelah itu, periksa penyebab yang umum:
- Buka
80dan443di firewall penyedia cloud Anda (AWS Security Group, aturan firewall GCP, cloud firewall DigitalOcean/Hetzner/Vultr), ke0.0.0.0/0. Perintah instalasi hanya membukanya di firewall OS. - Periksa juga firewall OS, jika Anda memakai selain
ufw(iptables,nftables,firewalld). - Pastikan tidak ada yang lain memakai
80/443. Web server lain (nginx, Apache, Caddy terpisah) di server yang sama menghalangi Caddy milik Raklane untuk melayani.sudo ss -ltnp | grep -E ':80 |:443 'menunjukkan apa yang sedang mendengarkan. - Pastikan deploy benar-benar
activedi halaman ringkasan aplikasi, dan Anda memakai URL persis yang tertera di sana. - Beri waktu beberapa detik untuk routing setelah deploy menjadi active.
- Apakah IP publiknya dipakai bersama server lain? Jika penyedia hanya mem-forward beberapa port ke server Anda (ada halaman Port Forwarding, SSH lewat port selain
22), port80/443tidak pernah sampai ke server dan ini tidak bisa diperbaiki dari server. VPS seperti ini tidak didukung — lihat VPS dengan IP bersama tidak didukung, yang juga menjelaskan cara memeriksa server Anda.
HTTPS tidak berfungsi / error sertifikat
- Apakah domain sudah terverifikasi? Untuk domain kustom, halaman Domains harus menampilkan verified lebih dulu. Tidak ada sertifikat yang diminta sebelum itu.
- Apakah DNS mengarah ke server?
dig +short app.example.comharus mengembalikan IP publik server Anda. Jika mengembalikan IP CDN (misalnya Cloudflare dengan proxy aktif), ganti ke DNS-only. - Apakah port
80bisa dijangkau dari internet? Certificate authority melakukan verifikasi lewat port 80, meskipun aplikasi disajikan di 443. - Kirim request HTTPS sungguhan. Sertifikat diterbitkan saat request pertama untuk sebuah hostname; buka URL-nya di browser dan tunggu beberapa detik.
- Apakah IP server privat? Server dengan IP privat/LAN hanya disajikan lewat HTTP biasa — ini memang begitu, karena tidak ada certificate authority yang bisa menjangkaunya.
- Terkena batas permintaan certificate authority? Berulang kali menghapus dan membuat ulang server, atau mengganti banyak hostname dalam waktu singkat, bisa sementara menyentuh batas certificate authority. Tunggu lalu coba lagi nanti.
Domain kustom tetap Pending
- Record
Aharus mengarah ke IP server Anda, bukan ke Raklane. Halaman Domains menunjukkan ke mana hostname mengarah saat ini. - Perubahan DNS butuh waktu untuk menyebar. Raklane terus memeriksa otomatis dan tidak pernah menyerah — jika record-nya benar, domain akan terverifikasi.
- CDN yang mem-proxy di depan domain akan mengarahkan ke IP CDN, sehingga verifikasi gagal. Gunakan mode DNS-only.
Deploy gagal menarik image
server gave HTTP response to HTTPS client— image registry berjalan lewat HTTP biasa (penyiapan development). Jalankan ulang perintah instalasi dengan tambahan--insecure-registry=HOST:PORT(tanyakan nilainya ke support Raklane di hi@raklane.com), lalu deploy ulang.- Error autentikasi atau "not found" — server mungkin tidak bisa melakukan autentikasi ke registry. Hubungi support Raklane di hi@raklane.com.
no space left on device— kosongkan disk di server (sudo docker system prunemenghapus image yang tidak terpakai dan container yang berhenti), lalu deploy ulang.- Timeout — pastikan server bisa menjangkau registry lewat HTTPS ke arah luar.
Deploy yang sudah gagal tidak mencoba ulang sendiri setelah Anda memperbaiki penyebabnya — klik Redeploy.
Deploy ditolak karena kapasitas
Request CPU/memori aplikasi tidak muat di sisa kapasitas server. Turunkan request aplikasi (halaman Resources), pindahkan atau hapus aplikasi lain di server itu, atau gunakan server yang lebih besar. Ingat bahwa request tetap dihitung meskipun aplikasi sedang menganggur — itulah yang mencadangkan ruangnya.
Deploy ke server saya dijeda
Biaya pengelolaan BYOC Anda belum dibayar melewati masa tenggang. Semua yang sudah berjalan aman. Isi saldo dompet dari Billing — setelah tunggakan tertagih, deploy kembali berfungsi. Lihat Tagihan BYOC.
Aplikasi tidak bisa terhubung ke database-nya
- Apakah keduanya di server yang sama? Database local hanya bisa dijangkau oleh aplikasi di server BYOC yang sama. Jika berbeda server, pindahkan aplikasinya, atau jadikan database external dan hubungkan lewat alamat eksternalnya.
- Database eksternal tidak terjangkau? Jika alamat eksternalnya adalah IP server Anda sendiri, port database harus terbuka di firewall server dan firewall penyedia cloud. Jika alamat yang ditampilkan adalah IP privat, atur External host server (Clusters → Edit).
- Kata sandi salah? Kata sandi hanya ditampilkan saat pembuatan. Jika hilang, database harus dibuat ulang.
Aplikasi tampil "unreachable"
Raklane saat ini tidak bisa memastikan kondisi aplikasi tersebut, biasanya karena server Offline atau Docker di server tidak merespons. Periksa sudo systemctl status docker dan status agent. Setelah server kembali, Raklane memastikan ulang dan aplikasi kembali active tanpa perlu deploy ulang.
Masih buntu?
Kumpulkan output sudo journalctl -u raklane-agent --since "1 hour ago" dan hasil Check connection, lalu kirimkan ke support Raklane di hi@raklane.com. Lihat juga halaman Pemecahan Masalah umum.