geo302 — HTTP redirect proxy with healthcheck

geo302 is not an actual proxy, but a "pathfinder", which responses with 302 Found redirecting the HTTP-client to the actual URL. We use geolite2 geoIP database to determine user's location and select the most suitable upstream for this location. Client's IP is determined using proxy headers like X-FORWARDED-FOR with a fallback to the socket IP address. geo302 performs active health checks against all upstreams pinging them every few seconds.

The main use case of geo302 is redirecting a user to the closest server to minimize download time of large files.

Quick start

• Edit configuration file geo302.toml
• cargo run --release -- ./geo302.toml

Geo-IP databases

geo302 supports two databases: proprietary Maxmind DB and ripe-geo based on RIPE, GEONAMES and IPDENY. A fork of the ripe-geo database is available as a git submodule of this repository, geo302 can be built with this database embedded into the executable. geo302 also supports automatically updates to the most recent version of this database.

Database support can be turned on or off by compile-time features (flags).

Compile-time features

geo302 build can be configured to have more functionality in the cost of the executable size and larger dependency graph. All features are additive and could activate other features.

For example the following command will compile ./target/release/geo302 with a support of Maxmind DB only: bash cargo build --release --no-default-features --features=maxminddb

| Feature | in default | includes | Description | |-----------------------|-------------|----------|-----------------------------------------------------------------------------------------------------------------| | maxminddb | ✓ | — | Maxmind DB support | | multi-thread | ✓ | — | Mutli-thread support and threads condiguration option | | ripe-geo | ✓ | — | ripe-geo DB support, if no ripe-geo-* options specified, then DB can be loaded from filesystem only | | ripe-geo-autoupdate | ✓ | multi-thread, ripe-geo | Loading and autoupdating of the ripe-geo DB from the web | | ripe-geo-embedded | | ripe-geo | Compiles ripe-geo DB into geo302 executable, user needs no local or web ripe-geo distribution to be available | | | default | ✓ | maxminddb, ripe-geo-autoupdate | Default feature set, adds no functionality itself | | full | | maxminddb, ripe-geo-autoupdate, ripe-geo-embedded | Activates all features, adds no functionality itself |

Configuration

See examples of the configuration in config-examples directory.

Here we present a configuration for the default compile-time feature set, optional entries have the default values:

```toml host = "127.0.0.1:8080" # address to listen ipheaders = ["x-forwarded-for"] # optional headers to get client's IP, the first available is used ipheaderrecursive = true # each haeder could have multiple IPs. true: get the first ip in the header, false: get the last one loglevel = "info" # logging level response_headers = {