Definições de rede

O WSL Dashboard simplifica a configuração da comunicação de rede entre o WSL 2 e o host (Windows), com suporte a encaminhamento de portas e proxy HTTP global.

Encaminhamento de portas (Port Forwarding)

Como o WSL 2 usa um adaptador de rede virtual, acessar serviços internos do WSL a partir de outros dispositivos na rede local geralmente é complexo.

• Recurso principal: você pode mapear portas específicas do Windows para portas internas das instâncias WSL.
• Regras de firewall automáticas: ao criar regras de encaminhamento, o WSL Dashboard adiciona automaticamente as regras de entrada necessárias no firewall do Windows Defender, garantindo que o tráfego externo possa atravessar.
• Itens de configuração:
  • IP do host: normalmente 0.0.0.0 (escuta em todas as interfaces de rede) ou 127.0.0.1.
  • Porta do host: a porta aberta no lado do Windows.
  • Porta do WSL: a porta em que o serviço interno da instância escuta.

Proxy HTTP global (HTTP Proxy)

Configurar um proxy dentro do WSL (por exemplo, quando git clone ou apt install estão lentos) geralmente exige modificar vários arquivos de configuração.

• Configuração rápida: o WSL Dashboard oferece um interruptor de proxy global.
• Como funciona: de acordo com suas configurações, ele configura automaticamente as variáveis de ambiente de proxy ou as opções de proxy dos serviços relevantes para as instâncias selecionadas, evitando o incômodo de obter manualmente o IP do host.
• Protocolos suportados: os protocolos comuns http:// e socks5://.

Monitoramento do estado da rede

No painel de rede, você pode visualizar em tempo real:

• IP do host WSL: o IP do adaptador de rede virtual do Windows.
• IP da instância WSL: o endereço realmente atribuído dentro da instância.
• Conexões ativas: monitore as regras de encaminhamento de portas ativas e o estado do tráfego.

Modo de rede avançado (Mirrored Mode)

Para usuários do Windows 11, o WSL 2 suporta o modo de rede "espelhada".

• Vantagens: o modo espelhado permite que as instâncias WSL compartilhem diretamente a interface de rede do host, resolvendo muitos problemas complexos de VPN ou descoberta na rede local.
• Recomendação de configuração: se você habilitou o modo espelhado, o encaminhamento de portas do WSL Dashboard ainda funciona, mas talvez você prefira acessar os serviços diretamente pelo IP do host.

Dica

Configurar auto_shutdown_distros = true em settings.toml garante que, após fechar o Dashboard, nenhuma tarefa de escuta de rede inútil permaneça em segundo plano.

Solução de problemas comuns

Conflito de portas

Se um encaminhamento de porta não funcionar, verifique:

1. Se a porta do host está ocupada: use netstat -ano | findstr :<número-da-porta> para verificar.
2. Privilégios de administrador: algumas portas (como as menores que 1024) podem exigir privilégios de administrador para escutar.

Bloqueio pelo firewall

Embora o WSL Dashboard tente configurar as regras automaticamente, se você tiver um firewall de terceiros instalado (como Huorong, 360, etc.), talvez seja necessário permitir manualmente o acesso de rede de wsldashboard.exe.