SWAP — как создать, подключить, очистить и отключить файл подкачки в Linux

Что такое SWAP

SWAP (своп) — это механизм виртуальной памяти, при котором часть данных из оперативной памяти (ОЗУ) перемещается на хранение на HDD (жёсткий диск), SSD (твёрдотельный накопитель), флеш-накопитель или иное вторичное хранилище. Как правило, swapping (свопинг) происходит, когда оперативная память переполнена, и ей для работы требуется дополнительное пространство.

Когда может понадобиться своп

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

1. Постоянное падение сайта: Ошибка соединения с базой данных — означает, например, что MySQL упал;
2. При внимательном изучении логов /var/log/mysql.log обнаруживается ошибка InnoDB: Fatal error: cannot allocate memory for the buffer pool . Она свидетельствует о том, что базе данных не хватает выделенной ей оперативной памяти для создания буфера.

При подобных симптомах и ошибках может помочь своппинг.

Преимущества SWAP

Сравнение стоимости оперативной памяти и SSD
(цены актуальны на 7 июля 2017 года)	IHOR	FirstVDS
Оперативная память, в среднем за 1 гигабайт	100 рублей в месяц	170 рублей в месяц
SSD, в среднем за 1 гигабайт	10 рублей в месяц	13 рублей в месяц

Как видно из таблицы, экономия выйдет примерно в 10 раз.

Недостатки SWAP

SWAP — это не замена оперативной памяти, а всего лишь его поддержка.

Как создать и подключить файл подкачки SWAP

Далее, в работе используется командная строка SSH.
Инструментарий: Far Manager или Putty.
Для примера приводятся команды из под root . Если Вы работаете не под root , перед командами задавайте префикс sudo

Проверка наличия свопа в системе

Для начала, нужно убедиться, что своп ещё не подключен:

Если команда выдала пустой результат или что-то навроде:

— значит, своп, скорее всего отсутствует.

Дополнительно проверим командой:

Если в таблице в строке swap стоит 0, значит своп отсутствует.

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

Теперь, надо проверить, сколько свободного места есть на диске:

В результате, мы увидим что-то подобное:

Как мы видим, доступно 9 гигабайт дискового пространства — вполне достаточно, чтобы создать своп-файл.

Какого размера создать swap

Исходите из принципа — сколько может понадобиться, столько и выделяйте. Как правило, можно начинать с размера объёма оперативной памяти, либо его удвоенного количества. Например, если у вас в системе 2 гигабайта оперативки, своп можно сделать размером 2-4 гигабайта, как правило, этого должно хватать. Но, Вы можете скорректировать его размер под себя.

Создание файла SWAP

Допустим, мы хотим создать swap-файл размером 4 гигабайта.
Далее, здесь существует 2 подхода, традиционный медленный и новый быстрый:

Быстрый способ Используем fallocate :

Результатом будет пустая строка, это нормально.
В отличие от dd , результат будет получен почти сразу, и я рекомендую именно его. Традиционный, медленный способ Или используем команду:

Синтаксис команды простой:

• dd — команда предназначена для того, чтобы что-то куда-то копировать побайтово;
• if=/dev/zero — указывает на источник, т.е. на то, откуда копируем, в данном случае из /dev/zero — это специальный файл в UNIX-подобных системах, представляющий собой источник нулевых байтов;
• of=/swapfile — указывает путь назначения, куда копируем данные;
• bs=1G — количество байт, которые будут записаны за раз. В нашем случае, 1 гигабайт. Обозначения: G — гигабайт, M — мегабайт, K — килобайт, и так далее;
• count=4 — сколько блоков размером с bs будет создано, в нашем случае 4.

Будьте очень внимательны с синтаксисом команды, потому что если, например, ошибиться с определением пути для of= (куда сохранять файл), можно повредить данные на диске.

Теперь, когда файл создан, проверим результат:

В результате увидим:
-rw-r—r— 1 root root 4.0G Jul 07 16:16 /swapfile
Как видим, файл создался верно и с нужным объёмом.

Как подключить SWAP файл

Для начала, ограничим права доступа к вновь созданному файлу.

Предоставление другим пользователям возможности читать или писать в этот файл будет представлять собой огромный риск для безопасности, поэтому ограничение командой ниже строго обязательно:

В результате, мы должны увидеть подобное:
-rw——- 1 root root 4.0G Jul 07 16:16 /swapfile
Права прописаны верно.

Теперь нужно сделать из swapfile файл подкачки:

В результате, увидим примерно следующее:
Setting up swapspace version 1, size = 4193300 KiB
no label, UUID=e5f3e9cf-c1a9-4ed4-b8ab-711b6a7d6544

Теперь, файл готов в роли свопа. Подключим его к системе:

Если на данном этапе выходит похожая ошибка, значит, скорее всего, своп запрещено подключать в систему. Такое ограничение часто ставят на VDS с виртуализацией OpenVZ. Рекомендую использовать IHOR, сервера от 100 рублей в месяц и виртуализация KVM позволяют включать SWAP.

Всё, теперь своп подключен и работает. Осталось проверить правильность работы самой первой командой:

Своп также будет виден в стандартных командах:

Всё, теперь точно, своп в системе готов и будет использоваться при необходимости.

Добавление свопа в автозагрузку

Чтобы при перезагрузке сервера своп автоматически подтягивался в систему, нужно прописать его в /etc/fstab :

Теперь система знает, где и как при перезагрузке искать и подключать своп.
Проверить, подключен ли своп в автозагрузке, можно с помощью редактора:

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

Как очистить SWAP в Linux

Вообще, это делается с помощью отключения и включения свопа.

Однако, я не рекомендую прибегать к этому способу, так как swap просто очищается, а не переносится в ОЗУ, и, в случае наличия данных системных процессов, система может стать недоступна.

Команды WSL и конфигурации запуска WSL commands and launch configurations

Способы запуска WSL Ways to run WSL

Существует несколько способов запустить дистрибутив Linux с WSL после установки. There are several ways to run a Linux distribution with WSL once it’s installed.

1. Откройте дистрибутив Linux, перейдя в меню Пуск Windows и введя имя установленных дистрибутивов. Open your Linux distribution by visiting the Windows Start menu and typing the name of your installed distributions. Например: Ubuntu. For example: «Ubuntu».
2. В командной строке Windows или PowerShell введите имя установленного дистрибутива. From Windows Command Prompt or PowerShell, enter the name of your installed distribution. Например: ubuntu For example: ubuntu
3. В командной строке Windows или PowerShell чтобы открыть дистрибутив Linux по умолчанию в текущей командной строке, введите: wsl.exe . From Windows Command Prompt or PowerShell, to open your default Linux distribution inside your current command line, enter: wsl.exe .
4. В командной строке Windows или PowerShell чтобы открыть дистрибутив Linux по умолчанию в текущей командной строке, введите: wsl [command] . From Windows Command Prompt or PowerShell, to open your default Linux distribution inside your current command line, enter: wsl [command] .

Применяемый метод зависит от того, что вы делаете. Which method you should use depends on what you’re doing. Если вы открыли командную строку WSL в командной строке Windows или окне PowerShell и хотите выйти, введите команду: exit . If you’ve opened a WSL command line within a Windows Prompt or PowerShell window and want to exit, enter the command: exit .

Запуск WSL с помощью дистрибутива Launch WSL by distribution

При запуске дистрибутива с помощью специального приложения он запускается в собственном окне консоли. Running a distribution using it’s distro-specific application launches that distribution in it’s own console window.

Это то же самое, что нажать кнопку «Запустить» в Microsoft Store. It is the same as clicking «Launch» in the Microsoft store.

Можно также запустить дистрибутив из командной строки, выполнив команду [distribution].exe . You can also run the distribution from the command line by running [distribution].exe .

Недостаток запуска дистрибутива из командной строки заключается в том, что при этом рабочим каталогом станет не текущий каталог, а корневой каталог дистрибутива. The disadvantage of running a distribution from the command line in this way is that it will automatically change your working directory from the current directory to the distribution’s home directory.

Пример: (с помощью PowerShell) Example: (using PowerShell)

Использование wsl и wsl [команда] wsl and wsl [command]

Лучший способ запуска WSL из командной строки — использовать wsl.exe . The best way to run WSL from the command line is using wsl.exe .

Пример: (с помощью PowerShell) Example: (using PowerShell)

Инструмент wsl не только сохраняет текущий рабочий каталог, но и позволяет выполнить одну команду помимо команд Windows. Not only does wsl keep the current working directory in place, it lets you run a single command along side Windows commands.

Пример: (с помощью PowerShell) Example: (using PowerShell)

Пример: (с помощью PowerShell) Example: (using PowerShell)

Управление несколькими дистрибутивами Linux Managing multiple Linux Distributions

В Windows 10 версии 1903 и более позднихможно использовать wsl.exe для управления дистрибутивами в подсистеме Windows для Linux (WSL), включая список доступных дистрибутивов, настройку распределения по умолчанию и удаление дистрибутивов. In Windows 10 Version 1903 and later, you can use wsl.exe to manage your distributions in the Windows Subsystem for Linux (WSL), including listing available distributions, setting a default distribution, and uninstalling distributions.

Каждый дистрибутив Linux независимо управляет собственными конфигурациями. Each Linux distribution independently manages its own configurations. Чтобы просмотреть команды, относящиеся к определенному дистрибутиву, выполните команду [distro.exe] /? . To see distribution-specific commands, run [distro.exe] /? . Например, ubuntu /? . For example ubuntu /? .

Вывод списка дистрибутивов List distributions

wsl -l , wsl —list wsl -l , wsl —list
Выводит список доступных дистрибутивов Linux, совместимых с WSL. Lists available Linux distributions available to WSL. Если дистрибутив есть в списке, он установлен и готов к использованию. If a distribution is listed, it’s installed and ready to use.

wsl —list —all Список всех дистрибутивов, включая те, которые сейчас не используются. wsl —list —all Lists all distributions, including ones that aren’t currently usable. Они могут находиться в процессе установки, удаления или в неработающем состоянии. They may be in the process of installing, uninstalling, or are in a broken state.

wsl —list —running Список всех распределений, выполняемых в данный момент. wsl —list —running Lists all distributions that are currently running.

Настройка дистрибутива по умолчанию Set a default distribution

Дистрибутив по умолчанию WSL запускается при выполнении wsl в командной строке. The default WSL distribution is the one that runs when you run wsl on a command line.

wsl -s , wsl —setdefault wsl -s , wsl —setdefault

Задает для дистрибутив по умолчанию с помощью значения . Sets the default distribution to .

Пример: (с помощью PowerShell) Example: (using PowerShell)
Команда wsl -s Ubuntu в качестве дистрибутива по умолчанию установит Ubuntu. wsl -s Ubuntu would set my default distribution to Ubuntu. Теперь при выполнении wsl npm init эта команда будет выполняться в Ubuntu. Now when I run wsl npm init it will run in Ubuntu. Если выполнить wsl , откроется сеанс Ubuntu. If I run wsl it will open an Ubuntu session.

Отмена регистрации и повторная установка дистрибутива Unregister and reinstall a distribution

Хотя дистрибутивы Linux можно устанавливать из Microsoft Store, их невозможно удалить в Store. While Linux distributions can be installed through the Microsoft store, they can’t be uninstalled through the store. С помощью WSL Config можно отменить регистрацию дистрибутивов или удалить их. WSL Config allows distributions to be unregistered/uninstalled.

Отмена регистрации также позволяет переустановить дистрибутивы. Unregistering also allows distributions to be reinstalled.

Внимание! После отмены регистрации все данные, параметры и программное обеспечение, связанные с этим распределением, будут безвозвратно утеряны. Caution: Once unregistered, all data, settings, and software associated with that distribution will be permanently lost. При переустановке из Store будет установлена чистая копия дистрибутива. Reinstalling from the store will install a clean copy of the distribution.

wsl —unregister
Отменяет регистрацию дистрибутива в WSL, чтобы его можно было переустановить или очистить. Unregisters the distribution from WSL so it can be reinstalled or cleaned up.

Например: wsl —unregister Ubuntu приведет к удалению Ubuntu из дистрибутивов, доступных в WSL. For example: wsl —unregister Ubuntu would remove Ubuntu from the distributions available in WSL. При выполнении команды wsl —list этот дистрибутив не будет присутствовать в списке. When I run wsl —list it will not be listed.

Чтобы переустановить его, найдите этот дистрибутив в Microsoft Store и нажмите кнопку «Запустить». To reinstall, find the distribution in the Microsoft store and select «Launch».

Выполнение от имени определенного пользователя Run as a specific user

wsl -u , wsl —user wsl -u , wsl —user

Выполняет WSL от имени указанного пользователя. Run WSL as the specified user. Обратите внимание на то, что этот пользователь должен существовать в дистрибутиве WSL. Please note that user must exist inside of the WSL distribution.

Изменение пользователя по умолчанию для распределения Change the default user for a distribution

Изменение пользователя по умолчанию, который используется для входа в дистрибутив. Change the default user that for your distribution log-in. Пользователь должен уже существовать в распределении, чтобы стать пользователем по умолчанию. The user has to already exist inside the distribution in order to become the default user.

Например, ubuntu config —default-user johndoe изменит пользователя по умолчанию для дистрибутива Ubuntu на пользователя «JohnDoe». For example: ubuntu config —default-user johndoe would change the default user for the Ubuntu distribution to the «johndoe» user.

Если у вас возникли проблемы с определением имени дистрибутива, см. Список дистрибутивов для команды, чтобы получить список официальных названий установленных дистрибутивов. If you are having trouble figuring out the name of your distribution, see List distributions for the command to list the official name of the installed distributions.

Запуск определенного дистрибутива Run a specific distribution

wsl -d , wsl —distribution wsl -d , wsl —distribution

Запускает указанный дистрибутив WSL. Эту команду можно использовать для отправки команд в определенный дистрибутив без необходимости изменения дистрибутива по умолчанию. Run a specified distribution of WSL, can be used to send commands to a specific distribution without having to change your default.

Управление несколькими дистрибутивами Linux в более ранних версиях Windows Managing multiple Linux Distributions in earlier Windows versions

В Windows 10 до версии 1903 программа командной строки WSL config ( wslconfig.exe ) должна использоваться для управления дистрибутивами Linux, работающими в подсистеме Windows для Linux (WSL). In Windows 10 prior to version 1903, the WSL Config ( wslconfig.exe ) command-line tool should be used to manage Linux distributions running on the Windows Subsystem for Linux (WSL). Она позволяет получить список доступных дистрибутивов, настроить дистрибутив по умолчанию и удалить дистрибутивы. It lets you list available distributions, set a default distribution, and uninstall distributions.

Хотя WSL Config удобно использовать для параметров, охватывающих или координирующих несколько дистрибутивов, каждый дистрибутив Linux независимо управляет собственными конфигурациями. While WSL Config is helpful for settings that span or coordinate distributions, each Linux distribution independently manages its own configurations. Чтобы просмотреть команды, относящиеся к определенному дистрибутиву, выполните команду [distro.exe] /? . To see distribution-specific commands, run [distro.exe] /? . Например, ubuntu /? . For example ubuntu /? .

Чтобы просмотреть все доступные параметры для wslconfig, выполните команду wslconfig /? To see all available options for wslconfig, run: wslconfig /?

Чтобы вывести список дистрибутивов, используйте: To list distributions, use:

wslconfig /list
Выводит список доступных дистрибутивов Linux, совместимых с WSL. Lists available Linux distributions available to WSL. Если дистрибутив есть в списке, он установлен и готов к использованию. If a distribution is listed, it’s installed and ready to use.

wslconfig /list /all
Выводит список всех дистрибутивов, включая те, которые сейчас не используются. Lists all distributions, including ones that aren’t currently usable. Они могут находиться в процессе установки, удаления или в неработающем состоянии. They may be in the process of installing, uninstalling, or are in a broken state.

Настройка распределения по умолчанию, выполняемого при выполнении wsl в командной строке: To set a default distribution that runs when you run wsl on a command line:

wslconfig /setdefault Задает для распределения по умолчанию значение . wslconfig /setdefault Sets the default distribution to .

Пример: (с помощью PowerShell) Example: (using PowerShell)
Команда wslconfig /setdefault Ubuntu в качестве дистрибутива по умолчанию установит Ubuntu. wslconfig /setdefault Ubuntu would set my default distribution to Ubuntu. Теперь при выполнении wsl npm init эта команда будет выполняться в Ubuntu. Now when I run wsl npm init it will run in Ubuntu. Если выполнить wsl , откроется сеанс Ubuntu. If I run wsl it will open an Ubuntu session.

Чтобы отменить регистрацию и переустановить распространение, выполните следующие действия. To unregister and reinstall a distribution:

wslconfig /unregister
Отменяет регистрацию дистрибутива в WSL, чтобы его можно было переустановить или очистить. Unregisters the distribution from WSL so it can be reinstalled or cleaned up.

Например: wslconfig /unregister Ubuntu приведет к удалению Ubuntu из дистрибутивов, доступных в WSL. For example: wslconfig /unregister Ubuntu would remove Ubuntu from the distributions available in WSL. При выполнении команды wslconfig /list этот дистрибутив не будет присутствовать в списке. When I run wslconfig /list it will not be listed.

Чтобы переустановить его, найдите этот дистрибутив в Microsoft Store и нажмите кнопку «Запустить». To reinstall, find the distribution in the Microsoft store and select «Launch».

Настройка параметров запуска дистрибутив с помощью вслконф Configure per distro launch settings with wslconf

Доступно в Windows Build 17093 и более поздних версиях Available in Windows Build 17093 and later

Автоматическая настройка функциональных возможностей в WSL, которые будут применяться при каждом запуске подсистемы с помощью wsl.conf . Automatically configure functionality in WSL that will be applied every time you launch the subsystem using wsl.conf . Сюда входят параметры автоподключения и конфигурация сети. This includes automount options and network configuration.

Файл wsl.conf в каждом дистрибутиве Linux находится в папке /etc/wsl.conf . wsl.conf is located in each Linux distribution in /etc/wsl.conf . Если этот файл отсутствует, его можно создать самостоятельно. If the file is not there, you can create it yourself. WSL обнаружит наличие файла и прочитает его содержимое. WSL will detect the existence of the file and will read its contents. Если этот файл отсутствует или имеет неправильный формат (т. е. неправильное форматирование разметки), WSL продолжит запуск в обычном режиме. If the file is missing or malformed (that is, improper markup formatting), WSL will continue to launch as normal.

Ниже приведен пример wsl.conf файла, который можно добавить в дистрибутивы. Here is a sample wsl.conf file you could add into your distributions:

При запуске нескольких оболочек Linux для одного и того же распространения необходимо подождать, пока подсистема Linux прекратит работу, после закрытия последнего экземпляра оболочки распространителя может потребоваться примерно 8 секунд. When launching multiple Linux shells for the same distribution, you must wait until the Linux subsystem stops running, this can take approximately 8 seconds after closing the last instance of the distribution shell. При запуске распространения (IE. Ubuntu), измените файл WSL. conf, закройте распространение, а затем снова запустите его. If you launch a distribution (ie. Ubuntu), modify the wsl.conf file, close the distribution, and then re-launch it. Вы можете предположить, что изменения в файле WSL. conf немедленно вступили в силу. You might assume that your changes to the wsl.conf file have immediately gone into effect. В настоящее время это не так, так как подсистема все еще может работать. This is not currently the case as the subsystem could still be running. Перед повторным запуском подсистемы необходимо подождать около 8 секунд, чтобы предоставить достаточно времени для получения изменений. You must wait

8 seconds for the subsystem to stop before relaunching in order to give enough time for your changes to be picked up. Вы можете проверить, не работает ли дистрибутив Linux (оболочка) после закрытия, используя PowerShell с помощью команды: wsl —list —running . You can check to see whether your Linux distribution (shell) is still running after closing it by using PowerShell with the command: wsl —list —running . Если распределения не выполняются, вы получите ответ: «нет выполняющихся распределений». If no distributions are running, you will receive the response: «There are no running distributions.» Теперь можно перезапустить распространение, чтобы увидеть примененные обновления WSL. conf. You can now restart the distribution to see your wsl.conf updates applied.

Параметры конфигурации Configuration Options

В соответствии с соглашениями об INI-файлах ключи объявляются в разделе. In keeping with .ini conventions, keys are declared under a section.

WSL поддерживает четыре раздела: automount , network , interop и user . WSL supports four sections: automount , network , interop , and user .

automount automount

Раздел: [automount] Section: [automount]

ключ key	value value	default default	HDInsight notes
Включено enabled	Логическое boolean	Да true	Значение true обеспечивает автоматическое подключение true causes fixed drives (i.e несъемных дисков (например, C:/ или D:/ ) DrvFs в /mnt . C:/ or D:/ ) to be automatically mounted with DrvFs under /mnt . false означает, что диски не будут подключены автоматически, но их можно подключать вручную или через fstab . false means drives won’t be mounted automatically, but you could still mount them manually or via fstab .
mountFsTab mountFsTab	Логическое boolean	Да true	Значение true задает /etc/fstab для обработки при запуске WSL. true sets /etc/fstab to be processed on WSL start. /etc/fstab — это файл, в котором можно объявлять другие файловые системы, например общий ресурс SMB. /etc/fstab is a file where you can declare other filesystems, like an SMB share. Поэтому вы можете автоматически подключать эти файловые системы в WSL при запуске. Thus, you can mount these filesystems automatically in WSL on start up.
корневой root	Строка String	/mnt/	Задает каталог, в который будут автоматически подключены несъемные диски. Sets the directory where fixed drives will be automatically mounted. Например, если у вас есть каталог в WSL в /windir/ и вы указали его в качестве корневого каталога, то ваши несъемные диски будут подключены в /windir/c For example, if you have a directory in WSL at /windir/ and you specify that as the root, you would expect to see your fixed drives mounted at /windir/c
options options	разделенный запятыми список значений comma-separated list of values	пустая строка empty string	Это значение добавляется в строку параметров подключения по умолчанию DrvFs. This value is appended to the default DrvFs mount options string. Можно указать только параметры, относящиеся к DrvFs. Only DrvFs-specific options can be specified. Параметры, которые двоичный файл подключения обычно анализирует и преобразовывает во флаг, не поддерживаются. Options that the mount binary would normally parse into a flag are not supported. Если вы хотите явно указать эти параметры, необходимо добавить каждый диск, для которого вы хотите это сделать, в /etc/fstab. If you want to explicitly specify those options, you must include every drive for which you want to do so in /etc/fstab.

По умолчанию WSL задает для идентификаторов UID и GID значения пользователя по умолчанию (в дистрибутиве Ubuntu пользователь по умолчанию создается с идентификаторами UID = 1000 и GID = 1000). By default, WSL sets the uid and gid to the value of the default user (in Ubuntu distro, the default user is created with uid=1000,gid=1000). Если пользователь явно указывает параметр GID или UID с помощью этого ключа, связанное значение будет перезаписано. If the user specifies a gid or uid option explicitly via this key, the associated value will be overwritten. В противном случае всегда будет добавляться значение по умолчанию. Otherwise, the default value will always be appended.

Примечание. Эти параметры применяются в качестве параметров подключения для всех автоматически подключенных дисков. Note: These options are applied as the mount options for all automatically mounted drives. Чтобы изменить параметры для конкретного диска, используйте /etc/fstab. To change the options for a specific drive only, use /etc/fstab instead.

Параметры подключения Mount options

Задание различных параметров подключения для дисков Windows (DrvFs) позволяет контролировать определение разрешений для файлов Windows. Setting different mount options for Windows drives (DrvFs) can control how file permissions are calculated for Windows files. Доступны следующие варианты: The following options are available:

Ключ Key	Описание Description	Значение по умолчанию Default
uid uid	ИД пользователя, используемый для владельца всех файлов. The User ID used for the owner of all files	ИД пользователя по умолчанию для дистрибутива WSL (при первой установке имеет значение по умолчанию — 1000). The default User ID of your WSL distro (On first installation this defaults to 1000)
gid gid	Идентификатор группы, используемый для владельца всех файлов. The Group ID used for the owner of all files	Идентификатор группы по умолчанию для дистрибутива WSL (при первой установке имеет значение по умолчанию — 1000). The default group ID of your WSL distro (On first installation this defaults to 1000)
umask umask	Восьмеричная маска разрешений, исключаемых для всех файлов и каталогов. An octal mask of permissions to exclude for all files and directories	000 000
fmask fmask	Восьмеричная маска разрешений, исключаемых для всех файлов. An octal mask of permissions to exclude for all files	000 000
dmask dmask	Восьмеричная маска разрешений, исключаемых для всех каталогов. An octal mask of permissions to exclude for all directories	000 000
метаданные metadata	Добавляются ли метаданные в файлы Windows для поддержки системных разрешений Linux Whether metadata is added to Windows files to support Linux system permissions	disabled disabled

Примечание. Маски разрешений помещаются в логическую операцию или перед применением к файлам или каталогам. Note: The permission masks are put through a logical OR operation before being applied to files or directories.

network network

Метка раздела: [network] Section label: [network]

ключ key	value value	default default	HDInsight notes
generateHosts generateHosts	Логическое boolean	true	Значение true указывает WSL создать /etc/hosts . true sets WSL to generate /etc/hosts . Файл hosts содержит статическую карту имен узлов и соответствующих IP-адресов. The hosts file contains a static map of hostnames corresponding IP address.
generateResolvConf generateResolvConf	Логическое boolean	true	Значение true указывает WSL создать /etc/resolv.conf . true set WSL to generate /etc/resolv.conf . Файл resolv.conf содержит список DNS-серверов, которые способны разрешить заданное имя узла в его IP-адрес. The resolv.conf contains a DNS list that are capable of resolving a given hostname to its IP address.

interop interop

Метка раздела: [interop] Section label: [interop]

Эти параметры доступны в выпусках для программы предварительной оценки, начиная со сборки 17713. These options are available in Insider Build 17713 and later.

ключ key	value value	default default	HDInsight notes
Включено enabled	Логическое boolean	true	Установка этого ключа определяет, будет ли WSL поддерживать запуск процессов Windows. Setting this key will determine whether WSL will support launching Windows processes.
appendWindowsPath appendWindowsPath	Логическое boolean	true	Задание этого ключа определяет, будет ли WSL добавлять элементы пути Windows в переменную среды $PATH. Setting this key will determine whether WSL will add Windows path elements to the $PATH environment variable.

пользователь user

Метка раздела: [user] Section label: [user]

Эти параметры доступны в сборках 18980 и более поздних версий. These options are available in Build 18980 and later.

ключ key	value value	default default	HDInsight notes
default default	строка string	Начальное имя пользователя, созданное при первом запуске The initial username created on first run	Задание этого параметра указывает, какой пользователь будет запускать, как при первом запуске сеанса WSL. Setting this key specifies which user to run as when first starting a WSL session.

Настройка глобальных параметров с помощью. вслконфиг Configure global options with .wslconfig

Доступно в Windows Build 19041 и более поздних версиях Available in Windows Build 19041 and later

Вы можете настроить глобальные параметры WSL, поместив .wslconfig файл в корневой каталог папки «Пользователи»: C:\Users\ \.wslconfig . You can configure global WSL options by placing a .wslconfig file into the root directory of your users folder: C:\Users\ \.wslconfig . Многие из этих файлов связаны с WSL 2. Помните, что для wsl —shutdown завершения работы виртуальной машины WSL 2 может потребоваться запустить, а затем перезапустить экземпляр WSL, чтобы эти изменения вступили в силу. Many of these files are related to WSL 2, please keep in mind you may need to run wsl —shutdown to shut down the WSL 2 VM and then restart your WSL instance for these changes to take affect.

Ниже приведен пример файла. вслконфиг: Here is a sample .wslconfig file:

Этот файл может содержать следующие параметры: This file can contain the following options:

Параметры WSL 2 WSL 2 Settings

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

Эти параметры влияют на виртуальную машину, на которой распространяется любое WSL 2. These settings affect the VM that powers any WSL 2 distribution.

ключ key	value value	default default	HDInsight notes
ядро kernel	строка string	Входящие в состав ядра Microsoft The Microsoft built kernel provided inbox	Абсолютный путь Windows к пользовательскому ядру Linux. An absolute Windows path to a custom Linux kernel.
Память memory	размер; size	50% от общего объема памяти в Windows или 8 ГБ, в зависимости от того, что меньше. в сборках до 20175:80% от общего объема памяти в Windows 50% of total memory on Windows or 8GB, whichever is less; on builds before 20175: 80% of your total memory on Windows	Объем памяти, назначаемый виртуальной машине WSL 2. How much memory to assign to the WSL 2 VM.
обработчики processors	number number	Одинаковое число процессоров в Windows The same number of processors on Windows	Количество процессоров, назначаемых виртуальной машине WSL 2. How many processors to assign to the WSL 2 VM.
локалхостфорвардинг localhostForwarding	Логическое boolean	true	Логическое значение, указывающее, должны ли порты, привязанные к подстановочным знакам или localhost на виртуальной машине WSL 2, подключаться с узла через порт localhost:. Boolean specifying if ports bound to wildcard or localhost in the WSL 2 VM should be connectable from the host via localhost:port.
кернелкоммандлине kernelCommandLine	строка string	Пусто Blank	Дополнительные аргументы командной строки ядра. Additional kernel command line arguments.
swap swap	размер; size	25% размера памяти в Windows округляется до ближайших ГБ 25% of memory size on Windows rounded up to the nearest GB	Объем пространства подкачки для добавления в виртуальную машину WSL 2, 0 для файла подкачки. How much swap space to add to the WSL 2 VM, 0 for no swap file.
Файл подкачки swapFile	строка string	%усерпрофиле%\аппдата\локал\темп\свап.вхдкс %USERPROFILE%\AppData\Local\Temp\swap.vhdx	Абсолютный путь Windows к виртуальному жесткому диску для переключения. An absolute Windows path to the swap virtual hard disk.

• Примечание. это значение true для Windows Build 19041 и может отличаться в сборках Windows в программе «предварительные оценки» Note: This value is true for Windows Build 19041 and may be different in Windows builds in the Insiders program

Записи со path значением должны быть путями Windows с escape-символами обратной косой черты, например: C:\\Temp\\myCustomKernel Entries with the path value must be Windows paths with escaped backslashes, e.g: C:\\Temp\\myCustomKernel

Записи со size значением должны быть размером, за которым следует единица, например 8GB или 512MB . Entries with the size value must be a size followed by a unit, for example 8GB or 512MB .