Настройки сети

WSL Dashboard упрощает настройку сетевого взаимодействия между WSL 2 и хост-системой (Windows), поддерживая переадресацию портов и глобальный HTTP-прокси.

Переадресация портов (Port Forwarding)

Поскольку WSL 2 использует виртуальный сетевой адаптер, доступ к внутренним сервисам WSL с других устройств локальной сети обычно сложен.

• Основная функция: можно сопоставить определённые порты Windows с портами внутри экземпляра WSL.
• Автоматические правила брандмауэра: при создании правил переадресации WSL Dashboard автоматически добавляет необходимые правила входящего трафика в брандмауэр Windows Defender, чтобы внешний трафик мог проходить.
• Параметры:
  • IP хоста: обычно 0.0.0.0 (слушать все сетевые адаптеры) или 127.0.0.1.
  • Порт хоста: порт, открываемый на стороне Windows.
  • Порт WSL: порт, который слушает внутренний сервис экземпляра.

Глобальный HTTP-прокси (HTTP Proxy)

Настройка прокси внутри WSL (например, когда git clone или apt install работают медленно) обычно требует изменения нескольких файлов конфигурации.

• Быстрая настройка: WSL Dashboard предоставляет переключатель глобального прокси.
• Как это работает: в соответствии с вашими настройками приложение автоматически конфигурирует переменные окружения прокси или параметры прокси соответствующих сервисов для выбранного экземпляра, избавляя от необходимости вручную получать IP хост-системы.
• Поддерживаемые протоколы: распространённые протоколы http:// и socks5://.

Мониторинг состояния сети

В панели сети можно в реальном времени просматривать:

• IP хоста WSL: IP-адрес виртуального сетевого адаптера Windows.
• IP экземпляра WSL: фактический адрес, назначенный внутри экземпляра.
• Активные подключения: мониторинг действующих правил переадресации портов и состояния трафика.

Расширенный сетевой режим (Mirrored Mode)

Для пользователей Windows 11 WSL 2 поддерживает «зеркальный» сетевой режим.

• Преимущества: зеркальный режим позволяет экземпляру WSL напрямую совместно использовать сетевые интерфейсы хост-системы, решая многие сложные проблемы VPN и локальной сети.
• Рекомендации по настройке: если вы включили зеркальный режим, переадресация портов WSL Dashboard по-прежнему работает, но вам, возможно, удобнее обращаться к сервисам напрямую через IP хост-системы.

Примечание

Установка auto_shutdown_distros = true в settings.toml гарантирует, что после закрытия Dashboard в фоне не останется бесполезных задач прослушивания сети.

Устранение частых проблем

Конфликт портов

Если переадресация какого-то порта не работает, проверьте:

1. Не занят ли порт хоста: проверьте командой netstat -ano | findstr :<номер-порта>.
2. Права администратора: для некоторых портов (например, ниже 1024) для прослушивания могут требоваться права администратора.

Блокировка брандмауэром

Хотя WSL Dashboard пытается автоматически настраивать правила, если у вас установлен сторонний брандмауэр (например, Huorong, 360 и т.п.), возможно, потребуется вручную разрешить сетевой доступ для wsldashboard.exe.