Configurando proxies no VS Code e nas IDEs JetBrains
Introdução
As IDEs são a ferramenta principal do desenvolvedor. Ao trabalhar atrás de um proxy corporativo, o VS Code e as IDEs JetBrains exigem configuração específica para baixar extensões, atualizações e trabalhar com repositórios Git através do proxy.
Configuração básica
VS Code
- Abra as Settings (Ctrl+,)
- Busque por "proxy"
- Defina "Http: Proxy" como http://proxy_ip:port
- Ou edite o settings.json e adicione http.proxy
- Para autenticação: http://user:pass@proxy_ip:port
- "Http: Proxy Strict SSL" — desative para proxies corporativos com certificados autoassinados
IDEs JetBrains (IntelliJ, PyCharm, WebStorm)
- File → Settings → Appearance & Behavior → System Settings → HTTP Proxy
- Selecione "Manual proxy configuration"
- Informe o Host name e o Port number
- Para autenticação — informe Login e Password
- Clique em "Check connection" para verificar
- No proxy for: localhost, *.local
Configuração avançada
Variáveis de ambiente
A maioria das ferramentas suporta as variáveis de ambiente padrão para proxies:
- HTTP_PROXY / http_proxy — proxy para requisições HTTP
- HTTPS_PROXY / https_proxy — proxy para requisições HTTPS
- NO_PROXY / no_proxy — lista de exclusões (endereços que ignoram o proxy)
- ALL_PROXY / all_proxy — proxy para todos os protocolos
SSL e certificados autoassinados
Proxies corporativos costumam usar seus próprios certificados SSL. Para trabalhar através deles, você precisa:
1. Obter o certificado CA do proxy com o administrador
2. Adicioná-lo ao repositório de certificados do sistema
3. Ou desativar a verificação SSL (apenas para testes)
Autenticação
Dois métodos principais de autenticação são suportados:
Por usuário e senha — autenticação HTTP Basic padrão. As credenciais são enviadas em cada requisição. Formato da URL: http://user:pass@proxy_ip:port
Por endereço IP (whitelist) — seu IP é adicionado a uma lista branca. Não é necessário enviar credenciais.
Verificando o funcionamento
Depois de configurar, verifique:
1. Faça uma requisição de teste através do proxy
2. Confirme que o IP mudou
3. Verifique a velocidade da conexão
4. Confirme que não há vazamentos de DNS
Solução de problemas
O proxy não conecta
- Verifique se o endereço e a porta estão corretos
- Confirme que o firewall não está bloqueando a conexão
- Verifique a acessibilidade do proxy a partir da sua rede
Erros de SSL
- Para proxies corporativos, adicione o certificado CA
- Para testes, desative temporariamente a verificação SSL
- Atualize as bibliotecas SSL para a versão mais recente
Erros de autenticação
- Confira usuário e senha
- Confirme que o formato das credenciais está correto
- Tente codificar em URL os caracteres especiais da senha
Boas práticas
- Use variáveis de ambiente — para flexibilidade e segurança
- Não deixe credenciais no código — use variáveis de ambiente ou arquivos de configuração
- Configure exclusões — não passe localhost e endereços internos pelo proxy
- Documente as configurações — no README do projeto ou na wiki do time
- Teste após alterações — qualquer mudança de configuração exige verificação
Conclusão
A configuração correta do proxy garante o funcionamento estável das ferramentas e a segurança da conexão. Siga as recomendações deste guia e sempre verifique o funcionamento depois da configuração.
