Configurando proxy no WSL (Windows Subsystem for

Configurando proxies no WSL (Windows Subsystem for Linux)

Introdução

O WSL (Windows Subsystem for Linux) permite executar Linux dentro do Windows. Configurar proxies no WSL é diferente de uma configuração Linux padrão por causa das particularidades da pilha de rede do WSL.

Configuração básica

WSL2 e proxies

O WSL2 usa uma rede virtual. O IP do host a partir do WSL2:

cat /etc/resolv.conf | grep nameserver

Configure os proxies em ~/.bashrc ou ~/.profile:

export http_proxy=http://host_ip:port
export https_proxy=http://host_ip:port
export no_proxy=localhost,127.0.0.1

Detecção automática do IP do host

O IP do host muda quando o WSL2 é reiniciado. Automatize isso com um script:

HOST_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy=http://$HOST_IP:port

WSL1

O WSL1 usa a rede do host diretamente. Os proxies são configurados como em um ambiente Linux padrão. Os proxies do sistema Windows não são repassados automaticamente.

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 exceções (endereços que ignoram o proxy)
- ALL_PROXY / all_proxy — proxy para todos os protocolos

SSL e certificados autoassinados

Proxies corporativos costumam usar os 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

Há suporte a dois métodos principais de autenticação:

Por usuário e senha — autenticação HTTP Basic padrão. As credenciais são enviadas a 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 é preciso enviar credenciais.

Verificação

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

Problemas de conexão com o proxy

• Verifique se o endereço e a porta estão corretos
• Confirme que o firewall não está bloqueando a conexão
• Verifique se o proxy está acessível 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

• Verifique o usuário e a senha
• Confirme que o formato das credenciais está correto
• Tente codificar em URL os caracteres especiais da senha

Boas práticas

1. Use variáveis de ambiente — para flexibilidade e segurança
2. Não deixe credenciais no código — use variáveis de ambiente ou arquivos de configuração
3. Configure exceções — não envie localhost e endereços internos pelo proxy
4. Documente as configurações — no README do projeto ou no wiki do time
5. Teste após mudanças — qualquer alteração de configuração exige verificação

Conclusão

A configuração correta do proxy garante o funcionamento estável das ferramentas e conexões seguras. Siga as recomendações deste guia e sempre verifique o funcionamento depois da configuração.