Настройка дополнительных параметров в WSL

Файлы wsl.conf и WSLconfig используются для настройки дополнительных параметров на основе распределения (wsl.conf) и глобально во всех дистрибутивах WSL 2 (.wslconfig). В этом руководстве рассматриваются все параметры параметров, когда следует использовать каждый тип файла, где хранить файл, примеры файлов параметров и советы.

Какова разница между wsl.conf и Wslconfig?

Вы можете настроить параметры установленных дистрибутивов Linux, которые будут автоматически применяться при каждом запуске WSL двумя способами:

• .wslconfig для настройки глобальных параметров во всех установленных дистрибутивах, работающих в WSL 2.
• wsl.conf для настройки локальных параметров для каждого дистрибутива Linux, работающего в WSL 1 или WSL 2.

Оба типа файлов используются для настройки параметров WSL, но расположение, в котором хранится файл, область конфигурации, тип параметров, которые можно настроить, и версию WSL, на которой выполняется распределение, все влияет на выбранный тип файла.

WSL 1 и WSL 2 выполняются с другой архитектурой и влияют на параметры конфигурации. WSL 2 выполняется как упрощенная виртуальная машина, поэтому использует параметры виртуализации, позволяющие управлять объемом памяти или процессорами (которые могут быть знакомы при использовании Hyper-V или VirtualBox). Проверьте, какая версия WSL запущена.

Второе правило для изменений конфигурации

Необходимо ждать, пока подсистема, на котором работает дистрибутив Linux, полностью перестает работать и перезапускается, чтобы обновления параметров конфигурации отображались. Обычно это занимает около 8 секунд после закрытия ВСЕХ экземпляров оболочки распространения.

Если вы запускаете дистрибутив (например, Ubuntu), измените файл конфигурации, закройте дистрибутив, а затем повторно запустите его, вы можете предположить, что изменения конфигурации сразу же вступили в силу. В настоящее время это не так, как подсистема по-прежнему может работать. Необходимо дождаться остановки подсистемы, прежде чем перезапускать, чтобы дать достаточно времени для получения изменений. Вы можете проверить, работает ли дистрибутив Linux (оболочка) после закрытия с помощью PowerShell с помощью команды: wsl --list --running Если дистрибутивы не выполняются, вы получите ответ :"Нет запущенных дистрибутивов". Теперь можно перезапустить дистрибутив, чтобы увидеть примененные обновления конфигурации.

Команда wsl --shutdown — это быстрый путь к перезапуску дистрибутивов WSL 2, но он завершит работу всех запущенных дистрибутивов, поэтому используйте мудро. Вы также можете использовать wsl --terminate <distroName> для немедленного завершения конкретного дистрибутива.

wsl.conf

Настройте локальные параметры с помощью wsl.conf для каждого дистрибутива Linux, работающего в WSL 1 или WSL 2.

• Хранится в каталоге дистрибутива в /etc виде unix-файла.
• Используется для настройки параметров на основе распределения. Параметры, настроенные в этом файле, будут применены только к конкретному дистрибутиву Linux, содержаму каталог, в котором хранится этот файл.
• Можно использовать для дистрибутивов, выполняемых любой версией, WSL 1 или WSL 2.
• Чтобы перейти к /etc каталогу для установленного дистрибутива, используйте командную строку дистрибутива, cd / чтобы получить доступ к корневому каталогу, а затем ls перечислить файлы или explorer.exe . просмотреть в Windows проводник. Путь к каталогу должен выглядеть примерно так: /etc/wsl.conf

Параметры конфигурации для wsl.conf

Файл wsl.conf настраивает параметры на основе распределения. (Глобальная конфигурация дистрибутивов WSL 2 см . в .wslconfig).

Файл wsl.conf поддерживает четыре раздела: automount, , networkinteropи user. (С моделью после .ini соглашений о файлах ключи объявляются в разделе, например файлы gitconfig.) Сведения о том, где хранить файл wsl.conf, см. в разделе wsl.conf .

системная поддержка

Многие дистрибутивы Linux по умолчанию запускают "systemd" (включая Ubuntu) и WSL недавно добавили поддержку для этого system/service manager, чтобы WSL был еще более похож на использование любимых дистрибутивов Linux на компьютере без операционной системы. Для включения systemd вам потребуется версия 0.67.6+ WSL. Проверьте версию WSL с помощью команды wsl --version. Если вам нужно обновить, вы можете получить последнюю версию WSL в Microsoft Store. Дополнительные сведения см. в объявлении блога.

Чтобы включить системный файл, откройте wsl.conf файл в текстовом редакторе, используя sudo разрешения администратора, и добавьте следующие строки в /etc/wsl.conf:

[boot]
systemd=true

Затем необходимо закрыть дистрибутив WSL с помощью wsl.exe --shutdown PowerShell, чтобы перезапустить экземпляры WSL. После перезапуска дистрибутива система должна выполняться. Вы можете подтвердить с помощью команды: systemctl list-unit-files --type=serviceкоторая будет отображать состояние служб.

Параметры автоматического отключения

Метка раздела wsl.conf: [automount]

Параметры автоматического подключения применяются в качестве параметров подключения для всех автоматически подключенных дисков. Чтобы изменить параметры только для определенного диска, используйте /etc/fstab вместо него файл. Параметры, которые двоичный файл подключения обычно анализирует и преобразовывает во флаг, не поддерживаются. Если вы хотите явно указать эти параметры, необходимо включить каждый диск, для которого вы хотите сделать это /etc/fstab.

Параметры автоматического отключения

Задание различных параметров подключения для дисков Windows (DrvFs) позволяет контролировать определение разрешений для файлов Windows. Имеются следующие варианты:

По умолчанию WSL задает пользовательское и гидд-значение пользователя по умолчанию. Например, в Ubuntu пользователь по умолчанию используется uid=1000, gid=1000. Если это значение используется для указания другого параметра gid или uid, значение пользователя по умолчанию будет перезаписан. В противном случае всегда будет добавляться значение по умолчанию.

Маска режима создания пользовательских файлов (umask) задает разрешение для вновь созданных файлов. Значение по умолчанию — 022, только вы можете записывать данные, но любой пользователь может считывать данные. Значения можно изменить, чтобы отразить различные параметры разрешений. Например, umask=077 изменение разрешения на полное частное, ни один другой пользователь не может считывать или записывать данные. Чтобы дополнительно указать разрешение, можно также использовать fmask (файлы) и dmask (каталоги).

Что такое DrvFs?

DrvFs — это подключаемый модуль файловой системы к WSL, который был разработан для поддержки взаимодействия между WSL и файловой системой Windows. DrvFs позволяет WSL подключать диски с поддерживаемыми файловыми системами в разделе /mnt, например /mnt/c, /mnt/d и т. д. Дополнительные сведения об указании поведения конфиденциальности регистра по умолчанию при подключении дисков или каталогов Windows или Linux см. на странице конфиденциальности регистра.

Параметры сети

Метка раздела wsl.conf: [network]

Параметры взаимодействия

Метка раздела wsl.conf: [interop]

Эти параметры доступны в выпусках для программы предварительной оценки, начиная со сборки 17713.

Параметры пользователя

Метка раздела wsl.conf: [user]

Эти параметры доступны в сборке 18980 и более поздних версиях.

Параметры загрузки

Параметр загрузки доступен только в Windows 11 и Server 2022.

Метка раздела wsl.conf: [boot]

Пример файла wsl.conf

Приведенный wsl.conf ниже пример файла демонстрирует некоторые доступные параметры конфигурации. В этом примере дистрибутив — Ubuntu-20.04, а путь к файлу — \\wsl.localhost\Ubuntu-20.04\etc\wsl.conf.

# Automatically mount Windows drive when the distribution is launched
[automount]

# Set to true will automount fixed drives (C:/ or D:/) with DrvFs under the root directory set above. Set to false means drives won't be mounted automatically, but need to be mounted manually or with fstab.
enabled = true

# Sets the directory where fixed drives will be automatically mounted. This example changes the mount location, so your C-drive would be /c, rather than the default /mnt/c. 
root = /

# DrvFs-specific options can be specified.  
options = "metadata,uid=1003,gid=1003,umask=077,fmask=11,case=off"

# Sets the `/etc/fstab` file to be processed when a WSL distribution is launched.
mountFsTab = true

# Network host settings that enable the DNS server used by WSL 2. This example changes the hostname, sets generateHosts to false, preventing WSL from the default behavior of auto-generating /etc/hosts, and sets generateResolvConf to false, preventing WSL from auto-generating /etc/resolv.conf, so that you can create your own (ie. nameserver 1.1.1.1).
[network]
hostname = DemoHost
generateHosts = false
generateResolvConf = false

# Set whether WSL supports interop processes like launching Windows apps and adding path variables. Setting these to false will block the launch of Windows processes and block adding $PATH environment variables.
[interop]
enabled = false
appendWindowsPath = false

# Set the user when launching a distribution with WSL.
[user]
default = DemoUser

# Set a command to run when a new WSL instance launches. This example starts the Docker container service.
[boot]
command = service docker start

.wslconfig

Настройте глобальные параметры с помощью WSLconfig во всех установленных дистрибутивах, работающих в WSL.

• WSLCONFIG-файл по умолчанию не существует. Его необходимо создать и сохранить в %UserProfile% каталоге, чтобы применить эти параметры конфигурации.
• Используется для глобальной настройки параметров во всех установленных дистрибутивах Linux, работающих в качестве версии WSL 2.
• Можно использовать только для дистрибутивов, выполняемых WSL 2. Дистрибутивы, работающие как WSL 1, не будут затронуты этой конфигурацией, так как они не работают в качестве виртуальной машины.
• Чтобы перейти к %UserProfile% каталогу, в PowerShell используйте cd ~ для доступа к домашнему каталогу (который обычно является вашим профилем пользователя) C:\Users\<UserName>или открыть Windows проводник и ввести %UserProfile% в адресной строке. Путь к каталогу должен выглядеть примерно так: C:\Users\<UserName>\.wslconfig

WSL обнаруживает существование этих файлов, считывает содержимое и автоматически применяет параметры конфигурации при каждом запуске WSL. Если файл отсутствует или поврежден (неправильное форматирование разметки), WSL продолжит запускаться как обычный без применения параметров конфигурации.

Параметры конфигурации для WSLconfig

WSLconfig-файл настраивает параметры глобально для всех дистрибутивов Linux, работающих с WSL 2. (Сведения о конфигурации для каждого дистрибутива см. в wsl.conf).

Сведения о том, где хранить wslconfig-файл wslconfig, см . в .wslconfig .

Этот файл может содержать следующие параметры, влияющие на виртуальную машину, которая управляет любым дистрибутивом WSL 2:

Основные параметры WSL

Метка раздела wslconfig: [wsl2]

Записи со path значением должны быть путями Windows с экранируемыми обратными косыми чертами, например: C:\\Temp\\myCustomKernel

Записи со size значением должны быть размером, за которым следует единица, например 8GB или 512MB.

Записи со значением * после того, как тип значения доступен только в Windows 11.

Записи с ** после типа значения требуют Windows 11 версии 22H2 или более поздней.

Экспериментальные параметры

Эти параметры являются предварительными версиями экспериментальных функций, которые мы стремимся сделать по умолчанию в будущем.

Метка раздела wslconfig: [experimental]

Записи со значением * после того, как тип значения доступен только в Windows 11.

Записи с ** после типа значения требуют Windows версии 22H2 или более поздней.

Пример Wslconfig-файла

Приведенный .wslconfig ниже пример файла демонстрирует некоторые доступные параметры конфигурации. В этом примере путь к файлу имеет значение C:\Users\<UserName>\.wslconfig.

# Settings apply across all Linux distros running on WSL 2
[wsl2]

# Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
memory=4GB 

# Sets the VM to use two virtual processors
processors=2

# Specify a custom Linux kernel to use with your installed distros. The default kernel used can be found at https://github.com/microsoft/WSL2-Linux-Kernel
kernel=C:\\temp\\myCustomKernel

# Sets additional kernel parameters, in this case enabling older Linux base images such as Centos 6
kernelCommandLine = vsyscall=emulate

# Sets amount of swap storage space to 8GB, default is 25% of available RAM
swap=8GB

# Sets swapfile path location, default is %USERPROFILE%\AppData\Local\Temp\swap.vhdx
swapfile=C:\\temp\\wsl-swap.vhdx

# Disable page reporting so WSL retains all allocated memory claimed from Windows and releases none back when free
pageReporting=false

# Turn on default connection to bind WSL 2 localhost to Windows localhost. Setting is ignored when networkingMode=mirrored
localhostforwarding=true

# Disables nested virtualization
nestedVirtualization=false

# Turns on output console showing contents of dmesg when opening a WSL 2 distro for debugging
debugConsole=true

# Enable experimental features
[experimental]
sparseVhd=true

Дополнительные ресурсы

• Блог командной строки Windows: автоматическая настройка WSL
• Блог командной строки Windows: Chmod/Chown, DrvFs, метаданные файлов