WSL bridged networking устарел: чем заменить режим bridged

Что делает `networkingMode` в WSL 2

`networkingMode` относится к глобальным настройкам WSL 2. Выбирает сетевой режим; bridged помечен microsoft как deprecated с wsl 2.4.5. Это не то же самое, что `/etc/wsl.conf`: тот файл относится к отдельному дистрибутиву, а `.wslconfig` лежит в профиле Windows. Практический смысл настройки появляется, когда старый конфиг bridged перестал подходить после обновления. Если измеримого симптома нет, значение по умолчанию обычно лучше дополнительной нестандартной переменной. Перед изменением запишите текущее состояние и тест, по которому будете сравнивать результат.

Совет: Сохраните копию `.wslconfig` и меняйте один ключ за раз. Так проще понять, что именно повлияло на систему.

Как задать `networkingMode` и применить конфигурацию

1. Откройте PowerShell и выполните `notepad $env:USERPROFILE\.wslconfig`; если файла нет, создайте его без расширения `.txt`.
2. В секции `[wsl2]` добавьте `networkingMode=mirrored`. Если `networkingMode` уже есть, измените существующую строку, а не создавайте дубликат.
3. Сохраните файл и закройте работающие Linux-процессы, чтобы не потерять несохранённую работу.
4. В Windows выполните `wsl --shutdown`. Простого закрытия окна терминала недостаточно, потому что VM может продолжать работать.
5. Запустите дистрибутив снова и проверьте результат: проверьте `ip addr`, DNS, VPN и тот входящий порт, ради которого раньше использовался bridged.

Предупреждение: Mirrored, nat и consomme не являются полностью взаимозаменяемыми. Если результат ухудшился, верните прежнее значение, снова выполните `wsl --shutdown` и повторите исходный тест.

Как проверить эффект `networkingMode` после перезапуска

Не меняйте одновременно память, сеть, ядро и `networkingMode`. Сначала воспроизведите проблему, зафиксируйте результат, затем примените только эту правку. После перезапуска выполните тот же сценарий: проверить DNS, LAN и Windows↔Linux соединения. Если улучшение не повторяется, причина может быть в службе дистрибутива, Windows-драйвере, VPN, файловой системе или другой части стека. Возврат к дефолту уменьшит число переменных и упростит следующую диагностику. Для длительного использования оставляйте параметр только при устойчивом, понятном результате.

Важно: Критерий успеха должен быть измеримым: время старта, число CPU, доступность сети, наличие модуля или созданный лог, а не ощущение «стало лучше».

Что зафиксировать до изменения `networkingMode`

Перед правкой выполните `wsl -l -v` и запишите исходное поведение. Для `networkingMode` важно иметь один повторяемый тест: проверьте `ip addr`, DNS, VPN и тот входящий порт, ради которого раньше использовался bridged. Это позволит сравнить состояние до и после, а не оценивать изменение по общему впечатлению.

Как откатить `networkingMode` без переустановки дистрибутива

Верните прежнюю строку или удалите явный `networkingMode`, сохраните `.wslconfig` и выполните `wsl --shutdown`. После нового запуска WSL снова применит значение по умолчанию: NAT. Файлы Linux при таком откате не удаляются.

Когда оставить `networkingMode`, а когда откатить

• `.wslconfig` находится в `%UserProfile%` Windows
• настройка относится к WSL 2, а не WSL 1
• после изменения выполнен `wsl --shutdown`
• проверена именно исходная задача, а не случайный соседний симптом
• старое значение сохранено для быстрого отката

Что учитывать

Условия меняются. Страница отражает состояние на 2026-09-23; при расхождении с официальной документацией приоритет у первоисточника.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-23.

• Advanced settings configuration in WSL