Blog

Failover WireGuard IPv4/IPv6: Mengapa Dua Peer Tidak Cukup

Pelajari mengapa dua peer WireGuard tidak menciptakan failover endpoint dari IPv6 ke IPv4, serta cara memeriksa perilaku endpoint, perutean, dan keepalive dengan aman.

FreeGuard Editorial Team · 2026-11-05

Menambahkan peer IPv4 dan peer IPv6 ke profil WireGuard tidak serta-merta menciptakan koneksi utama dan koneksi siaga. Pertama, bedakan alamat yang digunakan untuk menjangkau server VPN dari alamat tujuan yang dibawa di dalam terowongan. Perbedaan ini menjelaskan mengapa suatu konfigurasi dapat terlihat redundan tetapi tidak memberikan pemulihan otomatis.

Panduan ini membahas semantik konfigurasi WireGuard dan perintah diagnostik untuk sistem Linux dengan perangkat WireGuard. Aplikasi seluler dan desktop dapat menambahkan pengelolaan koneksi sendiri; periksa perilaku klien dan versi yang benar-benar Anda gunakan. Tidak ada klaim bahwa pengujian jaringan langsung dilakukan di sini.

Bedakan endpoint dari lalu lintas di dalam terowongan

Ikhtisar konsep WireGuard menjelaskan dua keputusan: memilih peer untuk tujuan di dalam terowongan, lalu mengirim paket terenkripsi ke endpoint peer tersebut. IPv4 dan IPv6 dapat dikombinasikan di kedua lapisan ini.

Pengaturan Pertanyaan yang dijawab
Endpoint Ke mana paket UDP terenkripsi harus dikirim?
AllowedIPs Alamat tujuan di dalam terowongan mana yang memilih peer ini, dan alamat sumber masuk mana yang diterima darinya?

Endpoint IPv4 dapat membawa lalu lintas terowongan IPv6. Endpoint IPv6 dapat membawa lalu lintas terowongan IPv4. Oleh karena itu, AllowedIPs = ::/0 tidak berarti “gunakan alamat IPv6 server”, dan AllowedIPs = 0.0.0.0/0 tidak berarti “gunakan alamat IPv4-nya”. Entri tersebut mencocokkan keluarga alamat tujuan di dalam terowongan, sebagaimana didokumentasikan dalam manual wg.

Mengapa dua peer tidak membentuk pasangan failover

Memberikan semua tujuan IPv4 kepada satu peer dan semua tujuan IPv6 kepada peer lain membagi lalu lintas di dalam terowongan berdasarkan keluarga alamat. Hal itu tidak memberi tahu WireGuard untuk memindahkan lalu lintas peer pertama ke peer kedua ketika sebuah endpoint berhenti berfungsi.

Memberikan prefiks tujuan yang sama kepada kedua peer juga bukan kebijakan siaga. Dalam implementasi allowed-IP WireGuard di Linux, memasukkan prefiks persis yang sudah ada akan memperbarui asosiasinya dengan peer. Ini adalah pengamatan terhadap implementasi, bukan jaminan lintas platform tentang konfigurasi mana yang akan diterima oleh klien grafis. Jangan gunakan prefiks duplikat sebagai pemeriksaan kesehatan atau daftar prioritas.

Pemasangan rute merupakan lapisan lain. Di Linux, wg-quick biasanya menyusun rute dari IP yang diizinkan untuk peer dan menangani rute default secara khusus. Opsi Table mengubah perilaku tersebut. Rute yang mencapai antarmuka WireGuard dan peer yang memilih tujuan yang dimaksud sama-sama harus benar.

Roaming, pembaruan nama host, dan keepalive menyelesaikan masalah yang berbeda

WireGuard dapat memperbarui endpoint peer setelah menerima lalu lintas yang diautentikasi dengan benar dari alamat sumber dan port baru. Perilaku roaming yang terdokumentasi ini tidak menentukan daftar tujuan IPv6 dan IPv4 secara berurutan untuk dicoba ketika endpoint saat ini tidak dapat dijangkau.

Demikian pula, nama host dengan kedua keluarga alamat tidak cukup menjadi bukti adanya fallback otomatis. Periksa endpoint yang benar-benar digunakan dan kebijakan resolusi serta penyambungan ulang yang didokumentasikan untuk klien tersebut. Kontribusi resolusi ulang DNS terpisah dari proyek ini memperbarui status endpoint kernel setelah perubahan DNS dinamis; keberadaannya merupakan alasan untuk menyelidiki alat pengelola, bukan alasan untuk menganggap setiap klien terus-menerus melakukan resolusi ulang nama host.

Keepalive persisten ditujukan untuk pemetaan NAT atau firewall yang tidak aktif. Panduan mulai cepat resmi menyebutkan 25 detik sebagai interval yang sesuai untuk banyak konfigurasi semacam itu dan menyatakan bahwa sebagian besar pengguna tidak memerlukannya. Keepalive tidak menentukan endpoint alternatif atau kebijakan pergantian rute. Koneksi yang terhenti setelah perubahan jaringan seluler, berdasarkan gejala itu saja, bukan bukti adanya gangguan operator atau masalah keepalive.

Periksa koneksi Linux tanpa mengekspor konfigurasinya

Ganti wg0 dengan nama antarmuka Anda. Ini adalah perintah referensi untuk mesin Anda sendiri; perintah ini tidak dijalankan terhadap VPN pembaca:

sudo wg show wg0 endpoints
sudo wg show wg0 allowed-ips
sudo wg show wg0 latest-handshakes
sudo wg show wg0 transfer

Manual wg mendokumentasikan tampilan selektif ini. Simpan keluarannya secara lokal: endpoint dan pengenal peer masih dapat mengungkap informasi jaringan Anda. Hindari membagikan ekspor konfigurasi lengkap atau dump yang berisi data rahasia.

Catat status sebelum dan sesudah upaya menjangkau layanan publik yang dikenal. Handshake lama pada terowongan yang tidak aktif tidak cukup untuk mendiagnosis kegagalan. Bandingkan pengamatan endpoint, handshake, dan transfer dengan hasil aplikasi.

Pengamatan Pemeriksaan selanjutnya
Keluarga alamat endpoint berbeda dari keluarga alamat lalu lintas di dalam terowongan Ini bisa saja valid; periksa pemilihan tujuan secara terpisah
Lalu lintas tetap berada pada satu peer meskipun ada prefiks duplikat Tinjau asosiasi peer; duplikasi tidak membentuk perilaku siaga
Perubahan jaringan membuat endpoint tidak dapat dijangkau Periksa kebijakan pemilihan endpoint dan penyambungan ulang klien
Lalu lintas terowongan kembali berjalan tetapi nama masih gagal diresolusi Selidiki DNS secara terpisah menggunakan alur kerja DNS Linux

Pilih dan verifikasi kebijakan pemulihan

Untuk satu server yang dapat dijangkau melalui kedua keluarga alamat, gunakan klien atau pengelola jaringan yang perilaku terdokumentasinya mencakup pemilihan endpoint dan pemulihan yang Anda perlukan. Dengan profil biasa, perbandingan terkontrol menggunakan satu endpoint pada satu waktu dapat menunjukkan jalur mana yang berfungsi, tetapi pergantian manual bukan failover otomatis.

Simpan pengaturan asli dengan aman sebelum melakukan perubahan. Pada koneksi tepercaya, ulangi permintaan aplikasi yang sama dan tidak berbahaya sebelum dan sesudah transisi jaringan biasa. Tetap aktifkan perlindungan VPN. Jangan memaksakan gangguan pada koneksi jarak jauh yang Anda andalkan untuk pemulihan.

Jika pemulihan otomatis adalah tujuannya, cari endpoint yang dapat dijangkau, bukti handshake baru dan lalu lintas, serta permintaan aplikasi yang berhasil setelah transisi. Verifikasi kedua keluarga alamat di dalam terowongan jika keduanya diperlukan. Catat sendiri waktu pemulihan alih-alih menganggapnya sebagai jaminan. Pulihkan pengaturan yang disimpan jika perubahan memperburuk konektivitas.

Pemeriksaan IP di browser merupakan bukti tentang permintaan browser tersebut. Pemeriksaan itu tidak dapat mengidentifikasi endpoint yang dipilih WireGuard, membuktikan rute setiap aplikasi, atau memastikan bahwa failover di masa mendatang akan berfungsi. Pemeriksaan DNS di situs ini juga tidak memastikan resolver rekursif perangkat atau membuktikan perutean VPN. Gunakan pengamatan saat berjalan dan pemeriksaan aplikasi secara bersama-sama.

Untuk pertanyaan yang lebih luas tentang tujuan mana yang harus menggunakan terowongan, lanjutkan ke pusat topik split tunneling. Pisahkan keputusan perutean tersebut dari kebijakan yang memulihkan koneksi server yang gagal.