config.conf ru

config.conf

config.conf — основной файл преднастройки MiniOS. Обычно на стандартном носителе MiniOS он хранится как minios/config.conf. При загрузке initramfs синхронизирует его с /etc/live/config.conf в собранной системе.

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

Перенастройка

В столбце Перенастраиваемый ниже используются следующие значения:

• Да — параметр можно изменить и применить повторно при следующей загрузке.
• Только при первой загрузке — параметр применяется при создании соответствующего постоянного состояния и обычно не применяется повторно при последующих загрузках.

Это различие важно для понимания поведения системы. Внутренние файлы состояния live-config являются деталями реализации и не заменяют его.

Сгенерированная конфигурация

Текущий образ MiniOS генерирует config.conf с такой общей структурой:

# live-config settings
LIVE_CONFIG_CMDLINE="components nottyautologin"
LIVE_HOSTNAME="minios"
LIVE_USERNAME="live"
LIVE_USER_FULLNAME="MiniOS Live User"
LIVE_USER_DEFAULT_GROUPS="dialout cdrom floppy audio video plugdev users fuse plugdev netdev powerdev scanner bluetooth weston-launch kvm libvirt libvirt-qemu vboxusers lpadmin dip sambashare docker wireshark"
LIVE_USER_PASSWORD_CRYPTED='$y$...'
LIVE_ROOT_PASSWORD_CRYPTED='$y$...'
LIVE_CONFIG_NOROOT=""
LIVE_LOCALES="en_US.UTF-8"
LIVE_TIMEZONE="Etc/UTC"
LIVE_KEYBOARD_MODEL="pc105"
LIVE_KEYBOARD_LAYOUTS="us,us"
LIVE_KEYBOARD_OPTIONS="grp:alt_shift_toggle,grp_led:scroll"
LIVE_KEYBOARD_VARIANTS=","
LIVE_CONFIG_DEBUG="true"
LIVE_LINK_USER_DIRS="false"
LIVE_BIND_USER_DIRS="false"
LIVE_USER_DIRS_PATH="/minios/userdata"
LIVE_MODULE_MODE="merged"

# MiniOS LiveKit settings.
DEFAULT_TARGET="graphical.target"
ENABLE_SERVICES="ssh"
DISABLE_SERVICES=""
EXPORT_LOGS="false"

Конкретные значения зависят от образа и параметров сборки.

::: warning LIVE_CONFIG_CMDLINE не является командной строкой initramfs LIVE_CONFIG_CMDLINE предоставляет опции после того, как root MiniOS был смонтирован. Такие параметры, как from=, load=, toram, и perchdir= должны быть реальными параметрами загрузки ядра; если указать их только в LIVE_CONFIG_CMDLINE — это слишком поздно, чтобы повлиять на initramfs. Опции storage-policy log-storage=, apt-cache=, и browser-cache= — особое исключение: minios-boot читает их из LIVE_CONFIG_CMDLINE до запуска основных сервисов. :::

Стандартные параметры

Параметр	Можно изменить	Описание
LIVE_CONFIG_CMDLINE	Да	Дополнительные параметры live-config. Фактическая командная строка ядра добавляется позже и имеет приоритет для повторяющихся опций.
LIVE_HOSTNAME	Да	Имя хоста системы.
LIVE_USERNAME	Только при первом запуске	Имя live-пользователя, созданного при первоначальной настройке.
LIVE_USER_FULLNAME	Только при первом запуске	Полное имя live-пользователя.
LIVE_USER_DEFAULT_GROUPS	Только при первом запуске	Дополнительные группы, назначаемые при создании live-пользователя.
LIVE_USER_PASSWORD_CRYPTED	Только при первом запуске	Хеш пароля live-пользователя (crypt).
LIVE_ROOT_PASSWORD_CRYPTED	Только при первом запуске	Хеш пароля root (crypt).
LIVE_CONFIG_NOROOT	Только при первом запуске	Если включено, отключает настройку MiniOS root-пароля, sudo и привилегий PolicyKit.
LIVE_LOCALES	Да	Одна или несколько локалей системы.
LIVE_TIMEZONE	Да	Часовой пояс системы, например Europe/Berlin или Etc/UTC.
LIVE_KEYBOARD_MODEL	Да	Модель клавиатуры XKB.
LIVE_KEYBOARD_LAYOUTS	Да	Раскладки клавиатуры через запятую.
LIVE_KEYBOARD_OPTIONS	Да	Параметры клавиатуры XKB.
LIVE_KEYBOARD_VARIANTS	Да	Варианты через запятую, соответствующие выбранным раскладкам.
LIVE_CONFIG_DEBUG	Да	Включает вывод отладки live-config при значении true.
LIVE_LINK_USER_DIRS	Да	Связывает пользовательские каталоги с настроенным расположением на доступном для записи носителе MiniOS. Недоступно в режиме bind, любом toram режиме или при активной сессии LUKS-шифрования.
LIVE_BIND_USER_DIRS	Да	Монтирует управляемые пользовательские каталоги из настроенного расположения на доступном для записи MiniOS носителе. Недоступно в режиме link, любом toram режиме или при активной сессии постоянства с шифрованием LUKS.
LIVE_USER_DIRS_PATH	Да	Расположение, используемое в режиме link/bind для пользовательских каталогов.
LIVE_MODULE_MODE	Да	Выбирает simple или merged интеграцию с модулем live-config.
LIVE_LOG_STORAGE	Да	persistent (по умолчанию) или volatile для обычных системных журналов. Журналы диагностики загрузки сохраняются постоянно; см. Производительность.
LIVE_APT_CACHE	Да	persistent (по умолчанию) или volatile для скачанных архивов APT; состояние пакетов и списки репозиториев сохраняются постоянно.
LIVE_BROWSER_CACHE	Да	persistent (по умолчанию) или volatile для стандартных путей кэширования браузера. Профили браузера сохраняются постоянно.
DEFAULT_TARGET	Да	Цель загрузки: graphical.target, multi-user.target, или rescue.target.
ENABLE_SERVICES	Да	Сервисы, включаемые при загрузке через запятую через minios-svc.
DISABLE_SERVICES	Да	Сервисы, отключаемые при загрузке через запятую через minios-svc.
EXPORT_LOGS	Да	Когда true, экспортирует MiniOS и журналы запуска live-config на доступный для записи MiniOS носитель.

Сгенерированный файл не является исчерпывающим списком всего, что поддерживает minios-live-config. Дополнительные переменные для предварительной настройки проводной сети, параметров безопасности, хуков, preseeding, Xorg и других компонентов можно добавить вручную. См. live-config для полного справочника.

Компонент user-media отказывает в активации и обратном копировании, если активная сессия постоянства зашифрована с помощью LUKS. Используется фактическое состояние шифрования во время работы: параметр ядра perchencrypt=luks только запрашивает шифрование при создании новой сессии и не описывает уже существующую сессию.

Преднастройка проводной сети

MiniOS может заранее настроить проводную сеть IPv4 через компонент live-config network. Это предназначено для административной преднастройки системы до её запуска на целевом оборудовании. Например:

LIVE_NETWORK_METHOD="static"
LIVE_NETWORK_INTERFACE="enp1s0"
LIVE_NETWORK_ADDRESS="192.0.2.10"
LIVE_NETWORK_PREFIX="24"
LIVE_NETWORK_GATEWAY="192.0.2.1"
LIVE_NETWORK_DNS="1.1.1.1,9.9.9.9"
LIVE_NETWORK_BACKEND="auto"

Эти параметры действуют только при первой загрузке для постоянной сетевой политики. После успешного применения компонент фиксирует /var/lib/live/config/network. Изменение значений не перезаписывает уже настроенную постоянную сессию, если только это состояние не сброшено вручную.

LIVE_NETWORK_METHOD=static записывает статическую политику. off отключает автоматическую настройку IPv4 для выбранного интерфейса. Если значение не задано или dhcp оставляет сетевую конфигурацию образа без изменений. LIVE_NETWORK_BACKEND=auto отдает предпочтение NetworkManager и при необходимости использует ifupdown.

Этот механизм не настраивает Wi-Fi. После загрузки обычное управление проводными и беспроводными сетями осуществляет NetworkManager. См. Сетевые подключения для работы с сетью во время сеанса и live-config для всех сетевых переменных.

MiniOS настройки раннего userspace

DEFAULT_TARGET, ENABLE_SERVICES, DISABLE_SERVICES, EXPORT_LOGS, и три LIVE_* политики хранения выше являются MiniOS параметрами загрузки, а не переменными компонента live-config. MiniOS применяет их до того, как управление переходит к стандартной системе инициализации; minios-boot отвечает за эти три политики хранения. Все они Переконфигурируемые: Да.

Соответствующие параметры загрузки default-target=, enable-services=, и disable-services= имеют приоритет для текущей загрузки. Параметр text принудительно устанавливает multi-user.target.

В актуальных сборках Toolbox и Ultra добавлен ssh в ENABLE_SERVICES. Чтобы явно отключить SSH, укажите его в DISABLE_SERVICES; просто удаление из ENABLE_SERVICES не приведёт к отключению.

С EXPORT_LOGS="true", на записываемый MiniOS носитель сохраняются журналы запуска ниже:

minios/log/YYYYMMDD_HHMMSS/
├── minios/
└── live/

Соответствующие журналы работы — это /var/log/minios/minios-boot.log и /var/log/live/config.log.

Политика кэширования и логирования для постоянной сессии

Чтобы уменьшить количество записей во время perch сессии, добавьте параметры отдельно:

LIVE_LOG_STORAGE="volatile"
LIVE_APT_CACHE="volatile"
LIVE_BROWSER_CACHE="volatile"

Они также принимают persistent, значение по умолчанию. minios-boot принимает те же параметры из /etc/live/config.conf.d/*.conf, LIVE_CONFIG_CMDLINE (log-storage=volatile, apt-cache=volatile, browser-cache=volatile), или из параметров ядра. Поздние фрагменты заменяют более ранние, blob-параметр имеет приоритет над ключами файла, а фактические параметры ядра — наивысший приоритет. Все три варианта независимы и сами по себе не обеспечивают постоянство. Совместимый initrd объявляет perch-storage-v1 на /run/initramfs/etc/minios-initramfs-storage; Конфигуратор MiniOS предупреждает, если текущий initrd этого не объявляет.

Для применения политик требуется успешная активация постоянства — либо на долговременном перезаписываемом носителе, либо как перезаписываемая сессия RAM с защищённой ram-origin информацией. Только toram не определяет надёжность сессии: perchtoram=off может сохранять сессию на носителе, тогда как скопированная сессия всё равно требует сохранения. Неудачная попытка постоянства и Запустить без сохранения не считаются. Диагностика загрузки сохраняется отдельно от обычных временных логов, но остаётся в памяти в скопированной сессии RAM до сохранения. Компонент browser-cache запускается после создания live-пользователя. Подробнее см. Производительность для лимитов RAM, поддерживаемых путей и условий допуска.

Исходный файл, рабочая копия и приоритет

Выбранный каталог данных MiniOS обычно содержит следующие исходные файлы:

Выбранный каталог данных	Работающая система
config.conf	/etc/live/config.conf
config.conf.d/*.conf	/etc/live/config.conf.d/*.conf

На обычно смонтированных носителях они отображаются как minios/config.conf и minios/config.conf.d/*.conf, часто в каталоге /run/initramfs/memory/data/ при работе системы.

Синхронизация выполняется при загрузке; это не файловый монитор:

• Более новая копия config.conf имеет приоритет по времени изменения. Более новая копия на носителе копируется в рабочий корень. Более новая рабочая копия копируется обратно только если выбранный каталог данных MiniOS доступен для записи.
• Каждый файл config.conf.d/*.conf синхронизируется независимо по имени файла, используя те же правила по времени и доступности для записи. Файлы не удаляются ни с одной из сторон.
• Если системное время меньше времени последней синхронизации, сравнение временных меток пропускается, и копируются только отсутствующие файлы назначения.
• toram=trim копирует config.conf но пропускает config.conf.d/. Полная toram копирует дерево данных, но после этого синхронизация производится с копией RAM, а не с отсоединённым исходным носителем. После синхронизации live-config читает /etc/live/config.conf сначала, а затем /etc/live/config.conf.d/*.conf в порядке оболочки glob. Поздний фрагмент может заменить значение из основного файла или более раннего фрагмента.

Фактическая командная строка ядра добавляется к LIVE_CONFIG_CMDLINE. Если опция встречается несколько раз, приоритет имеет более позднее вхождение из командной строки ядра. Для трёх политик хранения minios-boot читает синхронизированный основной файл, затем его фрагменты, затем blob с опциями и, наконец, фактическую командную строку ядра; последнее значение имеет приоритет.

Вы можете добавить специфичные для проекта переменные оболочки в config.conf или его фрагменты и читать их из рабочих копий. Значения заключайте в кавычки как строки оболочки и не ставьте пробелы вокруг =.

Связанные материалы

• Параметры загрузки — параметры, которые необходимо указывать непосредственно в командной строке ядра и для переопределения live-config.
• live-config — полный справочник параметров, переменных, компонентов и состояний для позднего userspace.
• Режимы загрузки — как персистентность и toram влияют на хранение конфигурации.