The mission is to develop a high-performance and safe BGP implementation; an experiment to implement aged and rusty BGP protocol in a modern language. RustyBGP is much faster than other OSS implementations. One reason of the high performance is that RustyBGP is designed to exploit multicore processors. Here is a CPU usage comparison with FRR 7.5 during processing 32 peers with 800K prefixes each; RustyBGP (left) uses all the cores while FRR uses only few.
RustyBGP supports the gRPC APIs same as GoBGP; your code to manage GoBGP via the APIs should work with RustyBGP. If you need CLI, GoBGP CLI tool allows you to manage RustyBGP. RustyBGP also supports the same configuration file format as GoBGP (only toml and yaml for now).
You can easily build RusyBGP on any system that has Docker running. You don't need Rust development environment. You can build the x86_64 statically-linked binary as follows:
$ git clone https://github.com/osrg/rustybgp.git
$ cd rustybgp
$ docker pull ghcr.io/rust-cross/rust-musl-cross:x86_64-unknown-linux-musl
$ docker run --rm -it -v "$(pwd)":/home/rust/src ghcr.io/rust-cross/rust-musl-cross:x86_64-unknown-linux-musl cargo build --release
$ ls target/x86_64-unknown-linux-musl/release/rustybgpd
target/x86_64-unknown-linux-musl/release/rustybgpd
$ sudo ./target/x86_64-unknown-linux-musl/release/rustybgpd -f gobgpd.conf
Hello, RustyBGP (32 cpus)!
Then you can manage the daemon on a different terminal with GoBGP's CLI command.
$ gobgp neighbor
Peer AS Up/Down State |#Received Accepted
198.51.100.2 65002 never Idle | 0 0
If you just want to check out the performance, start the daemon with --any-peers
option. The daemon accepts any peers without configuration.
$ sudo ./target/x86_64-unknown-linux-musl/release/rustybgpd --as-number 65001 --router-id 203.0.113.1 --any-peers
Hello, RustyBGP (32 cpus)!
Currently, the very basic BGP features are supported; eBGP and iBGP, active/passive connection, RPKI, BMP (BGP monitoring protocol), MRT, etc with the following gRPC APIs.
API | Relevant CLI | Note |
---|---|---|
start_bgp | gobgp global as <VALUE> router-id <IP> |
|
get_bgp | gobgp global |
|
add_peer | gobgp neighbor add <IP> as <VALUE> router-id <IP> |
v4/v6 families and addpath (rx) supported |
delete_peer | gobgp neighbor del <IP> |
|
list_peer | gobgp neighbor /gobgp neighbor <IP> |
|
enable_peer | gobgp neighbor <IP> enable |
|
disable_peer | gobgp neighbor <IP> disable |
|
add_peer_group | ||
add_dynamic_neighbor | ||
add_path | gobgp global rib add <PREFIX> |
|
delete_path | gobgp global rib del <PREFIX> |
|
list_path | gobgp global rib /gobgp neighbor <IP> [adj-in|adj-out] |
|
add_path_stream | gobgp mrt global inject [FILE] |
|
get_table | gobgp global rib summary |
|
add_policy | ||
list_policy | ||
add_defined_set | ||
list_defined_set | ||
add_statement | ||
list_statement | ||
add_policy_assignment | ||
list_policy_assignment | ||
add_rpki | gobgp rpki server <IP> add |
|
list_rpki | gobgp rpki server |
|
list_rpki_table | gobgp rpki table |
|
enable_mrt | ||
add_bmp | gobgp bmp add |
routemonitoring is supported only with adjin |
list_bmp | gobgp bmp |
You have code or documentation for RustyBGP? Awesome! Send a pull request. No CLA, board members, governance, or other mess. See BUILD.md
for info on code contributing.