Текст и данные · Инструкция
WSL loadKernelModules: автозагрузка дополнительных модулей ядра
WSL loadKernelModules — точечная настройка WSL 2, а не универсальное ускорение системы. Ключ `loadKernelModules` загружает дополнительные модули из списка через запятую при старте. Менять его стоит, когда модуль уже доступен, но приходится вручную делать modprobe.
Короткий ответ
В `%UserProfile%\.wslconfig` задайте `loadKernelModules=module_a,module_b`, затем выполните `wsl --shutdown` и снова запустите WSL. Имена должны существовать для текущего ядра.
Что делает `loadKernelModules` в WSL 2
`loadKernelModules` относится к глобальным настройкам WSL 2. Загружает дополнительные модули из списка через запятую при старте. Это не то же самое, что `/etc/wsl.conf`: тот файл относится к отдельному дистрибутиву, а `.wslconfig` лежит в профиле Windows. Практический смысл настройки появляется, когда модуль уже доступен, но приходится вручную делать modprobe. Если измеримого симптома нет, значение по умолчанию обычно лучше дополнительной нестандартной переменной. Перед изменением запишите текущее состояние и тест, по которому будете сравнивать результат.
Совет: Сохраните копию `.wslconfig` и меняйте один ключ за раз. Так проще понять, что именно повлияло на систему.
Как задать `loadKernelModules` и применить конфигурацию
- Откройте PowerShell и выполните `notepad $env:USERPROFILE\.wslconfig`; если файла нет, создайте его без расширения `.txt`.
- В секции `[wsl2]` добавьте `loadKernelModules=module_a,module_b`. Если `loadKernelModules` уже есть, измените существующую строку, а не создавайте дубликат.
- Сохраните файл и закройте работающие Linux-процессы, чтобы не потерять несохранённую работу.
- В Windows выполните `wsl --shutdown`. Простого закрытия окна терминала недостаточно, потому что VM может продолжать работать.
- Запустите дистрибутив снова и проверьте результат: проверьте `modinfo`, затем `lsmod` после старта и функцию, для которой нужен модуль.
Предупреждение: Имена должны существовать для текущего ядра. Если результат ухудшился, верните прежнее значение, снова выполните `wsl --shutdown` и повторите исходный тест.
Как проверить эффект `loadKernelModules` после перезапуска
Не меняйте одновременно память, сеть, ядро и `loadKernelModules`. Сначала воспроизведите проблему, зафиксируйте результат, затем примените только эту правку. После перезапуска выполните тот же сценарий: проверить `lsmod`, `modinfo` и целевую функцию. Если улучшение не повторяется, причина может быть в службе дистрибутива, Windows-драйвере, VPN, файловой системе или другой части стека. Возврат к дефолту уменьшит число переменных и упростит следующую диагностику. Для длительного использования оставляйте параметр только при устойчивом, понятном результате.
Важно: Критерий успеха должен быть измеримым: время старта, число CPU, доступность сети, наличие модуля или созданный лог, а не ощущение «стало лучше».
Что зафиксировать до изменения `loadKernelModules`
Перед правкой выполните `wsl -l -v` и запишите исходное поведение. Для `loadKernelModules` важно иметь один повторяемый тест: проверьте `modinfo`, затем `lsmod` после старта и функцию, для которой нужен модуль. Это позволит сравнить состояние до и после, а не оценивать изменение по общему впечатлению.
Как откатить `loadKernelModules` без переустановки дистрибутива
Верните прежнюю строку или удалите явный `loadKernelModules`, сохраните `.wslconfig` и выполните `wsl --shutdown`. После нового запуска WSL снова применит значение по умолчанию: не задан. Файлы Linux при таком откате не удаляются.
Какая ошибка чаще всего мешает проверить `loadKernelModules`
Не меняйте одновременно соседние параметры `.wslconfig`. Если вместе с `loadKernelModules` изменить сеть, память или ядро, источник эффекта потеряется. Сначала меняйте только этот ключ, затем повторяйте тот же тест: проверьте `modinfo`, затем `lsmod` после старта и функцию, для которой нужен модуль.
Когда оставить `loadKernelModules`, а когда откатить
- `.wslconfig` находится в `%UserProfile%` Windows
- настройка относится к WSL 2, а не WSL 1
- после изменения выполнен `wsl --shutdown`
- проверена именно исходная задача, а не случайный соседний симптом
- старое значение сохранено для быстрого отката
Что учитывать
Условия меняются. Страница отражает состояние на 2026-09-23; при расхождении с официальной документацией приоритет у первоисточника.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Advanced settings configuration in WSL). Пример и формулировки — редакция N1RO на 2026-09-23.