n1ro°
RU

Документы · Инструкция

WSL networkingMode=none: как полностью отключить сеть у WSL

У запроса «WSL networkingMode none» есть конкретная цель: нужен воспроизводимый офлайн-тест или временная изоляция. Ключ `networkingMode` полностью отключает сеть WSL. Правильная тактика — изменить один параметр, проверить эффект и только затем трогать соседние настройки.

Редакция N1RO · Проверено

Короткий ответ

В `%UserProfile%\.wslconfig` задайте `networkingMode=none`, затем выполните `wsl --shutdown` и снова запустите WSL. Режим глобально отключит dns, интернет и lan для wsl 2.

Что именно отключает `networkingMode=none`

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

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

Как включить офлайн-режим `networkingMode=none`

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

Предупреждение: Режим глобально отключит dns, интернет и lan для wsl 2. Если результат ухудшился, верните прежнее значение, снова выполните `wsl --shutdown` и повторите исходный тест.

Как убедиться, что WSL действительно остался без сети

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

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

Что проверить до офлайн-теста WSL

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

Как вернуть NAT после офлайн-теста

Для возврата сети удалите `networkingMode=none` или задайте `networkingMode=NAT`, сохраните `.wslconfig` и выполните `wsl --shutdown`. После нового запуска WSL вернётся к штатному NAT без переустановки дистрибутива.

Какая ошибка чаще всего мешает проверить `networkingMode`

Не меняйте одновременно соседние параметры `.wslconfig`. Если вместе с `networkingMode` изменить сеть, память или ядро, источник эффекта потеряется. Сначала меняйте только этот ключ, затем повторяйте тот же тест: проверьте отсутствие DNS и TCP/HTTPS-доступа, а затем верните NAT и повторите сетевой тест.

Когда режим `none` полезен, а когда мешает

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

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

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

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

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