Em 7 de outubro de 2026, a Shifter tem o maior pool de IPs dos EUA ativos, mais do que a Oxylabs e a Bright Data, por uma fração do custo.A Shifter agora tem o maior pool de IPs ativos dos EUA

Ver benchmarks

Arquivos PAC de Proxy Explicados, Com Exemplos Prontos para Uso

O que é um arquivo PAC de proxy, como o FindProxyForURL funciona, quatro exemplos prontos para uso, onde definir a URL do PAC em cada sistema, e os erros que vazam tráfego.

Engenharia · Atualizado em 14 de novembro de 2026 · 8 min de leitura
FindProxyForURL(url, host)example-shop.comPROXY p.shifter.io:443intranetDIRECTproxy fora do ar + "; DIRECT"seu próprio IP
Uma função decide site por site. O fallback âmbar carrega a página do seu próprio IP.
Conhecimento
Nesta página
  1. Como um arquivo PAC funciona
  2. As funções auxiliares que você vai usar
  3. Quatro exemplos prontos para usar
  4. Onde definir o arquivo PAC
  5. Login, e por que a localização é definida uma única vez
  6. Erros que enviam tráfego ao redor do proxy
  7. Verifique se está funcionando
  8. Conclusão

Um arquivo PAC diz a um navegador qual proxy usar para qual site. Em vez de enviar tudo por um único proxy, ou nada, você escreve uma regra curta: essas lojas passam por um proxy residencial na Alemanha, a intranet da empresa vai direto, e todo o resto segue um padrão. O navegador lê a regra antes de cada requisição.

PAC significa proxy auto-config. O formato remonta à Netscape nos anos 1990 e ainda é suportado por todo navegador e sistema operacional importante. Este guia explica como o arquivo funciona, traz quatro exemplos que você pode copiar, mostra onde configurá-lo em cada sistema e lista os erros que silenciosamente enviam tráfego para fora do proxy.

Como um arquivo PAC funciona

Um arquivo PAC é JavaScript puro com uma função obrigatória:

function FindProxyForURL(url, host) {
  return "PROXY p.shifter.io:443";
}

O navegador chama FindProxyForURL para cada requisição, com a URL completa e o nome do host. A função retorna uma string que diz para onde a requisição vai:

Valor de retornoSignificado
DIRECTConecta sem um proxy
PROXY host:portUsa um proxy HTTP
HTTPS host:portUsa um proxy HTTP por uma conexão TLS até o proxy
SOCKS5 host:portUsa um proxy SOCKS5

Você pode encadear várias respostas com ponto e vírgula, como PROXY p.shifter.io:443; DIRECT. O navegador tenta na ordem e passa para a próxima se um proxy não puder ser alcançado. Esse fallback é útil, e também é a forma mais comum de o tráfego escapar do proxy, como mostrado abaixo.

Para Shifter, use PROXY. Os navegadores não suportam fazer login em um proxy SOCKS5 a partir de um arquivo PAC, e o gateway aceita conexões de proxy HTTP na mesma porta.

As funções auxiliares que você vai usar

O ambiente PAC adiciona algumas funções ao JavaScript puro. Estas quatro cobrem a maioria das regras:

  • isPlainHostName(host): verdadeiro para nomes sem ponto, como intranet.
  • dnsDomainIs(host, ".example.com"): verdadeiro quando o host termina com esse domínio.
  • shExpMatch(host, "*.example.*"): corresponde a curingas no estilo shell.
  • isInNet(ip, "10.0.0.0", "255.0.0.0"): verdadeiro quando um IP está dentro de uma faixa de rede.

Também existe dnsResolve(host), que busca o IP de um host. Use com moderação, pelos motivos abordados na seção de erros.

Quatro exemplos prontos para usar

Substitua os domínios pelos seus próprios. Cada exemplo funciona como um arquivo completo.

1. Tudo pelo proxy, endereços locais direto

function FindProxyForURL(url, host) {
  if (isPlainHostName(host) ||
      host === "localhost" ||
      shExpMatch(host, "*.local") ||
      shExpMatch(host, "127.*") ||
      shExpMatch(host, "10.*") ||
      shExpMatch(host, "192.168.*")) {
    return "DIRECT";
  }
  return "PROXY p.shifter.io:443";
}

Isso mantém seu roteador, impressoras e servidores de desenvolvimento local acessíveis enquanto todo site passa pelo proxy.

2. Apenas uma lista de sites pelo proxy

var VIA_PROXY = [".example-shop.com", ".example-news.de"];

function FindProxyForURL(url, host) {
  host = host.toLowerCase();
  for (var i = 0; i < VIA_PROXY.length; i++) {
    if (dnsDomainIs(host, VIA_PROXY[i]) || "." + host === VIA_PROXY[i]) {
      return "PROXY p.shifter.io:443";
    }
  }
  return "DIRECT";
}

Esse é o motivo mais comum para escrever um arquivo PAC. Sua navegação normal permanece na sua própria conexão, e apenas os sites que você está verificando saem pelo proxy, o que também mantém baixo o tráfego por GB. Equipes de QA usam isso para ver uma loja virtual ou a visualização web de um app a partir de outro mercado enquanto o resto das ferramentas funciona normalmente; nossa página sobre QA de localização com proxies cobre esse fluxo de trabalho.

3. Escolha entre fallback e falha fechada

function FindProxyForURL(url, host) {
  if (dnsDomainIs(host, ".example-shop.com")) {
    // Falha fechada: se o proxy estiver fora do ar, a página não carrega.
    return "PROXY p.shifter.io:443";
  }
  if (dnsDomainIs(host, ".example-news.de")) {
    // Fallback: se o proxy estiver fora do ar, a página carrega a partir do seu próprio IP.
    return "PROXY p.shifter.io:443; DIRECT";
  }
  return "DIRECT";
}

Os exemplos 1, 2 e 4 falham de forma fechada: não há ; DIRECT depois do proxy. Se o proxy estiver inalcançável, essas páginas mostram um erro em vez de carregar silenciosamente a partir do seu IP real. Quando o objetivo do proxy é ver um site a partir de outro lugar, um erro é melhor do que uma resposta errada que parece certa. Adicione o fallback apenas para sites em que qualquer resposta seja melhor do que nenhuma.

4. Tudo pelo proxy, exceto alguns sites

var DIRECT_SITES = [".zoom.us", ".slack.com", ".yourcompany.com"];

function FindProxyForURL(url, host) {
  host = host.toLowerCase();
  if (isPlainHostName(host)) return "DIRECT";
  for (var i = 0; i < DIRECT_SITES.length; i++) {
    if (dnsDomainIs(host, DIRECT_SITES[i])) return "DIRECT";
  }
  return "PROXY p.shifter.io:443";
}

Chamadas, chat e ferramentas internas permanecem na sua própria conexão, onde são mais rápidas, e o resto do navegador usa o proxy.

Onde definir o arquivo PAC

Um arquivo PAC é definido como uma URL, não colado como texto. Sirva-o a partir de um servidor web que você controla, com o tipo application/x-ns-proxy-autoconfig. O Windows não aceita um caminho de arquivo local para o script, então uma URL web é a escolha segura em todos os casos.

  • Windows 11: Configurações > Rede e internet > Proxy. Em Configuração automática de proxy, ative Usar script de configuração e digite a URL.
  • macOS: Ajustes do Sistema > Rede > sua conexão > Detalhes > Proxies. Ative Configuração automática de proxy e digite a URL.
  • Firefox: Configurações > Configurações de Rede > URL de configuração automática de proxy.
  • Chrome e Edge: seguem a configuração do sistema acima.
  • iPhone: Ajustes > Wi-Fi > o botão de informação > Configurar Proxy > Automático, depois a URL.
  • Android: nas opções avançadas da rede Wi-Fi > Proxy > Proxy Auto-Config, depois a URL.

Nosso guia de configuração de proxy no Windows e macOS mostra a versão manual dessas mesmas telas, caso você queira um único proxy para tudo.

Login, e por que a localização é definida uma única vez

Um arquivo PAC não tem espaço para nome de usuário ou senha. Quando uma requisição chega ao proxy, o proxy pede credenciais e o navegador mostra um aviso de login. Digite seu nome de usuário completo do proxy e sua senha. Se o aviso continuar voltando, as credenciais estão sendo rejeitadas: copie ambos novamente do painel e verifique a ortografia da parte de segmentação.

Com a Shifter, a localização e a sessão ficam no nome de usuário, por exemplo customer-USERNAME-country-de-sid-qa1-ttl-1800 para um IP alemão que se mantém por 30 minutos. Então um arquivo PAC decide quais sites usam o proxy, e o nome de usuário com o qual você faz login decide de onde eles aparecem. Uma sessão de navegador significa uma localização. Se você precisa de países diferentes para sites diferentes ao mesmo tempo, use perfis de navegador separados, ou a extensão de navegador da Shifter, que troca de localização com um clique.

Erros que enviam tráfego ao redor do proxy

  • Um fallback que você não queria. PROXY ...; DIRECT carrega a página a partir do seu IP real sempre que o proxy falha. Use isso apenas onde for aceitável.
  • Um arquivo quebrado ou inalcançável. Se a URL do PAC não carregar, ou o script gerar um erro, a maioria dos navegadores conecta diretamente. Teste após cada edição e mantenha o arquivo pequeno.
  • Regras no caminho de URLs HTTPS. Os navegadores removem o caminho e a query de URLs HTTPS antes de chamar a função, então url contém apenas algo como https://example.com/. Faça a correspondência pelo host.
  • Consultas DNS dentro das regras. dnsResolve e isInNet em um nome de host fazem a busca do nome na sua própria rede primeiro. Isso deixa cada requisição mais lenta, e envia os nomes dos sites que você visita para o seu resolvedor DNS local mesmo quando a página em si passa pelo proxy. Nosso guia sobre como prevenir vazamentos de DNS com proxies residenciais explica por que isso importa. Prefira dnsDomainIs e shExpMatch, que funcionam apenas com o nome.
  • Uma versão antiga em cache. Os navegadores fazem cache do arquivo PAC. Depois de uma edição, reinicie o navegador ou reaplique as configurações (no Chrome, chrome://net-internals/#proxy).
  • Descoberta automática que você nunca pediu. “Detectar configurações automaticamente” (WPAD) permite que a rede à qual você se conecta entregue ao seu dispositivo um arquivo PAC. Em redes em que você não confia, desative isso.

Verifique se está funcionando

Adicione um domínio de teste às suas regras, depois abra ip-info.com uma vez com a regra direcionando-o pelo proxy e outra vez com ele indo direto. A primeira visita deve mostrar o IP do proxy e a localização do seu nome de usuário; a segunda, o seu próprio. Em seguida, abra um site fora da sua lista e confirme que ele ainda carrega normalmente.

Conclusão

Um arquivo PAC é algumas linhas de JavaScript que decidem, site por site, se uma requisição passa por um proxy. Mantenha as regras nos nomes de host, evite consultas DNS nelas, escolha deliberadamente entre fallback e falha fechada, e sirva o arquivo a partir de uma URL. O nome de usuário do proxy ainda define a localização, então planeje uma localização por perfil de navegador.

Perguntas frequentes

O que é um arquivo PAC?

Um arquivo PAC (proxy auto-config) é um pequeno arquivo JavaScript com uma função, FindProxyForURL(url, host). O navegador ou o sistema operacional a chama para cada requisição e usa a resposta para decidir se essa requisição passa por um proxy ou se conecta diretamente.

Um arquivo PAC pode conter o nome de usuário e a senha do proxy?

Não. Um arquivo PAC só indica o host e a porta do proxy. Quando o proxy solicita credenciais, o navegador exibe um prompt de login, ou usa credenciais que o sistema armazenou.

Por que meu arquivo PAC não corresponde ao caminho de uma URL HTTPS?

Navegadores modernos passam apenas o esquema e o host das URLs HTTPS para o arquivo PAC e removem o caminho e a query, para não vazar o endereço completo para o script. Escreva suas regras com base no nome do host.

O que acontece se o arquivo PAC não puder ser carregado?

A maioria dos navegadores então se conecta diretamente, sem proxy. Se a conexão direta nunca puder acontecer, teste o arquivo após cada alteração e fique atento a erros nas ferramentas de rede do navegador.

Pronto para começar?

Experimente os proxies residenciais da Shifter, mais de 205M IPs, mais de 195 países, a partir de $ 0,75/GB.

Começar