Leitfaden

Öffentliche IP im Terminal: curl ip-db.com/me

Die öffentliche IP in einer Zeile, die JSON-, Länder- und ASN-Endpunkte, ein Speedtest im Terminal und die Nutzung unter Windows.

IP-DB-Team 11 Min. Lesezeit 118× gelesen 0 Kommentare Aktualisiert

Sie sind per SSH auf einem Server und müssen wissen, mit welcher Adresse diese Maschine nach außen geht. Oder Sie sitzen in einem Docker-Container, auf einem CI-Runner, in einem Netz hinter NAT. Überall dort, wo kein Browser zur Verfügung steht, genügt eine einzige Zeile:

curl ip-db.com/me

Zurück kommt genau eine Zeile — außer dem abschließenden Zeilenumbruch keinerlei Beiwerk, direkt einer Variablen zuweisbar oder in eine Pipe zu geben:

Beispielausgabe
77.245.159.39

Das ist nicht die lokale Schnittstellenadresse Ihres Rechners. ip addr zeigt Ihnen meist eine Adresse aus einem privaten Bereich wie 192.168.1.20; was Server von Ihnen sehen, ist die Adresse des NAT oder des VPN-Ausgangs. Den Unterschied und die Vergabe von Adressen behandelt der Beitrag Was ist eine IP-Adresse.

Vier Endpunkte

Alle arbeiten ohne Sprachpräfix, denn das Publikum ist keine Leserin, sondern eine Shell:

EndpunktRückgabeFormat
/meÖffentliche IP-AdresseKlartext
/me.jsonAdresse + Land, Stadt, ASN, Netztyp, ReputationswertJSON
/me/countryISO-LändercodeKlartext
/me/asnASN-Nummer und BetreibernameKlartext
Beispielausgaben
$ curl ip-db.com/me/country TR $ curl ip-db.com/me/asn AS42868 Niobe Bilisim Ltd. Sti. $ curl ip-db.com/me.json { "ip": "77.245.159.39", "version": 4, "isPrivate": false, "countryCode": "TR", "countryName": "Turkey", "city": "Pendik", "asn": 42868, "asnOrg": "Niobe Bilisim Ltd. Sti.", "asnDomain": "trdns.com", "networkType": "residential", "abuseConfidenceScore": 0 }

/me.json reichert ausschließlich aus lokalen Datenbanken an — keine Wartezeit für RDAP oder DNSBL. Deshalb bleibt der Aufruf schnell genug, um in der Schleife eines Monitoring-Skripts zu stehen. Wie das Feld networkType zustande kommt, steht im Beitrag zur VPN-, Proxy- und Tor-Erkennung, die Herleitung von abuseConfidenceScore im Beitrag zum Reputationswert.

Markdown-Ausgabe mit jq

Der eigentliche Nutzen von JSON liegt darin, es in jedes gewünschte Format zu überführen. Eine Markdown-Tabelle, die sich in ein Ticket, einen Pull Request oder ein Runbook einfügen lässt:

curl -s ip-db.com/me.json | jq -r ' "| Feld | Wert |", "| --- | --- |", "| IP | `\(.ip)` |", "| Land | \(.countryName) (\(.countryCode)) |", "| Stadt | \(.city // "—") |", "| ASN | AS\(.asn) — \(.asnOrg) |", "| Netztyp | \(.networkType) |", "| Missbrauch | \(.abuseConfidenceScore)/100 |"'
Erzeugtes Markdown
| Feld | Wert | | --- | --- | | IP | `77.245.159.39` | | Land | Turkey (TR) | | Stadt | Pendik | | ASN | AS42868 — Niobe Bilisim Ltd. Sti. | | Netztyp | residential | | Missbrauch | 0/100 |

Wenn eine einzeilige Zusammenfassung genügt:

curl -s ip-db.com/me.json \ | jq -r '"\(.ip) — \(.countryCode) — AS\(.asn) \(.asnOrg) — \(.networkType)"' # 77.245.159.39 — TR — AS42868 Niobe Bilisim Ltd. Sti. — residential

Geschwindigkeitstest im Terminal

Dieselbe Endpunktfamilie nennt nicht nur Ihre Adresse, sie misst auch Ihre Leitung. Auf einem Server ohne Browser, in einem Container oder auf einer per SSH erreichten Maschine liefert eine einzige Zeile Download, Upload und Latenz:

curl -s ip-db.com/me/speed.sh | sh
Beispielausgabe
ip-db.com terminal speed test ---------------------------------------------- address 77.245.159.39 location Pendik, Turkey network AS42868 Niobe Bilisim Ltd. Sti. measured against Cloudflare latency ################################ 40.0 ms download ################################ 310.1 Mbit/s upload ################################ 674.3 Mbit/s ---------------------------------------------- download 310.1 Mbit/s upload 674.3 Mbit/s latency 40.0 ms

Die Daten fließen zwischen Ihnen und den öffentlichen Speed-Endpunkten von Cloudflare, nicht zwischen Ihnen und ip-db.com. Dafür gibt es zwei Gründe. Erstens Ehrlichkeit: Eine gegen einen geteilten Host gemessene Rate beschreibt den Weg zu diesem Host, nicht Ihre Verbindung. Zweitens Kosten: Ginge jeder Test auf unsere Bandbreite, könnte er nicht kostenlos bleiben. Von uns kommt allein das rund 10 KB große Skript.

Das Skript nimmt fünf Latenzproben, lädt dann 1, 10 und 25 MB große Blöcke herunter und sendet 2, 10 und 26 MB große Körper zurück. Der jeweils erste Block ist ein Aufwärmlauf und geht nie ins Ergebnis ein: TCP Slow Start allein kann etwa die Hälfte der tatsächlichen Rate melden. Leitungen unter 50 Mbit/s überspringen die großen Blöcke, damit sich der Test auf langsamen Anschlüssen nicht hinzieht. Der ganze Lauf dauert etwa zehn Sekunden.

Wer das Skript vor dem Ausführen lesen möchte, teilt den Befehl in zwei:

curl -s ip-db.com/me/speed.sh -o speed.sh less speed.sh && sh speed.sh

curl ip-db.com/me/speed liefert lesbaren Text — Ihre Adresse und die Startanweisung — statt Shell-Quelltext. Zwei Adressen sind nötig, weil der Server curl URL nicht von curl URL | sh unterscheiden kann: Beide senden exakt dieselbe Anfrage.

Verwendung unter Windows

Windows liefert seit 10 1803 curl.exe mit dem Betriebssystem aus, das Abrufen funktioniert also einwandfrei. Es fehlt sh: Weder cmd.exe noch PowerShell ist eine POSIX-Shell, die rechte Seite der Pipe hat somit nichts, was sie ausführt. Die Lösung besteht darin, den Befehl an eine bereits vorhandene POSIX-Shell zu übergeben:

UmgebungBefehl
Innerhalb von WSL oder Git Bashcurl -s ip-db.com/me/speed.sh | sh
cmd / PowerShell, WSL installiertwsl sh -c "curl -s https://ip-db.com/me/speed.sh | sh"
cmd / PowerShell, Git installiertbash -c "curl -s https://ip-db.com/me/speed.sh | sh"
Überall, nur Informationcurl ip-db.com/me/speed

Die Anführungszeichen sind wichtig: Bleibt die Pipe in doppelten Anführungszeichen, beansprucht cmd sie nicht für sich und sie erreicht WSL oder bash unverändert. Ohne sie führt cmd die Pipe selbst aus und der Befehl zerfällt.

In PowerShell lauert eine weitere Falle. In PowerShell 5.1, der von Windows mitgelieferten Fassung, ist curl nicht curl.exe, sondern ein Alias für Invoke-WebRequest, das -s nicht kennt. Rufen Sie das echte Programm dort mit vollem Namen auf: curl.exe. PowerShell 7 hat den Alias entfernt, dort startet curl direkt curl.exe.

Ist weder WSL noch Git installiert, lässt sich der Test unter Windows nicht ausführen; die Informationsausgabe von curl ip-db.com/me/speed bekommen Sie trotzdem. Diese Ausgabe ist reines ASCII und wird daher unabhängig von der aktiven Codepage sauber dargestellt.

Rezepte für die Praxis

Adresse in eine Variable übernehmen

MYIP=$(curl -fsS --max-time 5 ip-db.com/me) echo "Diese Maschine geht mit $MYIP nach außen"

-f sorgt dafür, dass curl bei einem HTTP-Fehler einen Exit-Code ungleich null liefert, -sS unterdrückt die Fortschrittsanzeige und zeigt Fehler weiterhin an, und --max-time verhindert, dass Ihr Skript bei hängendem Netz endlos wartet. Alle drei gehören in jedes curl innerhalb eines Skripts.

IPv4 und IPv6 getrennt betrachten

Auf einer Dual-Stack-Maschine bestimmen Sie selbst, welche Familie curl verwendet:

curl -4 -s ip-db.com/me # IPv4-Ausgang curl -6 -s ip-db.com/me # IPv6-Ausgang

Unterschiedliche Ergebnisse sind normal: IPv6-Verkehr läuft häufig ohne NAT direkt hinaus. Schlägt der -6-Aufruf fehl, hat Ihre Maschine keinen funktionierenden IPv6-Pfad — bei der Diagnose eines Verbindungsproblems ist allein das schon eine wertvolle Auskunft.

Arbeitet das VPN wirklich?

Dass ein VPN als verbunden angezeigt wird, heißt nicht, dass es Ihren Verkehr auch trägt. Der Vergleich zeigt es in einer Sekunde:

curl -s ip-db.com/me.json | jq -r '"\(.ip) \(.countryCode) \(.networkType)"' # VPN aus: 77.245.159.39 TR residential # VPN an: 45.132.xxx.xxx NL datacenter

Dass networkType dann datacenter oder vpn lautet, ist das erwartete Ergebnis — kommerzielle VPNs mieten ihre Ausgangskapazität fast immer bei einem Hosting-Anbieter. Steht dort weiterhin residential, verlässt Ihr Verkehr die Maschine am Tunnel vorbei.

Benachrichtigung bei Adresswechsel

Für einen Server hinter einem Anschluss mit dynamischer IP ein kleiner Cron-Job, der den Wechsel bemerkt:

#!/bin/sh # /usr/local/bin/ip-watch.sh STATE=/var/lib/ip-watch.last NEW=$(curl -fsS --max-time 10 ip-db.com/me) || exit 0 OLD=$(cat $STATE 2>/dev/null) if [ "$NEW" != "$OLD" ]; then echo "$NEW" > $STATE [ -n "$OLD" ] && logger -t ip-watch "Adresse geaendert: $OLD -> $NEW" fi
*/5 * * * * /usr/local/bin/ip-watch.sh

Zwei Details sind wichtig. || exit 0 verhindert, dass eine kurze Netzstörung die Zustandsdatei überschreibt. Beim ersten Lauf ist $OLD leer, deshalb wird nichts gemeldet — sonst erzeugte jede Neuinstallation einen falschen Alarm über einen angeblichen Adresswechsel.

Die eigene Adresse in eine Firewall-Regel eintragen

Wenn Sie von einem Anschluss mit wechselnder Adresse auf eine Verwaltungsoberfläche zugreifen:

MYIP=$(curl -fsS --max-time 5 ip-db.com/me) ssh admin@server "ufw allow from $MYIP to any port 22"

Wenn Sie das automatisieren, denken Sie daran, die alte Regel zu löschen; sonst bleiben mit der Zeit Dutzende Adressen freigeschaltet, die längst nicht mehr Ihnen gehören — und die Lücke, die Sie schließen wollten, wird größer statt kleiner.

Browser oder Shell? Die Antwort richtet sich nach dem Aufrufer

Dieselbe Adresse verhält sich unterschiedlich, je nachdem wer fragt. Ruft ein Browser /me auf, wird er auf die Seite Wie ist meine IP weitergeleitet; curl bekommt Klartext. Unterschieden wird über den Accept-Header: Browser führen text/html namentlich auf, curl sendet lediglich */*.

Die Feinheit liegt darin, dass ein Platzhalter */* technisch gesehen auf text/html passt. Die fertigen „will HTML"-Hilfsfunktionen der Bibliotheken antworten deshalb auch für curl mit Ja und schicken jede Shell auf die HTML-Seite — also genau verkehrt herum. Der richtige Test prüft, ob text/html im Header namentlich vorkommt.

Unterschied zu anderen Diensten

Reine IPJSONASN + NetztypReputationswert
Klassische Echo-Dienstejameist neinneinnein
ip-db.com/mejajajaja

Der Unterschied: Ein einziger Aufruf sagt Ihnen nicht nur „das ist Ihre Adresse", sondern auch, in welchem Netz diese Adresse steht — Rechenzentrum, Privatanschluss, bekannter Tor-Ausgang — und ob sie in unseren Quelllisten auftaucht. Wollen Sie statt der eigenen eine andere Adresse abfragen, hilft die API-Dokumentation.

Beim Schreiben von Skripten

  • Setzen Sie ein Timeout. Ohne --max-time hält eine hängende Anfrage auch den aufrufenden Cron-Job an.
  • Behandeln Sie Fehler. Mit -f liefert curl bei HTTP-Fehlern einen Exit-Code ungleich null; fangen Sie ihn mit || ab.
  • Prüfen Sie die Ausgabe. Schreiben Sie kein HTML in Ihre Konfiguration, wo Sie eine Adresse erwarten: case "$MYIP" in *[!0-9.]*) exit 1 ;; esac genügt als Kontrolle.
  • Halten Sie das Ergebnis eine Weile vor. Die Adresse ändert sich nicht im Sekundentakt; bei jedem Befehl neu zu fragen, kostet nur Latenz.

Erwähnt sei noch, dass die Endpunkte mit X-Robots-Tag: noindex antworten: Sie sind für die Kommandozeile gedacht, nicht für den Suchmaschinenindex.

Häufige Fragen

Warum funktioniert curl ip-db.com/me auch ohne https://?

Ohne Schema verbindet sich curl auf Port 80, also über einfaches HTTP. Der Rest der Website leitet solche Anfragen per 301 auf HTTPS um, und curl folgt Weiterleitungen nur mit -L — statt einer Adresse bekommen Sie sonst einen HTML-Rumpf. Deshalb sind allein die /me-Pfade von der HTTPS-Erzwingung ausgenommen. Ein Datenschutzproblem entsteht dadurch nicht: Die Antwort ist die eigene Adresse des Aufrufers, die jeder Hop auf dem Weg ohnehin aus den Paket-Headern gelesen hat.

Warum weicht die Antwort von meiner lokalen Adresse ab?

Es sind zwei verschiedene Adressen. ipconfig beziehungsweise ip addr zeigt die lokale Schnittstellenadresse Ihres Rechners, meist aus einem privaten Bereich wie 192.168.x.x. /me liefert die öffentliche Adresse, mit der die Anfrage ins Internet gegangen ist — die Adresse Ihres NAT, Ihres Firmen-Gateways oder Ihres VPN-Ausgangs. Genau diese sehen Server von Ihnen.

Wird die Antwort zwischengespeichert?

Nein, und zwar bewusst nicht. Die Endpunkte antworten mit no-store, no-cache, must-revalidate und Vary: Accept. Würde ein zwischengeschalteter Cache die Antwort des einen Besuchers speichern und dem nächsten ausliefern, wäre das schlimmer als gar keine Antwort — er würde reihum fremde Adressen verteilen.

Wie oft darf ich das in Skripten aufrufen?

Für die Überwachung eines Adresswechsels genügen wenige Minuten Abstand bei Weitem; an Privatanschlüssen bleibt die Adresse oft tagelang gleich. Ein Aufruf pro Sekunde liefert keine neuen Informationen. Für dauerhafte, intensive Nutzung nehmen Sie die API-Endpunkte, deren Identität am Schlüssel hängt und deren Limits klar dokumentiert sind.

Wie führe ich den curl-Speedtest unter Windows aus?

Weder cmd.exe noch PowerShell ist eine POSIX-Shell, das sh rechts der Pipe gibt es unter Windows also nicht. Ist WSL installiert, übergeben Sie den Befehl mit wsl sh -c in Anführungszeichen; ist Git installiert, genauso mit bash -c. Innerhalb von WSL oder Git Bash funktioniert der Befehl unverändert. Beachten Sie außerdem, dass curl in PowerShell 5.1 ein Alias für Invoke-WebRequest ist und -s nicht kennt; rufen Sie das Programm dort mit vollem Namen curl.exe auf.

Wenn Sie lieber im Browser nachsehen, zeigt die Seite Wie ist meine IP dieselben Daten visuell. Für eine andere Adresse nutzen Sie die Abfrageseite, für den Massenbetrieb die API-Dokumentation.

Teilen

Kommentare 0

Teile eine Frage, Erfahrung oder Korrektur — registriert oder anonym.

Noch keine Kommentare. Schreib den ersten.

Nur Text, keine Links. Kommentare erscheinen sofort und können moderiert werden. Anmelden, um registriert zu kommentieren