# curl proxy: HTTP, SOCKS5 e variáveis de ambiente | ProxyJam

curl proxy: passe o curl por um proxy HTTP ou SOCKS5 com -x e -U, use variáveis de ambiente e codifique caracteres especiais na senha.

- Canonical: https://proxyjam.com/pt/faq/curl-proxy/
- Updated: 2026-11-22
- Language: pt

Use curl -x http://HOST:PORT -U LOGIN:PASSWORD URL para um proxy HTTP e socks5h://HOST:PORT para SOCKS5. A opção -U recebe a senha exatamente como você a digita. Defina http_proxy, https_proxy ou all_proxy para cobrir todo o shell e codifique com porcentagem os caracteres especiais quando o login estiver dentro da URL.


## Respostas rápidas sobre curl e proxies

### Por que socks5h e não socks5?

Com socks5h, o curl envia o nome do host ao proxy para que ele o resolva; com socks5, o curl o resolve localmente antes. Use socks5h, a menos que você precise da consulta DNS local.

### Preciso manter http:// no endereço do proxy para sites HTTPS?

Sim. O esquema indica como o curl fala com o proxy, não com o site. Um proxy HTTP transporta páginas HTTPS por meio de um túnel.

### O que significa um 407 no curl?

O proxy rejeitou o login ou o seu endereço. Copie os dados de novo do painel e confira a lista de IPs permitidos.



O curl é a forma mais rápida de testar um proxy e funciona igual no macOS, no Linux e no
Windows. Substitua os quatro marcadores pelos valores de uma linha em **Meus Proxies** no
seu [painel](https://app.proxyjam.com).

## Proxy HTTP

```
curl -x http://HOST:PORT -U LOGIN:PASSWORD https://example.com/
```

`-x` (forma longa `--proxy`) define o proxy e `-U` (`--proxy-user`) define o login. A
senha em `-U` é usada como foi digitada, então não precisa de codificação ali. Mantenha
`http://` no endereço do proxy mesmo quando a página usa HTTPS: o esquema indica como o
curl fala com o proxy. Acrescente `-I` para exibir só os cabeçalhos, ou `-v` para
acompanhar a abertura do túnel.

## Proxy SOCKS5

Primeiro, mude o pedido para SOCKS5 com **Alterar protocolo** e copie os dados de novo. Depois:

```
curl -x socks5h://HOST:PORT -U LOGIN:PASSWORD https://example.com/
```

O `h` faz o proxy resolver o nome do host. A opção mais antiga `--socks5-hostname
HOST:PORT` faz o mesmo. A nossa página de [proxies SOCKS5](/pt/socks5-proxies/) descreve
o protocolo.

## Credenciais dentro da URL

Você também pode escrever o login no próprio endereço do proxy:

```
curl -x http://LOGIN:PASSWORD@HOST:PORT https://example.com/
```

Nesse caso, os caracteres que têm significado em uma URL precisam ser codificados com
porcentagem: `@` vira `%40`, `:` vira `%3A`, `/` vira `%2F`, `#` vira `%23` e `%` vira
`%25`. Uma senha sem codificação é cortada no primeiro desses caracteres, e o proxy
responde 407.

## Variáveis de ambiente

Para cobrir todos os comandos curl do shell atual:

```
export http_proxy="http://LOGIN:PASSWORD@HOST:PORT"
export https_proxy="http://LOGIN:PASSWORD@HOST:PORT"
```

No PowerShell, o equivalente é:

```
$env:http_proxy = "http://LOGIN:PASSWORD@HOST:PORT"
$env:https_proxy = "http://LOGIN:PASSWORD@HOST:PORT"
```

Coloque o valor entre aspas; uma senha com caracteres especiais do shell, como `$`, `&`
ou `!`, também precisa de aspas ou de escape, e as aspas simples são as mais seguras em
um shell POSIX.

`all_proxy` define um único proxy para todos os protocolos, e `no_proxy` lista os hosts
que o dispensam. Use os nomes em minúsculas para `http_proxy`, porque o curl ignora a
forma em maiúsculas para HTTP simples. Remova as variáveis com `unset http_proxy
https_proxy`. Os dados ficam visíveis no histórico do shell e na lista de processos, então
não use isso em uma máquina compartilhada.

## Qual forma usar

Use `-x` e `-U` para uma única requisição e para scripts, porque eles não alteram o seu
shell. Use a forma com a URL quando uma ferramenta aceita apenas uma string de proxy. Use
as variáveis de ambiente quando for trabalhar um tempo no shell e quiser que todas as
chamadas do curl sigam o mesmo caminho. Em um script, prefira variáveis definidas dentro
do próprio script a variáveis exportadas globalmente.

## Veja o resultado

Um `200` ou um redirecionamento significa que o proxy aceitou o login. Um `407` significa
que não aceitou: o [erro 407 de proxy](/pt/faq/proxy-error-407/) lista as verificações, e
a [falha de autenticação do proxy](/pt/faq/proxy-authentication-failed/) trata do modo de
lista de IPs permitidos. Para confirmar o endereço de saída, abra o [Qual é o meu IP](/pt/what-is-my-ip/)
através do proxy, ou cole o proxy no nosso [verificador de proxy](/pt/proxy-checker/), que faz o mesmo teste de
uma requisição sem terminal. O mesmo proxy em código está na página do
[Python requests](/pt/integrations/python-requests/), e os pedidos e os preços estão na
página de [proxies ISP](/pt/isp-proxies/).

