# IP Geo API

Krótko:
- FastAPI zwracające dane geo dla adresu IP (MaxMind GeoLite2 lub IP2Location).
- LRU cache, walidacja IPv4/IPv6, endpoint /reload chroniony BasicAuth.
- Updater pobiera/aktualizuje bazę do /data.

Uruchomienie:
1. Skopiuj `.env.example` -> `.env` i uzupełnij.
2. `docker-compose up --build -d`
3. API: `GET /ip/{ip}` lub `GET /ip`. Reload: `POST /reload` z BasicAuth (ADMIN_USER/ADMIN_PASS).

Pliki:
- app/: kod
- scripts/: downloader + updater
- data/: miejsce dla baz


## Bezpośredni URL do MMDB (np. GitHub Releases)
Jeśli posiadasz pełny link do pliku `.mmdb` (np. z projektu P3TERX/GeoLite.mmdb Releases),
ustaw `MAXMIND_DIRECT_DB_URL` w `.env`. Updater pobierze plik bez rozpakowywania archiwum.


## Automatyczne pobieranie z GitHub Releases
Ustaw `MAXMIND_GITHUB_REPO` (domyślnie `P3TERX/GeoLite.mmdb`). Updater sprawdzi `releases/latest` i pobierze pierwszy asset `.mmdb`.
Opcjonalnie dodaj `GITHUB_TOKEN` dla wyższych limitów GitHub API.
Priorytet w updaterze:

1) GitHub Releases (latest) → `.mmdb`

2) `MAXMIND_DIRECT_DB_URL`

3) Oficjalne pobieranie MaxMind przez `MAXMIND_LICENSE_KEY` + `MAXMIND_DOWNLOAD_URL_TEMPLATE`