Panduan troubleshooting HAProxy dan Keepalived Debian 13 lengkap dengan solusi error, diagnosis masalah, dan implementasi High Availability.

Dalam implementasi High Availability (HA) web server, dua komponen yang paling sering digunakan adalah HAProxy dan Keepalived. Kombinasi keduanya memungkinkan layanan tetap tersedia meskipun salah satu server mengalami kegagalan.

HAProxy berfungsi sebagai load balancer yang mendistribusikan trafik ke beberapa backend server, sedangkan Keepalived menggunakan protokol VRRP (Virtual Router Redundancy Protocol) untuk menyediakan Virtual IP (VIP) yang dapat berpindah secara otomatis saat terjadi kegagalan pada node utama.

Pada praktiknya, banyak peserta UKK TJKT/TKJ, LKS IT Network System Administration (ITNSA), administrator jaringan pemula, hingga sysadmin berpengalaman mengalami berbagai kendala saat melakukan instalasi dan konfigurasi HAProxy serta Keepalived di Debian 13.5 Trixie.

Mulai dari service gagal berjalan, Virtual IP tidak muncul, failover tidak berfungsi, backend dianggap down padahal aktif, hingga konflik firewall yang menyebabkan seluruh skema High Availability gagal bekerja.

Artikel ini membahas proses troubleshooting secara sistematis mulai dari instalasi awal, diagnosis masalah, hingga solusi yang dapat diterapkan dengan cepat saat praktik maupun produksi.

Mengenal Arsitektur HAProxy dan Keepalived

Komponen Utama

Contoh topologi:

Load Balancer 1 (Master)
- IP: 192.168.10.11
Load Balancer 2 (Backup)
- IP: 192.168.10.12
Virtual IP
- VIP: 192.168.10.10
Web Server 1
- 192.168.10.21
Web Server 2
- 192.168.10.22

Alur kerja:

Client mengakses VIP.
VIP aktif pada node master.
HAProxy mendistribusikan trafik.
Jika master gagal:
- Keepalived memindahkan VIP ke backup.
Layanan tetap berjalan tanpa downtime signifikan.

Instalasi HAProxy dan Keepalived dari Nol

Update Sistem

apt update && apt upgrade -y

Instalasi Paket

apt install haproxy keepalived curl net-tools iproute2 -y

Verifikasi:

haproxy -v
keepalived --version

Konfigurasi Dasar HAProxy

File:

nano /etc/haproxy/haproxy.cfg

Contoh konfigurasi:

frontend http_front
    bind *:80
    default_backend web_backend

backend web_backend
    balance roundrobin
    server web1 192.168.10.21:80 check
    server web2 192.168.10.22:80 check

Validasi:

haproxy -c -f /etc/haproxy/haproxy.cfg

Output yang benar:

Configuration file is valid

Konfigurasi Dasar Keepalived

File:

nano /etc/keepalived/keepalived.conf

Contoh node master:

vrrp_instance VI_1 {
    state MASTER
    interface ens18
    virtual_router_id 51
    priority 200
    advert_int 1

    authentication {
        auth_type PASS
        auth_pass walid123
    }

    virtual_ipaddress {
        192.168.10.10
    }
}

Node backup:

state BACKUP
priority 100

Restart:

systemctl restart keepalived

Troubleshooting HAProxy

Error 1: HAProxy Gagal Start

Gejala:

systemctl status haproxy

Menampilkan:

failed

Penyebab

Sintaks konfigurasi salah
Port bentrok
Backend tidak valid

Diagnosis

haproxy -c -f /etc/haproxy/haproxy.cfg

Solusi

Perbaiki error yang ditampilkan validator.

Error 2: Port 80 Sudah Digunakan

Gejala:

cannot bind socket

Diagnosis:

ss -tulpn | grep :80

Contoh hasil:

apache2
nginx

Solusi

Matikan layanan yang bentrok:

systemctl stop apache2
systemctl disable apache2

atau:

systemctl stop nginx

Error 3: Semua Backend DOWN

Tampilan statistik:

DOWN

padahal web server aktif.

Diagnosis

Tes konektivitas:

curl http://192.168.10.21
curl http://192.168.10.22

Tes port:

nc -zv 192.168.10.21 80

Penyebab

Firewall aktif
Web server mati
Port salah

Solusi

Pastikan Apache/Nginx aktif:

systemctl status apache2

atau

systemctl status nginx

Error 4: Statistik HAProxy Tidak Bisa Diakses

Contoh konfigurasi:

listen stats
 bind *:8404
 stats enable
 stats uri /

Diagnosis:

ss -tulpn | grep 8404

Solusi

Pastikan firewall membuka port:

ufw allow 8404/tcp

Troubleshooting Keepalived

Error 5: VIP Tidak Muncul

Diagnosis:

ip a

VIP tidak terlihat.

Penyebab

Interface salah
Service gagal
Konfigurasi rusak

Solusi

Periksa nama interface:

ip link show

Contoh:

ens18
eth0
enp1s0

Pastikan sesuai konfigurasi.

Error 6: Split Brain

Kedua node menjadi MASTER.

Gejala

VIP muncul pada kedua server.

Penyebab

virtual_router_id berbeda
auth_pass berbeda
multicast terblokir

Solusi

Pastikan:

virtual_router_id 51

sama pada kedua node.

Password harus identik.

Error 7: Failover Tidak Berjalan

Master mati tetapi backup tidak mengambil VIP.

Diagnosis

Lihat log:

journalctl -u keepalived -f

Penyebab

Prioritas salah
VRRP diblokir firewall

Solusi

Izinkan VRRP:

iptables -A INPUT -p vrrp -j ACCEPT

atau:

nft add rule inet filter input ip protocol vrrp accept

Error 8: VIP Hilang Setelah Reboot

Penyebab

Keepalived tidak aktif otomatis.

Solusi

systemctl enable keepalived
systemctl enable haproxy

Verifikasi:

systemctl is-enabled keepalived

Tools Diagnosis yang Wajib Dikuasai

Journalctl

Melihat log service.

journalctl -xe

atau

journalctl -u haproxy

Systemctl

Melihat status layanan.

systemctl status haproxy
systemctl status keepalived

ss

Melihat port aktif.

ss -tulpn

Curl

Menguji backend.

curl http://backend-ip

Ping

Tes jaringan.

ping 192.168.10.21

Traceroute

Mendeteksi jalur routing.

traceroute 192.168.10.21

Tcpdump

Melihat paket VRRP.

tcpdump -i ens18

atau

tcpdump -i ens18 vrrp

Studi Kasus UKK dan LKS

Kasus

Peserta berhasil menginstal:

Debian 13
HAProxy
Keepalived

Namun saat pengujian:

VIP tidak muncul
Failover gagal
Backend dianggap down

Langkah Penyelesaian

Cek service.
Cek sintaks konfigurasi.
Cek interface.
Cek firewall.
Cek log Keepalived.
Uji backend dengan curl.
Uji failover dengan mematikan master.

Dalam sebagian besar kasus UKK maupun LKS, akar masalah berada pada:

Salah nama interface
Firewall
Salah IP backend
Typo konfigurasi

Best Practice Implementasi High Availability

Gunakan Health Check

server web1 192.168.10.21:80 check

Health check membantu HAProxy mendeteksi server yang gagal.

Gunakan Prioritas Berbeda

Master:

priority 200

Backup:

priority 100

Simpan Backup Konfigurasi

cp haproxy.cfg haproxy.cfg.bak

Dokumentasikan Topologi

Catat:

Hostname
IP Address
VIP
Interface
Role server

Uji Sebelum Produksi

Lakukan simulasi:

Backend mati
HAProxy mati
Master mati
Reboot server

Kesalahan yang Paling Sering Terjadi

Salah Interface

Contoh:

interface eth0

Padahal interface sebenarnya:

ens18

Dampak

VIP tidak muncul.

Salah Backend IP

Dampak

Semua backend DOWN.

Lupa Membuka Firewall

Dampak

VRRP tidak berjalan.

Tidak Memvalidasi Konfigurasi

Dampak

Service gagal start.

Tidak Menguji Failover

Dampak

Masalah baru diketahui saat sistem produksi mengalami gangguan.

Tips Profesional

Gunakan minimal dua load balancer.
Gunakan tiga node backend jika memungkinkan.
Aktifkan monitoring.
Simpan log secara terpusat.
Gunakan dokumentasi konfigurasi.
Lakukan pengujian berkala.
Simulasikan kegagalan server secara rutin.
Gunakan snapshot VM sebelum perubahan besar.

Kesimpulan

Implementasi HAProxy dan Keepalived pada Debian 13 merupakan salah satu solusi High Availability yang banyak digunakan dalam lingkungan pendidikan, laboratorium jaringan, UKK TJKT, LKS ITNSA, hingga infrastruktur produksi.

Sebagian besar kegagalan implementasi sebenarnya bukan disebabkan oleh bug aplikasi, melainkan kesalahan konfigurasi seperti nama interface yang tidak sesuai, firewall yang memblokir VRRP, kesalahan penulisan alamat IP backend, atau sintaks konfigurasi yang tidak valid.

Dengan memahami metode troubleshooting yang sistematis, memanfaatkan tools diagnosis seperti systemctl, journalctl, ss, curl, dan tcpdump, administrator dapat menemukan akar masalah lebih cepat serta mengurangi downtime layanan secara signifikan.

Kemampuan troubleshooting inilah yang sering menjadi pembeda antara peserta yang hanya mampu melakukan instalasi dengan peserta yang benar-benar memahami cara kerja High Availability pada Debian Server.

Tags WordPress

FAQ

Pertanyaan:

Apa fungsi utama HAProxy?

Jawaban:

HAProxy berfungsi sebagai load balancer yang mendistribusikan trafik ke beberapa backend server agar beban lebih merata dan layanan tetap tersedia.

Pertanyaan:

Apa fungsi Keepalived?

Jawaban:

Keepalived menyediakan Virtual IP menggunakan VRRP sehingga failover dapat berlangsung otomatis saat server utama gagal.

Pertanyaan:

Mengapa Virtual IP tidak muncul?

Jawaban:

Biasanya karena nama interface salah, service Keepalived gagal berjalan, atau konfigurasi VRRP tidak valid.

Pertanyaan:

Bagaimana cara mengecek konfigurasi HAProxy?

Jawaban:

Gunakan perintah:

haproxy -c -f /etc/haproxy/haproxy.cfg

Pertanyaan:

Tool apa yang paling sering digunakan untuk troubleshooting?

Jawaban:

Systemctl, Journalctl, Curl, SS, Ping, Traceroute, dan Tcpdump.

Pertanyaan:

Apakah HAProxy dan Keepalived cocok untuk UKK dan LKS?

Jawaban:

Sangat cocok karena sering digunakan untuk materi High Availability, Load Balancing, dan Administrasi Server Linux.

Mengalami kendala saat mengimplementasikan HAProxy dan Keepalived di Debian 13? Tuliskan pengalaman, error yang muncul, atau solusi yang pernah Anda temukan pada kolom komentar agar dapat menjadi referensi bagi administrator lainnya.

Jika artikel ini bermanfaat, bagikan kepada rekan guru TJKT, peserta UKK, peserta LKS ITNSA, mahasiswa, maupun sysadmin yang sedang belajar High Availability Server. Jangan lupa juga membaca artikel terkait Debian Server, Load Balancing, Linux Administration, MikroTik, Cloud Computing, dan Infrastruktur IT lainnya untuk memperdalam kompetensi Anda. Ikuti terus konten terbaru agar tidak ketinggalan panduan teknis, studi kasus, dan tutorial implementasi server modern.