Configuración de red

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

Reenvío de puertos (Port Forwarding)

Como WSL 2 usa un adaptador de red virtual, acceder a los servicios internos de WSL desde otros dispositivos de la red local suele resultar complicado.

• Función principal: puede mapear puertos específicos de Windows a puertos internos de la instancia WSL.
• Reglas de firewall automáticas: al crear una regla de reenvío, WSL Dashboard añade automáticamente las reglas de entrada necesarias al firewall de Windows Defender, garantizando que el tráfico externo pueda atravesarlo.
• Opciones de configuración:
  • IP del host: normalmente 0.0.0.0 (escucha en todos los adaptadores de red) o 127.0.0.1.
  • Puerto del host: el puerto abierto en el lado de Windows.
  • Puerto WSL: el puerto en el que escucha el servicio interno de la instancia.

Proxy HTTP global (HTTP Proxy)

Configurar un proxy dentro de WSL (por ejemplo, cuando git clone o apt install van lentos) normalmente exige modificar varios archivos de configuración.

• Configuración rápida: WSL Dashboard ofrece un interruptor de proxy global.
• Cómo funciona: según sus ajustes, configura automáticamente las variables de entorno del proxy o las opciones de proxy de los servicios correspondientes en la instancia seleccionada, ahorrándole la molestia de obtener manualmente la IP del host.
• Protocolos compatibles: los protocolos habituales http:// y socks5://.

Supervisión del estado de la red

Puede consultar en tiempo real en el panel de red:

• IP del host WSL: la IP del adaptador de red virtual de Windows.
• IP de la instancia WSL: la dirección realmente asignada dentro de la instancia.
• Conexiones activas: supervisa las reglas de reenvío de puertos vigentes y el estado del tráfico.

Modo de red avanzado (Mirrored Mode)

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

• Ventajas: el modo mirror permite que la instancia WSL comparta directamente la interfaz de red del host, resolviendo muchos problemas complejos de VPN o descubrimiento en la red local.
• Sugerencia de configuración: si ha activado el modo mirror, la función de reenvío de puertos de WSL Dashboard sigue funcionando, pero quizá prefiera acceder a los servicios directamente a través de la IP del host.

Consejo

Configurar auto_shutdown_distros = true en settings.toml garantiza que, al cerrar el Dashboard, no queden tareas de escucha de red inútiles en segundo plano.

Solución de problemas habituales

Conflicto de puertos

Si un reenvío de puerto no surte efecto, compruebe:

1. Si el puerto del host está ocupado: use netstat -ano | findstr :<número-de-puerto>.
2. Privilegios de administrador: algunos puertos (como los menores de 1024) pueden requerir permisos de administrador para escuchar.

Bloqueo por el firewall

Aunque WSL Dashboard intenta configurar las reglas automáticamente, si ha instalado un firewall de terceros (como Huorong, 360, etc.), es posible que deba permitir manualmente el acceso de red de wsldashboard.exe.