Um proxy SOCKS5 com cURL é a forma mais rápida de levar uma requisição HTTP por um túnel, e a sintaxe testada em uma linha continua válida em scripts de produção por anos. O cURL fala SOCKS5 nativamente, então você não precisa de biblioteca wrapper nem extensão de navegador só para conferir se um endpoint está vivo.

O tropeço não é a flag, é o DNS. O cURL tem dois esquemas quase idênticos, socks5:// e socks5h://, e só um deles mantém sua localização real fora da requisição. O resto é encanamento: credenciais codificadas, variáveis de ambiente, timeouts e uma verificação antes do trabalho de verdade.

Por que usar cURL via SOCKS5 em vez de proxy HTTP

  • Independência de protocolo. Um túnel carrega API, SMTP, IMAP, SSH e WebSocket; o proxy HTTP só entende HTTP.
  • DNS remoto com socks5h. O proxy resolve o hostname, então nem o provedor nem o destino veem consulta DNS da sua rede real.
  • Autenticação por conexão. Usuário e senha são negociados no handshake SOCKS, não em um header que o servidor de destino pode registrar.
  • Nenhum header injetado. Proxies HTTP acrescentam X-Forwarded-For ou Via; o SOCKS5 repassa os bytes sem alteração.

Cinco verificações antes da primeira requisição

  1. Escolha o esquema de propósito: socks5h para alvos públicos, socks5 só para hosts internos.
  2. Confirme host e porta — 1080 é o padrão, mas provedores usam 1081, 8080 ou gateway rotativo.
  3. Codifique as credenciais: @ vira %40, : vira %3A, / vira %2F.
  4. Defina --connect-timeout 10 e --max-time 60 para falhar rápido em endpoint morto.
  5. Verifique o IP de saída em https://api.ipify.org antes de qualquer tarefa real.

Comparação das flags

  • -x socks5h://host:port — DNS resolvido pelo proxy, escolha padrão.
  • -x socks5://host:port — DNS local, apenas para alvos internos.
  • --socks5-hostname host:port — forma longa do socks5h para argumentos montados em script.
  • --preproxy socks5h://… — encadeia um proxy HTTP na frente da saída SOCKS5.

Configuração em quatro passos

  1. Coloque as credenciais em variáveis de ambiente, fora do histórico do shell.
  2. Monte a URL: socks5h://user:p%40ss@host:1080.
  3. Verifique o IP de saída com curl -sS -x "$PROXY" https://api.ipify.org.
  4. Rode a requisição real com -v para ler o handshake e depois adicione retries e timeouts.

FAQ

Qual a diferença entre socks5 e socks5h?

socks5 resolve o nome localmente e envia o IP pelo túnel, o que pode vazar sua localização; socks5h entrega o hostname e deixa o proxy resolver. Para alvos públicos, use sempre socks5h.

Por que aparecem erros de tunnel ou connection refused?

Quase sempre porta errada, caractere não codificado nas credenciais ou socks5 onde a forma hostname é exigida. Com -v você vê onde o handshake para.

Configure a flag uma vez e confira o IP de saída em cada execução: o cURL com SOCKS5 se torna o comando mais confiável da sua caixa de ferramentas. Pegue um endpoint em FTProxy residential proxies.