Configuración de red

WSL Dashboard simplifica la configuración de comunicación de red entre WSL 2 y la máquina anfitriona (Windows), con soporte para reenvío de puertos y proxy HTTP global.

Reenvío de puertos (Port Forwarding)

Debido a que WSL 2 usa un adaptador de red virtual, acceder a servicios internos de WSL desde otros dispositivos de la red local suele ser más complejo.

• Funcionalidad core: Puede mapear puertos específicos de Windows a puertos internos de la instancia WSL.
• Reglas automáticas de firewall: WSL Dashboard agrega automáticamente las reglas de entrada necesarias en Windows Defender Firewall al crear reglas de reenvío, asegurando que el tráfico externo pueda penetrar.
• Configuraciones:
  • IP del anfitrión: Por lo general, 0.0.0.0 (escucha en todas las tarjetas de red) o 127.0.0.1.
  • Puerto del anfitrión: Puerto abierto en el lado de Windows.
  • Puerto WSL: Puerto en el que escucha el servicio interno de la instancia.

Proxy HTTP global (HTTP Proxy)

Configurar un proxy dentro de WSL (como cuando git clone o apt install son lentos) generalmente requiere modificar múltiples archivos de configuración.

• Configuración rápida: WSL Dashboard proporciona un interruptor de proxy global.
• Funcionamiento: Según su configuración, configura automáticamente variables de entorno de proxy o opciones de proxy para servicios relacionados en la instancia seleccionada, eliminando la molestia de obtener manualmente la IP del anfitrión.
• Protocolos soportados: Protocolos comunes http:// y socks5://.

Monitoreo de estado de red

Puede ver en tiempo real en el panel de red:

• IP del anfitrión WSL: IP del adaptador de red virtual de Windows.
• IP de la instancia WSL: Dirección real asignada dentro de la instancia.
• Conexiones activas: Monitoreo de las reglas de reenvío de puertos actualmente activas y el estado del tráfico.

Modo de red avanzado (Modo espejo)

Para usuarios de Windows 11, WSL 2 admite el modo de red "espejo" (mirrored).

• Ventaja: El modo espejo permite que la instancia WSL comparta directamente la interfaz de red del anfitrión, resolviendo muchos problemas complejos de VPN o detección de red local.
• Sugerencia de configuración: Si ha habilitado el modo espejo, la función de reenvío de puertos de WSL Dashboard sigue funcionando, pero es posible que prefiera acceder a los servicios directamente a través de la IP del anfitrión.

Consejo

Configurar auto_shutdown_distros = true en settings.toml puede garantizar que no queden tareas de escucha de red inútiles en segundo plano después de cerrar Dashboard.

Solución de problemas comunes

Conflicto de puertos

Si algún reenvío de puerto no funciona, verifique:

1. ¿El puerto del anfitrión está ocupado?: Use netstat -ano | findstr :<número de puerto> para verificar.
2. Permisos de administrador: Algunos puertos (como los menores a 1024) pueden requerir permisos de administrador para escuchar.

Bloqueo de firewall

Aunque WSL Dashboard intentará configurar automáticamente las reglas, si tiene un firewall de terceros instalado (como Huorong, 360, etc.), es posible que necesite permitir manualmente el acceso a la red para wsldashboard.exe.