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
- Escolha o esquema de propósito: socks5h para alvos públicos, socks5 só para hosts internos.
- Confirme host e porta — 1080 é o padrão, mas provedores usam 1081, 8080 ou gateway rotativo.
- Codifique as credenciais: @ vira %40, : vira %3A, / vira %2F.
- Defina
--connect-timeout 10e--max-time 60para falhar rápido em endpoint morto. - 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
- Coloque as credenciais em variáveis de ambiente, fora do histórico do shell.
- Monte a URL:
socks5h://user:p%40ss@host:1080. - Verifique o IP de saída com
curl -sS -x "$PROXY" https://api.ipify.org. - Rode a requisição real com
-vpara 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.