Mengatur local preference VyOS adalah salah satu cara paling umum untuk mengarahkan trafik BGP lewat jalur tertentu, misalnya saat router Anda punya dua upstream dan Anda ingin menjadikan salah satunya sebagai jalur utama. VyOS memakai pendekatan route-map khas FRRouting, sehingga sintaksnya berbeda dari platform lain seperti MikroTik atau Cisco meski konsepnya sama.
Artikel ini membahas langkah demi langkah cara set local preference BGP di VyOS, lengkap dengan contoh perintah, studi kasus dua upstream, cara verifikasi, dan kesalahan yang paling sering terjadi.
Apa Itu Local Preference dalam BGP?
Local preference adalah salah satu atribut BGP yang menentukan jalur mana yang router pilih ketika tersedia lebih dari satu rute menuju prefix yang sama. Router BGP selalu memilih rute dengan nilai local preference tertinggi sebagai best path, sebelum router mempertimbangkan atribut lain seperti AS-path atau MED. Secara default, VyOS dan FRR di baliknya menetapkan local preference sebesar 100 untuk setiap rute yang router terima.

Router hanya menyebarkan local preference ke sesama anggota AS lewat iBGP, bukan ke peer eBGP, sehingga Anda tidak bisa memakai atribut ini untuk memengaruhi keputusan routing di jaringan upstream.
Karena sifatnya yang hanya berlaku secara internal, Anda memakai local preference untuk mengatur preferensi keluar (outbound traffic engineering) dari AS Anda sendiri, misalnya memilih upstream mana yang router pakai lebih dulu ketika Anda punya dua jalur eBGP atau lebih.
Dua Cara Mengatur Local Preference di VyOS
VyOS menyediakan dua pendekatan untuk mengatur local preference: Anda bisa menetapkan satu nilai default secara global, atau mengatur nilai per rute lewat route-map. Tabel berikut merangkum perbedaan keduanya.
| Pendekatan | Cakupan | Berlaku untuk | Kapan dipakai |
|---|---|---|---|
| Default local-preference | Global, satu nilai untuk seluruh proses BGP | Rute eBGP dan rute yang router originate sendiri | Saat Anda ingin semua rute dari luar AS punya prioritas yang sama |
| Route-map (set local-preference) | Granular, per rule, per neighbor, atau per prefix | Semua rute yang cocok dengan rule yang Anda buat | Saat Anda ingin membedakan prioritas antar upstream atau antar prefix tertentu |
Dokumentasi resmi VyOS menjelaskan sintaks lengkap route-map di halaman Route Map Policy dan opsi BGP lainnya di halaman BGP.
Persiapan Sebelum Konfigurasi
- VyOS 1.3, 1.4, atau 1.5 sudah terpasang dan proses BGP sudah berjalan (system-as sudah Anda set)
- Sesi BGP ke neighbor yang ingin Anda atur sudah berstatus Established
- Anda tahu alamat IP neighbor dan AS number yang terlibat
- Anda punya akses ke configure mode beserta hak untuk commit dan save konfigurasi
- Anda siap menjalankan soft-reset BGP supaya perubahan route-map langsung berlaku
Langkah-Langkah Set Local Preference di VyOS

1. Cek Status Sesi BGP
Sebelum mengubah apa pun, pastikan dulu sesi BGP ke neighbor target sudah berstatus Established.
show bgp ipv4 unicast summary2. Buat Route-Map dengan Local-Preference
Buat route-map baru, lalu atur rule yang menaikkan local preference. Tambahkan juga satu rule permit tanpa kondisi di baris paling akhir supaya route-map tidak ikut menolak rute lain (lihat bagian Kesalahan Umum untuk detailnya).
set policy route-map PREF-UTAMA rule 10 action 'permit'
set policy route-map PREF-UTAMA rule 10 set local-preference '200'
set policy route-map PREF-UTAMA rule 100 action 'permit'3. Pasang Route-Map ke BGP Neighbor
Terapkan route-map ke arah import pada neighbor yang ingin Anda prioritaskan, lalu aktifkan soft-reconfiguration supaya Anda bisa membandingkan rute sebelum dan sesudah filter berjalan.
set protocols bgp neighbor 203.0.113.2 address-family ipv4-unicast route-map import 'PREF-UTAMA'
set protocols bgp neighbor 203.0.113.2 address-family ipv4-unicast soft-reconfiguration 'inbound'
commit
save4. Terapkan Tanpa Mengulang Sesi BGP
Setelah commit, jalankan soft-reset supaya VyOS mengevaluasi ulang rute yang sudah diterima tanpa memutus sesi TCP BGP.
reset bgp ipv4 203.0.113.2 soft inOpsional: Set Default Local-Preference Secara Global
Jika Anda ingin semua rute eBGP memakai local preference yang sama tanpa membuat route-map, gunakan parameter default berikut. Perlu Anda ingat, nilai ini tidak memengaruhi rute yang router terima lewat iBGP.
set protocols bgp parameters default local-pref '150'Contoh Kasus: Mengutamakan Jalur ISP Utama Dibanding Backup
Misalkan router Anda punya dua upstream, ISP Utama (AS65010, 203.0.113.2) dan ISP Backup (AS65020, 198.51.100.2). Anda ingin lalu lintas keluar selalu lewat ISP Utama selama sesinya aktif, dan baru beralih ke ISP Backup saat ISP Utama mati. Berikut konfigurasi lengkapnya.
set protocols bgp system-as '65000'
set protocols bgp neighbor 203.0.113.2 remote-as '65010'
set protocols bgp neighbor 198.51.100.2 remote-as '65020'
set policy route-map PREF-UTAMA rule 10 action 'permit'
set policy route-map PREF-UTAMA rule 10 set local-preference '200'
set policy route-map PREF-UTAMA rule 100 action 'permit'
set protocols bgp neighbor 203.0.113.2 address-family ipv4-unicast route-map import 'PREF-UTAMA'
set protocols bgp neighbor 203.0.113.2 address-family ipv4-unicast soft-reconfiguration 'inbound'
set protocols bgp neighbor 198.51.100.2 address-family ipv4-unicast soft-reconfiguration 'inbound'
commit
save
reset bgp ipv4 203.0.113.2 soft in
reset bgp ipv4 198.51.100.2 soft inDengan konfigurasi ini, setiap rute yang router terima dari ISP Utama mendapat local preference 200, sedangkan rute dari ISP Backup tetap memakai nilai default 100. Router otomatis memilih jalur lewat ISP Utama selama sesinya tersedia.
Cara Verifikasi Local Preference Sudah Aktif
Setelah Anda commit dan menjalankan soft-reset, verifikasi hasilnya lewat beberapa perintah berikut.
show bgp ipv4 unicast
show bgp ipv4 203.0.113.0/24
show bgp ipv4 neighbors 203.0.113.2 routesPerhatikan kolom LocPrf pada output show bgp ipv4 unicast. Rute yang route-map Anda tandai akan menampilkan nilai 200, sementara rute lain tetap menampilkan 100.
Kesalahan Umum yang Sering Terjadi
- Lupa menambahkan rule permit tanpa kondisi di akhir route-map. FRR menerapkan implicit deny di akhir setiap route-map, sehingga route-map otomatis menolak rute yang tidak cocok dengan rule mana pun, bukan sekadar membiarkannya dengan local preference default.
- Mengira local preference memengaruhi keputusan router di AS lain. Local preference hanya berjalan lewat iBGP, sehingga upstream Anda tidak pernah melihat nilai ini.
- Mengubah route-map tanpa menjalankan reset bgp soft in. Tanpa soft-reset, VyOS tetap memakai rute lama sampai Anda me-restart sesi BGP atau timer berikutnya berjalan.
- Menyamakan default local-pref dengan route-map. Parameter default local-pref hanya berlaku untuk rute eBGP dan rute lokal, bukan untuk rute yang router terima lewat iBGP.
- Lupa menjalankan commit dan save setelah mengubah konfigurasi, sehingga perubahan hilang begitu router reboot atau sesi CLI berakhir.
Kesimpulan
Mengatur local preference di VyOS cukup sederhana begitu Anda memahami dua pendekatannya: nilai default secara global lewat parameter BGP, atau kontrol granular lewat route-map. Pendekatan route-map lebih fleksibel untuk kasus multihoming, karena Anda bisa menentukan prioritas per neighbor atau bahkan per prefix tertentu.
Jika Anda sedang menyiapkan router VyOS untuk lingkungan BGP multihoming, VPS Linux Computing ID menyediakan resource yang cukup untuk menjalankan VyOS sebagai virtual router dengan latensi rendah.





