
Ferramenta de segurança para rastrear saltos de URL através dos links rel para obter a última URL
O Hoper mostra cada salto (redirecionamento) pelo qual uma URL passa até chegar ao seu destino final — útil para encurtadores de URL, links de rastreamento em e-mails, fluxos de SSO ou depuração de regras de redirecionamento.
$ 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 por padrão (sem download do corpo) com fallback automático para GET em servidores que o rejeitam.HTTP_PROXY / HTTPS_PROXY / NO_PROXY e NO_COLOR.Requer Ruby 3.1 ou mais recente.
gem install hoper
No Windows, instale o Ruby com o RubyInstaller e depois execute o mesmo comando.
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
Se o esquema for omitido, assume-se https:// (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 }
]
}
Com várias URLs, a saída é um array.
| Código | Significado |
|---|---|
| 0 | Todas as URLs resolveram para uma resposta final sem erro (< 400) |
| 1 | Pelo menos uma URL falhou (erro de rede, loop, demasiados saltos, 4xx/5xx) |
| 2 | Uso/opções inválidos |
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
O CI executa a suíte de testes em Ubuntu, macOS e Windows (Ruby 4.0), além da versão mais antiga do Ruby suportada (3.1) no Ubuntu. Os testes usam um servidor HTTP local em processo, portanto não precisam de acesso à rede.
Os lançamentos são automatizados com GitHub Actions e RubyGems Trusted Publishing:
Atualize lib/hoper/version.rb e adicione uma seção ao CHANGELOG.md; faça merge para master.
Crie a tag e faça push:
git tag v1.2.3 && git push origin v1.2.3
O workflow Release verifica se a tag corresponde à versão, executa os testes, publica a gem
no RubyGems.org e cria um GitHub Release com as notas do CHANGELOG.
Relatórios de bugs e pull requests são bem-vindos no GitHub em https://github.com/gabamnml/hoper. Este projeto tem como objetivo ser um espaço seguro e acolhedor para colaboração, e espera-se que os contribuidores sigam o Código de Conduta do Contributor Covenant.
A gem está disponível como código aberto sob os termos da Licença MIT.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.