v0.1.0

Packeteer v0.1.0

First installable release of Packeteer, an open-source BGP path performance controller (observe by default).

Install (pinned)

curl -fsSLo config.yaml https://raw.githubusercontent.com/GrandArcher/Packeteer/main/config.example.yaml
# Edit providers and source IPs. Leave mode: observe.
mkdir -p plugins
IMAGE=ghcr.io/grandarcher/packeteer:0.1.0

docker run --rm \
  -v "$PWD/config.yaml:/etc/packeteer/config.yaml:ro" \
  "$IMAGE" -check

docker run -d --name packeteer --network host \
  --cap-add NET_RAW --cap-add NET_ADMIN \
  --restart unless-stopped \
  -v "$PWD/config.yaml:/etc/packeteer/config.yaml:ro" \
  -v "$PWD/plugins:/etc/packeteer/plugins:ro" \
  "$IMAGE"

Dashboard (default): http://127.0.0.1:8080/

What's in

• GoBGP/ExaBGP-style iBGP announcer with allowlist, community + NO_EXPORT, caps, hold/hysteresis
• FRR Docker lab + e2e CI (announce, withdraw, SIGKILL crash-withdraw)
• Flow-based target discovery
• Read-only ops HTTP: healthz/readyz, Prometheus metrics, JSON API, embedded dashboard
• Safety fixes: RIB leave withdraw, exact learned prefix only, stale-round withdraw, hold-timer e2e
• Operator quick start, CONFIG.md, CHANGELOG

Safety gate (BOT.md)

Stock image and examples stay mode: observe. Lab inject uses documentation prefix 198.51.100.0/24 only. Unit, docker, and BGP e2e green on main.

What's Changed

• M1: load and validate config, print observe-mode status (#1) by @GrandArcher in #3
• Docker-first packaging: Dockerfile, compose, GHCR publish (#4) by @GrandArcher in #12
• Plugin architecture: interfaces, registry, exec + webhook plugins (#13) by @GrandArcher in #14
• docs: Noction IRP feature parity matrix by @GrandArcher in #35
• Probe engine: icmp/tcp probers, static source, worker pool, rate limits (#2) by @GrandArcher in #36
• chore: bump Go to 1.26, update x/net and x/time by @GrandArcher in #37
• RIB view: learn-only iBGP via embedded GoBGP (#6) by @GrandArcher in #38
• Decision engine: weighted scorer, thresholds, hysteresis, cap (#7) by @GrandArcher in #39
• docs: add BOT.md autonomous charter by @GrandArcher in #41
• announce: GoBGP injector and FRR e2e lab by @GrandArcher in #40
• Add Sponsor button (PayPal) and support section by @GrandArcher in #42
• #5 flow-based target discovery by @GrandArcher in #47
• #49-#54 charter adds v0.5 hardening milestone by @GrandArcher in #55
• #43 withdraw a real RIB leave without flapping by @GrandArcher in #48
• #44 announce only the exact learned prefix by @GrandArcher in #57
• #46 withdraw stale routes when a probe round hangs by @GrandArcher in #58
• #45 e2e SIGKILL drops the route within the hold timer by @GrandArcher in #59
• #9 add read-only ops HTTP surface by @GrandArcher in #60
• #11 document the operator quick start and v0.1.0 notes by @GrandArcher in #61

New Contributors

• @GrandArcher made their first contribution in #3

Full Changelog: https://github.com/GrandArcher/Packeteer/commits/v0.1.0