Geo-Blocking

Block or allow traffic by country at the domain level using an internal MaxMind GeoIP database.

How it works

Yercekimsiz evaluates the request's IP against a MaxMind database and applies domain-scoped allow/block rules. Decisions are enforced at the edge to minimize latency.

Key Features

  • Domain-scoped rules: per-domain allowlists and blocklists
  • MaxMind DB: low-latency local lookups (no external calls)
  • Flexible actions: block (403), challenge (CAPTCHA), or redirect
  • Audit logs: store hits and decisions for forensics

Example Configuration

# Example API request to add a blocked country
POST /api/v1/geo-blocking
domain: example.com
action: block
countries: RU, CN

Notes

All lookups are served locally from the bundled MaxMind DB to avoid added latency; updates are applied in real-time via config propagation.