IP-Abzeichen
Unten werden mehrere der gängigsten Einbettungsarten für Webseiten gezeigt: nur die IP anzeigen, den Ländercode anzeigen, den Ländernamen auf Chinesisch anzeigen, eine bestimmte IP abfragen sowie farbige „Status“-Badges. Jede Variante wird in einer Zeile dargestellt und eignet sich direkt für persönliche Homepages, Admin-Dashboards, Hinweis-/Ankündigungsseiten oder Statusseiten.
Ihre aktuelle Besuchs-IP:
Egress-Zuordnung prüfen (Code):
(z. B. US/TW/JP)
Egress-Zuordnung prüfen (Chinesisch):
Bestimmte IP abfragen (8.8.8.8):
Bestimmte IP abfragen (Chinesisch):
Status-Darstellung (blau):
(Alternativ auch hex: /check-ip-zh-ff0000)
Zeigt nur die IP des Besuchers (Einsegment-Badge) für die sauberste Ausgabe; ideal für README oder Statusseiten, um den aktuellen Egress schnell zu zeigen.
<img src="https://s.ipin.io/myip" alt="Meine IP" />Durch Anhängen von -blue/-green/-gray usw. am Routenende lässt sich die Hintergrundfarbe steuern, damit das Badge besser zum Seitenthema passt.
<img src="https://s.ipin.io/myip-gray" alt="Meine IP (Grau)" />Unterstützt 6-stellige Hex-Farben (ohne #), um Marken-/Theme-Farben exakt zu treffen.
<img src="https://s.ipin.io/myip-111827" alt="Meine IP (eigene Farbe)" />Zeigt Besucher-IP + Ländercode country_code (z. B. US/TW/JP) – ideal für Dashboards und Statusseiten, um die Egress-Zuordnung schnell zu erkennen.
<img src="https://s.ipin.io/check-ip" alt="IP + Ländercode" />Am Ende -blue/-green usw. anhängen, um die Farbe des rechten Ergebnisblocks zu ändern – häufig für „Status-Semantik“ genutzt.
<img src="https://s.ipin.io/check-ip-blue" alt="IP + Ländercode (Blau)" />Mit 6-stelliger Hex-Farbe den rechten Ergebnisblock anpassen – perfekt für Theme-Farben oder farbliche Einstufung nach Risiko.
<img src="https://s.ipin.io/check-ip-16a34a" alt="IP + Ländercode (benutzerdefiniertes Grün)" />Fragt den Ländercode einer angegebenen IP ab und zeigt ihn an – praktisch, um „verdächtige IPs“ in Tickets, Alerts oder Log-Analysen zu visualisieren.
<img src="https://s.ipin.io/check-8.8.8.8" alt="8.8.8.8 + Ländercode" />Angegebene IP mit Farb-Suffix – geeignet, um Risikostufen „einzufärben“ (z. B. rot = hohes Risiko, gelb = beobachten).
<img src="https://s.ipin.io/check-8.8.8.8-red" alt="8.8.8.8 (Rot)" />Wenn die Route ein Sprachsegment wie -zh/-en/-ja enthält, zeigt die rechte Seite „Code + Ländernamen“. Ohne Sprachsegment wird standardmäßig kein Ländername ausgegeben.
<img src="https://s.ipin.io/check-ip-zh" alt="IP + Code + Ländername (Chinesisch)" />Sprach- und Farbsegment können kombiniert werden: /check-ip-zh-blue – ideal, um in verschiedenen Sprachversionen einen einheitlichen Stil zu behalten. Farbtokens: sky cyan green emerald yellow orange red rose gray black
<img src="https://s.ipin.io/check-ip-zh-blue" alt="Ländername auf Chinesisch (Blau)" />Angegebene IP abfragen und den Ländernamen in der gewünschten Sprache ausgeben – ideal, um „Alarm-IPs“ in Tickets oder Benachrichtigungen einzubetten, sodass Leser das Herkunftsland ohne Detailansicht schnell verstehen.
<img src="https://s.ipin.io/check-8.8.8.8-zh" alt="8.8.8.8 + Ländername (Chinesisch)" />Die Kombination aus angegebener IP + Sprache + Farbe ist ideal, um „Security-/Risikostufen“ zu visualisieren: z. B. Rot steht für hohes Risiko, Grün für Whitelist.
<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="8.8.8.8 (Chinesisch + Grün)" />Einführung in das Tool „IP-Badge“
IP-Badge ist eine schlanke „Bild-API“, die die Besucher-IP (oder eine von Ihnen angegebene IP) zusammen mit dem
country_code (Ländercode) und
country_name (Ländername, optional)
in ein direkt einbettbares SVG-Badge rendert und mit
Content-Type: image/svg+xml
ausliefert. Im Gegensatz zu klassischen JSON-APIs kann das SVG-Badge wie ein normales Bild in README, Admin-Dashboards, Monitoring-Wänden, Statusseiten oder überall dort angezeigt werden, wo ein
<img>
unterstützt wird – ganz ohne zusätzliche Frontend-Renderlogik.
Das Tool nutzt ein zweigeteiltes Badge-Layout (ähnlich shields.io): links steht in der Regel die IP, rechts das Ergebnis (Ländercode oder „Code + Ländername“). Farben und Sprachen lassen sich über Routensegmente steuern.
Als Datenquelle verwendet die IP-Zuordnung die lokale Tabelle
ip2location_db11
(Abgleich von IPv4-Bereichen zur Ermittlung von country_code),
und mehrsprachige Ländernamen stammen aus
sys_lang_multi,
gemappt über vc_code auf Felder wie
name_en / name_zh / name_ja ...
(der Ländername wird nur ausgegeben, wenn die Route ein Sprachsegment enthält).
Zusätzlich versucht das Tool, die echte Client-IP aus gängigen Proxy-Headern (z. B. Cloudflare, X-Forwarded-For) zu ermitteln – ideal für Deployments hinter CDN, Reverse-Proxy oder Load-Balancer.
Routen und Ausgabe: Von minimal bis vollständig
Das Grundprinzip von IP-Badge ist: die Route als Bild-URL verwenden. Öffnen Sie die Route im Browser, sehen Sie das SVG-Badge;
binden Sie dieselbe URL in Markdown oder HTML ein, wird sie als Bild gerendert. Für unterschiedliche „Informationsdichte“ gibt es zwei Hauptkategorien: myip und check:
myip ist für Anzeige (nur IP), check ist für Abfrage (mit Länderinfo).
Außerdem wird der Ländername nur angezeigt, wenn die Route -<lang> enthält.
Ohne Sprachsegment wird nur der Code ausgegeben, damit das Badge kurz und „status-artig“ bleibt.
GET /myipGeeignet für: aktuelle Server-Egress-IP anzeigen, Proxy-Kette debuggen (ob die echte IP durchgereicht wird), persönliche Homepage usw. Ausgabe: Einsegment-Badge mit nur dem IP-Text.
GET /check-ip
Geeignet für: Monitoring-Dashboards und Statusseiten, um das „Egress-Land“ schnell zu erkennen. Rechts steht nur country_code (z. B. US / TW / JP).
GET /check-8.8.8.8Geeignet für: Tickets, Alerts und Log-Analysen – „verdächtige IPs“ als visuelles Label, damit das Herkunftsland sofort erkennbar ist.
GET /check-ip-zh
Geeignet für: Seiten für Nicht-Techniker oder wenn bessere Lesbarkeit gewünscht ist; rechts erscheint country_code + country_name, z. B. „US Vereinigte Staaten“.
Ohne Sprachangabe wird der Ländername standardmäßig nicht ausgegeben, um „zu lange Badges“ zu vermeiden.
GET /check-8.8.8.8-zhGeeignet für: Security Operations, Troubleshooting im Ausland, Support-Ticket-Systeme usw. – Länderinfos eines IPs als „Bild-Badge“ in beliebige Seiten oder Nachrichten einbetten.
Farbsteuerung (Variante B): Am Routenende -<color> wie bei shields
IP-Badge unterstützt das Anhängen von -<color> am Routenende, um die Hintergrundfarbe (meist der rechte Ergebnisbereich) zu steuern –
genau wie bei shields.io: Sie können einfache Farb-Tokens (z. B. blue/green/red/gray) oder einen 6-stelligen Hex-Wert (ohne #) verwenden.
So lassen sich Farben mit Bedeutung verknüpfen, etwa „grün = normal, gelb = beobachten, rot = hohes Risiko“, damit das Badge neben Informationen auch Status-Semantik transportiert.
-
Farb-Token verwenden:
GET /check-ip-zh-blue GET /check-8.8.8.8-greenTokens eignen sich für „schnelle Farbauswahl“, z. B. blue/green/red/orange/yellow/gray usw. (abhängig von Ihrer Mapping-Tabelle im Controller).
-
6-stellige Hex-Farbe (ohne #) verwenden:
GET /check-ip-zh-ff0000 GET /check-8.8.8.8-16a34aHex ist ideal, um exakt auf Ihre Theme-/Brand-Farben abzustimmen und eine konsistente UI zu erhalten.
-
myip unterstützt ebenfalls Farben:
GET /myip-gray GET /myip-111827Einsegment-Badges sind oft „zur Anzeige“ gedacht; Farben helfen, sie besser an den Seitenstil anzupassen oder in Listen hervorzuheben.
Einbettung: Direkt nutzbar in Markdown / HTML / Dashboards
Da IP-Badge ein SVG-Bild ausgibt, ist die empfohlene Nutzung das direkte Einbetten. In GitHub/GitLab-READMEs oder Wikis genügt die Markdown-Bildsyntax;
in Webseiten oder Admin-UIs nutzen Sie einfach das <img>-Tag.
Der größte Vorteil: keine zusätzliche Frontend-Logik, kein CORS-JSON, keine Templates oder Typografie-Sonderfälle – Browser können SVGs von Haus aus als Bilder rendern.
<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="IP-Badge" />Wenn Sie auf einer großen Anzeige oder Statusseite viele Badges gleichzeitig darstellen (z. B. mehrere Node-Egresses oder mehrere IP-Intel-Einträge), empfiehlt sich eine längere Cache-Dauer (z. B. 1 Stunde oder länger). Das reduziert DB-Abfragen deutlich und beschleunigt das Laden. Da sich IP-Zuordnungen selten ändern, ist der Cache-Nutzen sehr hoch.
Typische Szenarien: „IP-Informationen“ als visuelle Komponente
IP-Badge eignet sich hervorragend für „anzeigeorientierte“ Anforderungen. Beispielsweise können Sie auf einer Ops-Statusseite die Egress-IP/Länderinfo verschiedener Nodes als Badge-Wand darstellen und sofort erkennen, ob ein Node aus einer unerwarteten Region ausleitet;
in Security-Operations lassen sich Alarm-IPs als rote Badges in Tickets oder Benachrichtigungen einbetten (z. B. „US United States“ / „RU Russia“), sodass Bereitschaftsdienste den Risikokontext ohne Detailansicht verstehen;
beim Debuggen von CDN-/Reverse-Proxy-Ketten helfen /myip und /check-ip,
um schnell zu prüfen, ob die echte Client-IP korrekt durchgereicht oder fälschlich überschrieben wird;
in mehrsprachigen Backoffices oder internationalen SaaS-Produkten können Sie über -zh/-en/-ja
denselben IP in verschiedenen Sprach-UIs mit unterschiedlichen Ländernamen anzeigen und so den Aufwand für Frontend-Lokalisierungswörterbücher reduzieren.
Darüber hinaus können Sie Farben mit Business-Status verknüpfen – z. B. Grün für „erlaubt“, Gelb für „Verifizierung nötig“, Rot für „gesperrt/hohes Risiko“ – damit das Badge zugleich „Info + Status“ transportiert.
Hinweis: Wenn Sie den Dienst öffentlich anbieten, empfiehlt sich eine Strategie für „vertrauenswürdige Proxy-Header“ auf Reverse-Proxy- oder Anwendungsebene, um das Spoofing von Headern wie X-Forwarded-For zu verhindern.
Zusätzlich sind Indizes auf
ip2location_db11.ip_from und
sys_lang_multi.vc_code
sowie Cache-Header sinnvoll, um Performance und Stabilität zu verbessern.
