VPN, proxy e filtros

Ajustes de proxy impedem apps de se conectar no Mac

Um ajuste de proxy envia o tráfego por outro servidor. Se esse servidor estiver incorreto ou indisponível, apps não conseguem se conectar, mas outros podem funcionar normalmente.

Aplica-se ao macOS 13 Ventura e posteriores para o caminho dos Ajustes do Sistema. Os comandos funcionam em todas as versões atuais do macOS.Verificado: 29 de outubro de 2026

Sintomas

O Safari funciona, mas um app ou ferramenta do Terminal mostra um tempo limite ou erro de “proxy”.
Apps conectam em casa, mas falham em outra rede, ou vice-versa.
Ferramentas de linha de comando falham com “Could not resolve proxy” ou conexão recusada a uma porta local.
As conexões param depois que um app de VPN ou proxy é encerrado.

Possíveis causas

Um proxy antigo do sistema. Um proxy definido nos Ajustes do Sistema permanece após você sair da rede que precisava dele.
Um arquivo PAC ou descoberta automática de proxy. O Mac obtém regras de proxy de uma URL. Se a URL não carregar, alguns apps não conseguem se conectar.
Variáveis de ambiente de proxy. Ferramentas do Terminal leem http_proxy, https_proxy e all_proxy. Essas variáveis não alteram o proxy dos Ajustes do Sistema e apps abertos pelo Dock não as veem.
Um app de proxy que parou. Alguns apps definem um proxy para uma porta local, como 127.0.0.1. Se o app parar, nada aguardará conexões nessa porta.
Um app com ajuste próprio de proxy. Alguns apps têm um campo de proxy em seus ajustes. Esse campo é separado do proxy do sistema.

Como verificar

Abra o Terminal. Mostre a configuração de proxy que o macOS usa agora.
```
scutil --proxy
```
Saída Chaves como HTTPEnable, HTTPSEnable, ProxyAutoConfigEnable e ProxyAutoDiscoveryEnable. O valor 1 significa ativado.
Mostre o proxy HTTP e HTTPS de um serviço de rede. Substitua Wi-Fi pelo nome do serviço, se necessário.
```
networksetup -getwebproxy Wi-Fi
networksetup -getsecurewebproxy Wi-Fi
```

Mostre os ajustes do arquivo PAC e da descoberta automática de proxy.

networksetup -getautoproxyurl Wi-Fi
networksetup -getproxyautodiscovery Wi-Fi

Mostre as variáveis de proxy no shell.
```
env | grep -i proxy
```
Se um proxy apontar para 127.0.0.1, descubra o que aguarda conexões nessa porta. Substitua 7890 pela porta.
```
lsof -nP -iTCP:7890 -sTCP:LISTEN
```

Como corrigir

Selecione menu Apple > Ajustes do Sistema > Rede. Clique no serviço de rede e depois em Detalhes.
Clique em Proxies. Desative cada tipo de proxy que sua rede não precisa.
Alguns hosts não devem usar o proxy. Adicione-os a “Ignorar os ajustes de proxy para estes hosts e domínios”.
Clique em OK para salvar a alteração.
Para desativar um proxy web pelo Terminal, use networksetup. O macOS pode pedir uma senha de administrador.
```
networksetup -setwebproxystate Wi-Fi off
networksetup -setsecurewebproxystate Wi-Fi off
```
Requer uma senha de administrador.
Remova variáveis de proxy antigas do arquivo de inicialização do shell, como ~/.zshrc. Depois abra uma nova janela do Terminal.
Procure nos ajustes do app que falha um campo próprio de proxy. Configure-o de acordo com sua rede.

Com o Kilobat

A verificação de conexão do Kilobat informa o proxy do sistema e o arquivo PAC. Ela também testa o caminho direto e o caminho pelo proxy.
```
kilobat why api.example.com
```
Adicione --app para ler as variáveis de proxy no ambiente desse app. Senhas não são mostradas.
```
kilobat why https://api.example.com/v1/models --app com.example.App
```
Se o app tiver um ajuste próprio de proxy, informe esse endereço com --proxy.
```
kilobat why huggingface.co --proxy http://127.0.0.1:7890
```
A verificação é grátis. Consulte Descobrir por que um site ou API não conecta para as etapas no app e no MCP.

Perguntas

Por que o Safari funciona quando o Terminal falha?

O Safari usa o proxy do sistema. Ferramentas do Terminal usam as variáveis de proxy do shell. Os dois ajustes podem ser diferentes.

O que é descoberta automática de proxy?

O Mac procura regras de proxy na rede. Em uma rede sem proxy, você pode desativá-la.

Fontes

Suporte da Apple: Alterar os ajustes de proxy no Mac
scutil(8), página de manual instalada com o macOS 27.2
networksetup(8), página de manual instalada com o macOS 27.2
lsof(8), página de manual instalada com o macOS 27.2

Verificado em 29 de outubro de 2026.