Traefik GeoIP Filter

A GeoIP allow/blocklist middleware for Traefik that filters incoming requests by country, subdivision, city, or place using the MaxMind GeoLite2 database.

  • Network Services
  • Security
  • Tools & Utilities
A GeoIP allow/blocklist middleware for Traefik that filters incoming requests by country, subdivision, city, or place using the MaxMind GeoLite2 database. A free MaxMind account is required to download the database.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

47/100 Fair

Maintained
30last commit 427 days ago
Popular
2619 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
95512 MB minimum RAM, runs on ARM
Security check
85no serious findings, CI

Availability: platform listings confirmed today, links checked 33 days ago

GitHub stars
19
Open issues
8
Last commit
2025-09-19
License
BSD-2-Clause
Activity
stale

Checked 9 days ago - source: GitHub (mpdcampbell/traefik-geoip-filter)

Resources & Compatibility

Minimum requirements: 512 MB RAM. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Open ports 80 and 443 for web traffic Set Traefik's entry points (its front doors) to web:80 for normal web traffic and websecure:443 for secure web traffic, and open those ports in your firewall so visitors can reach your services; without that, your router will not be reachable from outside. source
  • Remove old v2 settings so v3 can start If you are upgrading from Traefik v2, remove old pilot.token and InfluxDB v1 metrics (old performance-data settings) before starting v3; those old options are unsupported and can stop Traefik from starting at all. source
  • Keep your routing config folder safe If you use file-based routing, point Traefik's file provider at the folder containing your route files (the rules that say which app serves which website address) and keep that folder safe, because losing it can make Traefik forget where to send traffic. source
  • MaxMind Account A free MaxMind account is required to obtain the GeoLite2 database before first use. source

Fetched 45 days ago - each note links to its source

Alternatives (10)

  • BunkerWeb - BunkerWeb is a self-hosted, open-source web application firewall and NGINX-based web server that protects services with secure-by-default s…
  • Caddy - Caddy is an extensible web server and reverse proxy that serves Transport Layer Security (TLS) by default, making it simple to secure and r…
  • Envoy Gateway - Envoy Gateway is an open-source project that manages Envoy Proxy as a standalone or Kubernetes-based application gateway.
  • Fossorial Pangolin - Open-source identity-based remote access platform using WireGuard, offering unified management, tunneled connections, granular access contr…
  • Haproxy - HAProxy is a TCP proxy and a HTTP reverse proxy.
  • Nginx Proxy Manager - Nginx Proxy Manager is a self-hosted reverse proxy and web server that lets you expose home or small-office applications to the internet wi…
  • nginx - Nginx is an HTTP web server, reverse proxy, content cache, load balancer, TCP/UDP proxy, and mail proxy server.
  • npmplus - NPMplus is an improved fork of Nginx Proxy Manager that provides a web interface for managing reverse proxy rules, SSL certificates, and ap…
  • traefik - Traefik is a modern HTTP reverse proxy and load balancer that integrates with Docker, Kubernetes, and other container orchestrators to conf…
  • tsdproxy - TSDProxy is a Tailscale proxy for Docker containers that automatically creates Tailscale machines for labeled containers, providing automat…

Checked 41 days ago - source: AlternativeTo

Common questions

Do I need a MaxMind account to run traefik-geoip-filter?

Yes. It uses the Maxmind GeoLite2 database, so a free MaxMind account is required.

Does Traefik need to be on the same Docker network as the GeoIP filter?

Yes, Traefik must be on the same Docker network.

What blocking precision can the filter support?

Access can be controlled at country, state, county, city, or town level. Accuracy decreases as the location level gets finer.

Which ports should be open for Traefik's web entrypoints when using this middleware?

Open ports 80 and 443 for web and websecure traffic. These ports should also be open in your firewall.

Answers sourced from forums.unraid.net, github.com, github.com

Community

Collected 53 days ago - public community threads