Configurar um proxy significa dizer a um aplicativo — ou a todo o sistema operacional — para enviar seu tráfego para um host e porta específicos, e fornecer credenciais se o proxy exigir. As informações que você precisa do seu provedor são sempre as mesmas quatro: host (um domínio ou IP), porta, nome de usuário, senha — ou, em vez de um login, seu próprio IP adicionado à lista de permissões do provedor. Abaixo estão os passos exatos para os quatro lugares onde as pessoas mais configuram proxies, além de como verificar se funcionou.

Antes de começar: proxy de sistema vs proxy de aplicativo

Existem dois níveis nos quais um proxy pode ser configurado, e saber qual deles você está mexendo evita a maioria das confusões.

  • Proxy de sistema (Configurações do Windows, preferências de Rede do macOS): o SO anuncia um proxy, e aplicativos que respeitam as configurações do sistema o usam. Chrome, Edge, Safari e a maioria dos aplicativos de desktop fazem isso. Algumas ferramentas o ignoram completamente.
  • Proxy de aplicativo: o aplicativo tem sua própria configuração e usa apenas essa. O Firefox é o navegador notável aqui; ferramentas de linha de comando usam variáveis de ambiente ou flags; navegadores antidetecção configuram um proxy por perfil.

Se você quer que tudo seja proxy, configure o proxy de sistema. Se você quer que um navegador ou ferramenta seja proxy enquanto o resto da máquina permanece direto — o caso usual para trabalho com múltiplas contas ou testes — configure no aplicativo. Misturar os dois é de onde vem o “configurei um proxy mas meu IP não mudou”.

Firefox (configurações próprias, todas as plataformas)

O Firefox é o navegador mais fácil de usar proxy independentemente do SO.

  1. Abra Configurações → role até Configurações de Rede no final de Geral → clique em Configurações….
  2. Escolha Configuração manual de proxy.
  3. Para um proxy HTTP/HTTPS: insira o host e a porta em Proxy HTTP e marque Usar também este proxy para HTTPS.
    Para um proxy SOCKS: insira host e porta em Host SOCKS e selecione SOCKS v5.
  4. Marque Proxy DNS ao usar SOCKS v5. Isso roteia a resolução de nomes através do proxy e evita vazamentos de DNS — deixe desmarcado e seu ISP ainda verá todos os domínios que você visita.
  5. Clique em OK. Na primeira solicitação, o Firefox solicitará o nome de usuário e a senha do proxy e oferecerá para salvá-los.

O Firefox também permite configurar um proxy por contêiner ou por perfil, que é como as pessoas executam várias identidades com proxy a partir de uma única instalação sem extensões.

Chrome e Edge

O Chrome não tem configurações de proxy próprias no Windows e macOS: Configurações → Sistema → Abra as configurações de proxy do seu computador simplesmente abre o diálogo do SO descrito abaixo. Três maneiras de usar proxy especificamente no Chrome:

  1. Use o proxy de sistema (abaixo). Mais simples; afeta outros aplicativos também.
  2. Inicie com uma flag. Inicie o Chrome a partir de um atalho ou terminal com: 
    chrome --proxy-server="http://proxy.exemplo.com:8080"
chrome --proxy-server="socks5://proxy.exemplo.com:1080"
    Apenas essa instância do Chrome é proxy. Combine com --user-data-dir= para dar a ele um perfil separado. O Chrome solicitará credenciais no primeiro uso; ele não as aceita na flag.
  3. Use uma extensão. Extensões de troca de proxy podem manter vários perfis e alternar por aba ou por site, e podem armazenar credenciais. Conveniente, mas a extensão vê sua configuração de tráfego — instale apenas as que você confia.

No Linux, o Chrome lê as variáveis de ambiente http_proxy / https_proxy além das configurações do sistema.

Windows 11 (sistema inteiro)

  1. Configurações → Rede e internet → Proxy.
  2. Em Configuração manual de proxy, clique em Configurar ao lado de Usar um servidor proxy.
  3. Ative, insira o endereço (host) e a porta, e opcionalmente liste endereços para ignorar (por exemplo, localhost;127.*;*.local). Salve.
  4. O Windows solicitará credenciais na primeira vez que um aplicativo com proxy conectar.

Duas coisas para saber. Primeiro, este diálogo configura apenas um proxy HTTP; o proxy de sistema embutido do Windows não fala SOCKS5. Se seu provedor forneceu SOCKS5, use-o dentro do Firefox, em uma flag do Chrome, ou no próprio aplicativo. Segundo, a configuração se aplica a aplicativos que usam WinHTTP/WinINet — navegadores, Office, aplicativos da Store — mas não a tudo; muitas ferramentas de desenvolvimento e jogos contornam isso. Nosso guia específico para Windows cobre o que vaza ao redor do proxy de sistema.

A seção Configuração automática de proxy aceita uma URL de arquivo PAC — um pequeno arquivo JavaScript que decide por URL qual proxy usar. Útil para “esses domínios através do proxy, todo o resto direto.”

macOS (sistema inteiro)

  1. Configurações do Sistema → Rede → selecione a conexão ativa (Wi-Fi ou Ethernet) → Detalhes… → Proxies.
  2. Marque os protocolos que você precisa: Proxy Web (HTTP), Proxy Web Seguro (HTTPS), e/ou Proxy SOCKS. O macOS, ao contrário do Windows, suporta SOCKS no nível do sistema.
  3. Insira host e porta para cada protocolo marcado. Se o proxy exigir login, marque Servidor proxy requer senha e insira aqui — o macOS não solicitará depois como o Windows faz.
  4. Adicione hosts para ignorar no campo na parte inferior, depois OK e Aplicar.

A configuração é por localização de rede: mude de Wi-Fi para Ethernet e você deve configurar novamente lá. Safari e Chrome seguem; o Firefox não, a menos que você escolha Usar configurações de proxy do sistema em seu próprio diálogo. Veja também nossa nota sobre o que o macOS vaza ao redor de um proxy de sistema.

Autenticação: login vs lista de permissões de IP

Os provedores oferecem um ou ambos:

  • Nome de usuário e senha. Funciona de qualquer lugar; as credenciais são solicitadas pelo SO/navegador ou embutidas na URL para ferramentas (http://user:pass@host:porta). Se você usa proxies rotativos, o nome de usuário muitas vezes é a configuração — IDs de sessão e códigos de país vão nele (veja como gateways de rotação leem o login).
  • Lista de permissões de IP. Você registra seu próprio IP público no painel do provedor; conexões dele não precisam de senha. Conveniente para servidores com IPs estáticos; inútil de uma conexão doméstica cujo IP muda, e um incômodo em laptops que se movem entre redes.

Se a autenticação falhar, você verá um 407 Proxy Authentication Required. Verifique o nome de usuário para erros de digitação — parâmetros de rotação os tornam longos — e confirme que seu IP atual é o que está na lista de permissões.

Linha de comando e scripts

A maioria das ferramentas Unix honra variáveis de ambiente:

export http_proxy="http://user:pass@proxy.exemplo.com:8080"
export https_proxy="http://user:pass@proxy.exemplo.com:8080"
export no_proxy="localhost,127.0.0.1"

O curl também aceita -x; git, pip, npm e apt têm suas próprias chaves de configuração de proxy, mas também leem as variáveis acima. Para proxy em Python, Node ou frameworks de automação de navegador especificamente, cobrimos exemplos de código em guias separados.

Verifique se funcionou

Não assuma. Após configurar:

  1. Carregue uma página de verificação de IP no navegador com proxy (nova janela privada) e confirme que o IP e o país mudaram.
  2. Execute um teste de vazamento de DNS; com SOCKS5, certifique-se de que o DNS remoto está ativado.
  3. Em navegadores, execute um teste de WebRTC.

O procedimento completo, incluindo como ler os resultados, está em Como testar um proxy.

Problemas comuns

SintomaCausa provávelSolução
IP não mudouO aplicativo ignora o proxy de sistema; protocolo errado (SOCKS inserido como HTTP)Configure o proxy no aplicativo; corresponda o protocolo ao que você comprou
Erro 407Credenciais incorretas ou IP não na lista de permissõesVerifique novamente o nome de usuário (strings de rotação longas!) e o IP público atual
Alguns sites carregam, outros dão timeoutHTTPS não proxy (Firefox: “usar também para HTTPS” desmarcado)Ative também o campo de proxy HTTPS/seguro
Tudo está lentoProxy sobrecarregado, ou latência de residencial/móvelMeça; compare provedores; use datacenter onde o alvo permitir
IP real aparece no teste WebRTCVazamento WebRTCDesative WebRTC ou use um navegador antidetecção
Proxy funciona, depois para após alguns minutosSessão sticky expirou, ou lista de permissões de IP e seu IP mudouEstenda o tempo de sessão na string de login; re-adicione à lista de permissões

Perguntas frequentes

O Chrome tem configurações de proxy próprias?

Não no Windows ou macOS — ele usa o proxy de sistema. Para usar proxy apenas no Chrome, inicie-o com --proxy-server= ou use uma extensão.

O Windows pode usar um proxy SOCKS5 em todo o sistema?

Não; o diálogo de proxy do Windows é apenas HTTP. Use SOCKS5 dentro de aplicativos que o suportam (Firefox, a maioria das ferramentas de desenvolvimento, navegadores antidetecção), ou execute uma pequena ponte local HTTP-para-SOCKS.

Onde insiro a senha do proxy?

Windows e Firefox solicitam na primeira conexão; o macOS tem um campo nas configurações de proxy; ferramentas de linha de comando aceitam na URL como user:pass@host:porta.

O que é um arquivo PAC?

Um arquivo Proxy Auto-Config: uma função JavaScript curta que retorna, para cada URL, qual proxy (ou nenhum) usar. Ele permite rotear apenas certos sites através de um proxy. Tanto Windows quanto macOS aceitam uma URL PAC em suas configurações automáticas de proxy.

Como uso proxies diferentes em abas diferentes do navegador?

Navegadores padrão usam proxy por perfil, não por aba. Use perfis separados (Chrome --user-data-dir, perfis ou contêineres do Firefox), uma extensão de troca de proxy, ou um navegador antidetecção, que é feito exatamente para isso.

Preciso reiniciar após mudar o proxy?

Firefox e os diálogos do SO aplicam imediatamente. O Chrome capta mudanças do sistema na próxima solicitação. Variáveis de ambiente de linha de comando se aplicam a processos iniciados após serem definidas.