Skip to content

ethpandaops/dugtrio

Repository files navigation

Dugtrio: Beaconchain Load Balancer

Dugtrio is a load balancing proxy for the ethereum beacon chain.

It supports various features:

  • Close monitoring of connected endpoints to sort out forked off / unsynced clients
  • Endpoint stickiness (Reuse the same endpoint for subsequent requests when possible)
  • Client specific endpoints (client specific endpoints like /lighthouse/... or /teku/... are forwarded to the correct client type)
  • Rate limiting per IP
  • Path filtering (block certian endpoint paths)

Getting Started

Download a release

Download the latest release from the Releases page. Extract and run with:

./dugtrio-proxy -config ./dugtrio-config.yaml

Docker

Available as a docker image at ethpandaops/dugtrio

Images

  • latest - distroless, multiarch
  • debian-latest - debian, multiarch
  • $version - distroless, multiarch, pinned to a release (i.e. 1.0.1)
  • $version-debian - debian, multiarch, pinned to a release (i.e. 1.0.1-debian)

Build from source

Or build it yourself:

git clone https://github.com/ethpandaops/dugtrio.git
cd dugtrio
make
./bin/dugtrio-proxy -config ./dugtrio-config.yaml

Usage

Dugtrio needs a configuration file with a list of client endpoints to use. Create a copy of dugtrio-config.example.yaml and change it for your needs.

Contact

pk910 - @pk910