Guia · curl

Usando um proxy com curl

O curl é a maneira mais rápida de verificar se um proxy está funcionando, independentemente de qualquer navegador ou extensão. O comando curl vem integrado ao Linux, macOS e Windows 10, 11. Este guia traz exemplos de comandos, como interpretar a saída para solucionar erros e como definir um proxy padrão para todos os comandos.

Autor: Bùi Toàn · Atualizado: 19/11/2026

Comandos básicos

  • A partir do formato ip:porta:usuario:senha, execute: curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • Ou combine em uma única string: curl -x http://user:pass@IP:PORT https://api.ipify.org
  • A saída deve ser o IP do proxy. Se você vir o IP do seu ISP, significa que a requisição não passou pelo proxy.
  • Para verificar também o país: substitua o URL de destino por https://ipinfo.io/json.
  • Se o proxy operar no modo SOCKS5 ou HTTP + SOCKS5: curl -x socks5h://user:pass@IP:PORT https://api.ipify.org (o socks5h permite que o proxy resolva nomes de domínio) ou curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org.

No Windows

No PowerShell 5.1, "curl" é um alias para Invoke-WebRequest, e não o curl real. Use curl.exe em vez de curl: curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org. No Prompt de Comando (cmd) e no PowerShell 7 ou superior, curl é o curl real.

Como usar o curl com caracteres especiais na senha do proxy?

Ao usar o formato user:pass@IP, caracteres especiais como @ : / # % na senha devem ser codificados em URL (URL-encoded) — por exemplo, @ vira %40 e # vira %23. Usar -U "user:pass" (entre aspas duplas) não exige codificação e reduz erros. No Linux e macOS, use aspas simples se a senha contiver $ ou !.

Como ler a saída do curl para diagnosticar erros de proxy?

Adicione -v para inspecionar cada etapa: a linha "200 Connection established" indica que o proxy aceitou a conexão, enquanto as mensagens de erro abaixo revelam se o problema está nas credenciais, portas, rede ou no site de destino.

Adicione -v para detalhes completos

Para sites HTTPS, o curl envia uma requisição CONNECT para o proxy. A linha "< HTTP/1.1 200 Connection established" indica que o proxy aceitou a conexão. A linha "407 Proxy Authentication Required" indica nome de usuário ou senha incorretos.

Failed to connect … Connection refused

A conexão com o IP:porta foi recusada imediatamente: porta incorreta, proxy expirado ou inativo. Consulte o guia sobre erros de conexão recusada.

Connection timed out

Nenhuma resposta recebida: IP incorreto, problemas de rede ou firewall bloqueando a porta. Adicione --connect-timeout 10 para evitar esperar demais.

CONNECT tunnel failed, response 502 or 503

O proxy está em execução, mas falhou ao estabelecer conexão com o site de destino. Tente outro site para determinar se o problema está no site de destino ou no proxy.

Definir um proxy padrão

Configure variáveis de ambiente para que todos os comandos curl (e muitas outras ferramentas) usem o proxy automaticamente: export https_proxy="http://user:pass@IP:PORT" e export http_proxy="$https_proxy" no Linux e macOS. Ignore o proxy para um comando específico usando --noproxy "*". Como alternativa, adicione a linha proxy = "http://user:pass@IP:PORT" ao seu arquivo ~/.curlrc.

Ainda não tem proxy? Compre proxies dedicados com ativação automática

Proxies IPv4 dedicados em 9 países a partir de 20.000₫/IP/mês na compra a partir de 2.000 IPs (39.000₫ para 1 IP), além de proxies ISP estáticos no Vietnã e nos EUA. HTTP(S) e SOCKS5 com usuário e senha, largura de banda ilimitada, ativados automaticamente após o pagamento. No momento, os proxies do Vietnã usam o protocolo HTTP(S); o SOCKS5 ainda não está disponível.

Comprar proxies agora

Perguntas Frequentes

Por que o valor de https_proxy ainda começa com http://?+

O prefixo especifica como o curl se conecta ao proxy, e não ao site de destino. Ao se comunicar com o proxy da ONET via HTTP, sites HTTPS ainda podem ser acessados pelo método CONNECT. Com SOCKS5, o valor começa com socks5h://.

Posso usar --socks5 com proxies da ONET?+

Sim, quando o proxy estiver operando no modo SOCKS5 ou HTTP + SOCKS5: curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org ou -x socks5h://user:pass@IP:PORT. Use socks5h ou --socks5-hostname para que os nomes de domínio sejam resolvidos do lado do proxy. Observe que, no momento, os proxies do Vietnã usam apenas o protocolo HTTP(S); o SOCKS5 ainda não está disponível.