Configuração 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 redirecionamento de portas e proxy HTTP global.

Redirecionamento 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 é mais complexo.

• Funcionalidade core: Você pode mapear portas específicas do Windows para portas internas da instância WSL.
• Regras automáticas de firewall: O WSL Dashboard adiciona automaticamente as regras de entrada necessárias no Windows Defender Firewall ao criar regras de redirecionamento, garantindo que o tráfego externo possa penetrar.
• Configurações:
  • IP do host: Geralmente 0.0.0.0 (ouvindo em todas as placas de rede) ou 127.0.0.1.
  • Porta do host: Porta aberta no lado do Windows.
  • Porta WSL: Porta na qual o serviço interno da instância está ouvindo.

Proxy HTTP global (HTTP Proxy)

Configurar um proxy dentro do WSL (como quando git clone ou apt install são lentos) geralmente requer modificar vários arquivos de configuração.

• Configuração rápida: O WSL Dashboard oferece um interruptor de proxy global.
• Funcionamento: Com base em suas configurações, ele configura automaticamente variáveis de ambiente de proxy ou opções de proxy para serviços relacionados na instância selecionada, eliminando a necessidade de obter manualmente o IP do host.
• Protocolos suportados: Protocolos comuns http:// e socks5://.

Monitoramento do estado da rede

Você pode ver em tempo real no painel de rede:

• IP do host WSL: IP do adaptador de rede virtual do Windows.
• IP da instância WSL: Endereço real atribuído dentro da instância.
• Conexões ativas: Monitoramento das regras de redirecionamento de portas atualmente ativas e do estado do tráfego.

Modo de rede avançado (Modo espelhado)

Para usuários do Windows 11, o WSL 2 suporta o modo de rede "espelhado" (mirrored).

• Vantagem: O modo espelhado permite que a instância WSL compartilhe diretamente a interface de rede do host, resolvendo muitos problemas complexos de VPN ou descoberta de rede local.
• Sugestão de configuração: Se você habilitou o modo espelhado, a função de redirecionamento de portas do WSL Dashboard ainda funciona, mas você pode preferir acessar os serviços diretamente através do IP do host.

Dica

Configurar auto_shutdown_distros = true no settings.toml pode garantir que nenhuma tarefa de escuta de rede desnecessária permaneça em segundo plano após fechar o Dashboard.

Solução de problemas comuns

Conflito de portas

Se algum redirecionamento de porta não funcionar, verifique:

1. A porta do host está ocupada?: Use netstat -ano | findstr :<número da porta> para verificar.
2. Permissões de administrador: Algumas portas (como aquelas abaixo de 1024) podem exigir permissões de administrador para ouvir.

Bloqueio de firewall

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