Guia de configuração do modo de rede mirrored no WSL
Guia de atualização de configuração do modo de rede WSL 2.6.0
Categories:
Requisitos de versão
Estado da versão atual:
- Versão estável mais recente: 2.5.9 (com defeito de configuração de rede)
- Versão recomendada: 2.6.0 Preview (suporta modo mirrored completo)
Análise comparativa de modos
| Característica | Modo bridge (obsoleto) | Modo mirrored (recomendado) |
|---|---|---|
| Arquitetura de protocolo | Dupla pilha de protocolos | Pilha de protocolos compartilhada |
| Atribuição de endereços IP | IP independente (Windows+WSL) | IP compartilhado do host |
| Recursos de porta | Uso independente | Portas compartilhadas (evitar conflitos) |
| Desempenho de rede | Relativamente pesado | Leve e eficiente |
| Complexidade de configuração | Simples | Requer configuração profunda de políticas de firewall |
Etapas de configuração padrão
1. Configuração do modo de rede
Configurar o modo básico através do WSL Settings:
- Abrir o aplicativo de configurações
- Selecionar a aba “Network”
- Definir o modo de rede como “Mirrored”
- Aplicar a configuração e reiniciar o WSL
2. Configuração de políticas de firewall
Executar a configuração completa de políticas através do PowerShell:
# Definir o GUID da VM do WSL
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'
# Configurar políticas de firewall (executar na ordem)
Set-NetFirewallHyperVVMSetting -Name $wslGuid -Enabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultInboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultOutboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -LoopbackEnabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -AllowHostPolicyMerge True
# Verificar resultados da configuração
Get-NetFirewallHyperVVMSetting -Name $wslGuid
3. Verificação de mapeamento de portas
# Exemplo: verificar uso da porta 80
Get-NetTCPConnection -LocalPort 80
Tratamento de problemas comuns
Problema 1: Não é possível estabelecer conexão externa
- Passos de verificação: todos os campos na saída de
Get-NetFirewallHyperVVMSettingdevem ser True/Allow - Solução: executar novamente a configuração de políticas de firewall na ordem correta
Problema 2: Conflito de portas
- Método de verificação: usar
netstat -anopara verificar uso de portas - Sugestão de tratamento: liberar primeiramente as portas ocupadas no Windows, ou modificar a porta de escuta do serviço WSL
Métodos de verificação
- Iniciar o serviço WSL (como Nginx/Apache)
- Acessar do host Windows
http://localhost:<port> - Acessar do dispositivo da rede local
http://<host-ip>:<port>