
Sicherheitstool, um URL-Sprünge über die rel-Links zu verfolgen und die letzte URL zu erhalten.
Hoper zeigt jeden Hop (Weiterleitung), den eine URL durchläuft, bis sie ihr endgültiges Ziel erreicht – nützlich für URL-Shortener, Tracking-Links in E-Mails, SSO-Abläufe oder zum Debuggen von Weiterleitungsregeln.
$ hoper http://github.com
Tracing http://github.com
1. → 301 Moved Permanently http://github.com/ 81ms
2. ✔ 200 OK https://github.com/ 50ms
1 redirect → https://github.com/
HEAD (keine Body-Downloads) mit automatischem Fallback auf GET für Server, die dies ablehnen.HTTP_PROXY / HTTPS_PROXY / NO_PROXY und NO_COLOR.Erfordert Ruby 3.1 oder neuer.
gem install hoper
Unter Windows installieren Sie Ruby mit RubyInstaller und führen dann denselben Befehl aus.
hoper [options] URL [URL...]
-m, --max-hops N Maximum redirects to follow (default: 20)
-t, --timeout SECONDS Timeout per request (default: 10)
-X, --method METHOD HTTP method: HEAD or GET (default: HEAD)
-A, --user-agent UA User-Agent header to send
-H, --header 'NAME: VALUE' Extra request header (repeatable)
-k, --insecure Do not verify TLS certificates
-j, --json Output results as JSON
--[no-]color Force/disable colored output
-v, --version Print version and exit
-h, --help Show this help
Wenn das Schema weggelassen wird, wird https:// angenommen (hoper example.com).
hoper --json http://github.com
{
"start_url": "http://github.com/",
"final_url": "https://github.com/",
"final_status": 200,
"redirects": 1,
"hops": [
{ "url": "http://github.com/", "status": 301, "reason": "Moved Permanently", "location": "https://github.com/", "duration_ms": 81 },
{ "url": "https://github.com/", "status": 200, "reason": "OK", "duration_ms": 50 }
]
}
Bei mehreren URLs ist die Ausgabe ein Array.
| Code | Bedeutung |
|---|---|
| 0 | Jede URL wurde zu einer fehlerfreien (< 400) finalen Antwort aufgelöst |
| 1 | Mindestens eine URL ist fehlgeschlagen (Netzwerkfehler, Schleife, zu viele Hops, 4xx/5xx) |
| 2 | Ungültige Verwendung / Optionen |
require "hoper"
result = Hoper.trace("https://bit.ly/example", max_hops: 10)
result.hops.each { |hop| puts "#{hop.status} #{hop.url}" }
result.final_url # => "https://example.com/"
result.success? # => true
bundle install
bundle exec rake test
CI führt die Testsuite auf Ubuntu, macOS und Windows (Ruby 4.0) aus, sowie die älteste unterstützte Ruby-Version (3.1) auf Ubuntu. Die Tests verwenden einen lokalen In-Process-HTTP-Server, sodass sie keinen Netzwerkzugriff benötigen.
Veröffentlichungen werden mit GitHub Actions und RubyGems Trusted Publishing automatisiert:
Erhöhe die Version in lib/hoper/version.rb und füge einen Abschnitt zu CHANGELOG.md hinzu; führe einen Merge nach master durch.
Tag erstellen und pushen:
git tag v1.2.3 && git push origin v1.2.3
Der Release-Workflow prüft, ob das Tag mit der Version übereinstimmt, führt die Tests aus, veröffentlicht das Gem auf RubyGems.org und erstellt ein GitHub Release mit den CHANGELOG-Notizen.
Fehlerberichte und Pull Requests sind auf GitHub unter https://github.com/gabamnml/hoper willkommen. Dieses Projekt soll ein sicherer, einladender Ort für Zusammenarbeit sein, und von Mitwirkenden wird erwartet, dass sie den Contributor Covenant Verhaltenskodex einhalten.
Das Gem ist als Open Source unter den Bedingungen der MIT License verfügbar.