GeoIP-Header (Request-Metadaten)

Wenn smoxy Anfragen an deine Origin-Server weiterleitet, fügt es automatisch eine Reihe von HTTP-Headern hinzu, die Geolokalisierungs- und Netzwerk-Metadaten basierend auf der IP-Adresse des Clients enthalten. Diese GeoIP-Header ermöglichen personalisierte Inhalte, automatische Sprachumschaltung, regionale Compliance und detaillierte Analysen – direkt am Edge, bevor die Anfrage deinen Server erreicht.

Auch bekannt als: GeoIP-Header, Edge-Header, IP-Geolokalisierungs-Header, Standort-Header, Geo-Header

Übersicht

Diese Header werden von smoxy automatisch zu jeder eingehenden Anfrage hinzugefügt. Sie enthalten Informationen wie den ungefähren Standort des Benutzers, dessen Netzwerkprovider sowie einen EU-Status. Die Daten werden in Echtzeit aus der IP-Adresse ermittelt, datenschutzfreundlich und performant.

Verfügbare Header

Header	Beschreibung
s-asn	ASN (Autonomous System Number) des Netzwerks des Clients
s-asorg	Name der Organisation, die dem ASN zugeordnet ist (z. B. „Cloudflare, Inc.“)
s-country	Ländercode gemäß ISO 3166-1 alpha-2 (DE, US usw.)
s-city	Ungefähre Stadt
s-latitude	Ungefähre geografische Breite
s-longitude	Ungefähre geografische Länge
s-subdivisions	ISO 3166-2 Region/Subdivisions-Code (z. B. DE-BY)
s-iseu	Gibt an, ob sich der Nutzer innerhalb der EU befindet (1 = ja, 0 = nein)

Diese Werte eignen sich zur Umsetzung standortbasierter Funktionen direkt im Backend.

Anwendungsfälle

Sprachweiterleitung

Automatische Umleitung je nach Herkunftsland:

$country = $_SERVER['HTTP_S_COUNTRY'] ?? 'US';

$language = match ($country) {
    'DE' => 'de',
    'FR' => 'fr',
    default => 'en',
};

header("Location: /{$language}/");
exit;

DSGVO / EU-Hinweise

Nutze s-iseu, um z. B. nur für EU-Nutzer Cookie-Banner anzuzeigen:

if ($_SERVER['HTTP_S_ISEU'] === '1') {
    // DSGVO-Zustimmungs-UI anzeigen
}

Routing oder Blockierung basierend auf IP oder ASN

Blockiere z. B. bestimmte Netzwerke:

$asn = $_SERVER['HTTP_S_ASN'] ?? null;

if ($asn === '12389') {
    http_response_code(403);
    exit('Zugriff für dieses Netzwerk verweigert');
}

Erweiterte Logs / Analytics

Logge s-country oder s-asorg, um Traffic nach Regionen oder Netzwerken auszuwerten.

Integration & Hinweise

• Alle Header sind mit s- vorangestellt, um Konflikte mit Standard-HTTP-Headern zu vermeiden.

• Die Werte werden von smoxy am Edge eingefügt – sie stehen sofort im Backend zur Verfügung.

• Kein zusätzlicher Client-Code notwendig – ideal für schnelle Serverlogik ohne JS-Abhängigkeit.

Best Practices

• Geodaten sind ungefähre Angaben – für grobe Personalisierung geeignet, aber nicht für exakte Standortentscheidungen.

• Setze Fallbacks für Umgebungen ohne Header (z. B. lokale Entwicklung).

• Logge die Headerwerte bei Bedarf zu Debugging- oder Analysezwecken.