--- title: "Ajustes de proxy do Mac prejudicam apps: encontre e corrija o problema · Guias do Kilobat" url: "https://kilobat.app/pt/guides/proxy-settings-breaking-apps" description: "Encontre o proxy do sistema, arquivo PAC ou variável HTTPS_PROXY que impede apps do Mac ou ferramentas do Terminal de se conectar e corrija ou remova o ajuste." --- 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 1. 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. 2. 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 ``` 3. Mostre os ajustes do arquivo PAC e da descoberta automática de proxy. ``` networksetup -getautoproxyurl Wi-Fi networksetup -getproxyautodiscovery Wi-Fi ``` 4. Mostre as variáveis de proxy no shell. ``` env | grep -i proxy ``` 5. 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 1. Selecione menu Apple > Ajustes do Sistema > Rede. Clique no serviço de rede e depois em Detalhes. 2. Clique em Proxies. Desative cada tipo de proxy que sua rede não precisa. 3. Alguns hosts não devem usar o proxy. Adicione-os a “Ignorar os ajustes de proxy para estes hosts e domínios”. 4. Clique em OK para salvar a alteração. 5. 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. 6. Remova variáveis de proxy antigas do arquivo de inicialização do shell, como `~/.zshrc`. Depois abra uma nova janela do Terminal. 7. Procure nos ajustes do app que falha um campo próprio de proxy. Configure-o de acordo com sua rede. ## Com o Kilobat 1. 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 ``` 2. 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 ``` 3. 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 ``` 4. A verificação é grátis. Consulte [Descobrir por que um site ou API não conecta](https://kilobat.app/pt/guides/recipes/why-cant-it-connect) 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](https://support.apple.com/guide/mac-help/change-proxy-settings-on-mac-mchlp2591/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. ## Guias relacionados - [Descubra por que um site ou API não conecta](https://kilobat.app/pt/guides/recipes/why-cant-it-connect): Quando a internet funciona, mas um endereço falha, o Kilobat verifica cada camada por vez. - [Certificados de proxy empresarial interferem em ferramentas do Terminal no Mac](https://kilobat.app/pt/guides/corporate-proxy-certificates): Algumas redes empresariais inspecionam o tráfego HTTPS. - [Downloads do Homebrew ou npm falham no Mac](https://kilobat.app/pt/guides/homebrew-npm-download-fails): O Homebrew baixa arquivos com curl e Git. - [VPN conectada, mas sem internet no Mac](https://kilobat.app/pt/guides/vpn-connected-no-internet): Uma VPN envia tráfego por um túnel.