Usando cURL com proxy autenticado: comandos que comprovam o funcionamento
Pela equipe de engenharia da ProxyV4 · Updated:
Para usar o cURL com proxy, informe o endereço do proxy com -x e seu login com -U, ou coloque ambos em uma única URL http://user:pass@ip:port. Antes de configurar um IP da ProxyV4 em um scraper, perfil de navegador ou tarefa cron, uma chamada cURL a partir da mesma máquina revela três coisas rapidamente: as credenciais foram aceitas, o IP de saída é o que você alugou e o tempo de resposta é razoável.
curl -x http://user:pass@ip:port https://proxyv4.com/api/my-ip- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
Da linha do painel ao argumento do cURL
Seu pedido é entregue no formato ip:port:user:pass. O cURL não lê esse formato diretamente, então separe-o: os dois primeiros campos vão em -x http://ip:port e os dois últimos em -U user:pass. O formato de URL única http://user:pass@ip:port é mais curto, mas qualquer @, : ou # na senha precisará ser codificado em percent-encoding, motivo pelo qual a forma separada é o padrão mais seguro em scripts.
Mantenha o esquema http:// no proxy mesmo quando o destino for https://. O cURL comunica-se em HTTP puro com o proxy, solicita a abertura de um túnel com CONNECT e executa o TLS com o site através desse túnel, garantindo que a página em si permaneça criptografada de ponta a ponta.
Referência de comandos
| Objetivo | Comando | Como interpretar o resultado |
|---|---|---|
| Ver qual IP a internet visualiza | curl -x http://user:pass@ip:port https://proxyv4.com/api/my-ip | O endereço exibido deve ser igual ao IP do proxy, não ao seu |
| Informar o login separadamente | curl -x http://ip:port -U "user:pass" https://proxyv4.com/api/my-ip | Mesmo resultado; dispensa codificação de URL para caracteres especiais na senha |
| Apenas linha de status e cabeçalhos | curl -I -x http://user:pass@ip:port https://example.com | Uma linha 2xx ou 3xx indica que o destino respondeu através do proxy |
| Tempo de conexão e tempo até o primeiro byte (TTFB) | curl -s -o /dev/null -w "Connect:%{time_connect}s TTFB:%{time_starttransfer}s\n" -x http://user:pass@ip:port https://example.com | Dois valores em segundos; compare-os entre diferentes proxies ou localizações |
Depurando uma requisição com falha usando -v
Adicione -v e leia as linhas que começam com > e <. Uma execução correta mostra o cURL enviando CONNECT com o cabeçalho Proxy-Authorization e o proxy respondendo HTTP/1.1 200 Connection established, seguido pelo handshake TLS com o destino.
Se a resposta for HTTP/1.1 407 Proxy Authentication Required, a conexão com o proxy funcionou e apenas o usuário ou a senha está incorreto; o guia do erro 407 detalha as causas comuns. Se o cURL não receber resposta alguma, o problema é de conectividade; nesse caso, verifique primeiro o IP e a porta com o verificador de portas.
Para ver um mapeamento rápido dos códigos de saída do curl e suas causas, bem como as mesmas verificações para Docker, Selenium e Puppeteer, consulte proxy não está funcionando.
Windows, scripts e padrões
- O Windows PowerShell associa
curlaInvoke-WebRequest, que não reconhece-x; digitecurl.exepara acessar o binário real - No Windows, substitua
-o /dev/nullpor-o NULno comando de medição de tempo - Em tarefas cron e scripts shell, adicione
--connect-timeout 5 --max-time 15para que um destino lento não trave toda a execução - Para rotear todas as chamadas cURL pelo mesmo proxy, adicione
proxy = "http://user:pass@ip:port"em~/.curlrce remova-o quando concluir os testes
Passo a passo
- 1
Abra um terminal
Use o Terminal no macOS ou Linux, ou cmd / PowerShell no Windows (onde o comando é
curl.exe). - 2
Consulte seu IP de saída através do proxy
Execute
curl.exe -x http://user:pass@ip:port https://proxyv4.com/api/my-ipcom os dados do seu pedido na ProxyV4 e verifique se o endereço exibido corresponde ao IP do proxy. - 3
Analise o handshake em caso de falha
Repita a chamada com
-ve localize a resposta do proxy aoCONNECT: 200 significa que o túnel foi aberto; 407 indica que o login foi recusado. - 4
Prepare o comando para automação
Antes de incluir a linha em um script, adicione
--connect-timeout 5 --max-time 15.
Perguntas frequentes
Por que o PowerShell rejeita curl -x com um erro de parâmetro?
No PowerShell, curl é um alias para Invoke-WebRequest, que não possui a opção -x. Execute curl.exe -x http://user:pass@ip:port ... e o Windows chamará o cURL nativo.
O cURL exibe 407 Proxy Authentication Required. O proxy está fora do ar?
Não. O 407 é uma resposta do próprio proxy, indicando que o IP e a porta estão acessíveis. O usuário ou a senha informados em -x ou -U não coincidem; copie-os novamente do pedido e atente-se a caracteres especiais na senha.
Preciso criar um loop no cURL para testar uma lista inteira de proxies?
Não para uma verificação rápida. O verificador de proxies online aceita até 100 proxies simultaneamente e não armazena senhas, enquanto o teste de velocidade de proxy compara a latência sem a necessidade de scripts.
Fontes
IPv4 privado aprovado no teste de cURL
Um cliente por IP, tráfego ilimitado, HTTP(S) com usuário e senha, em 7 países. Confira os preços em tempo real.
Ver preços de proxies em tempo real