Настройка Kickstart

Настройка Kickstart — описание серверных шаблонов Kickstart, которые сервер RuDesktop применяет к клиенту при первой установке или вручную через веб-интерфейс. Раздел описывает жизненный цикл применения Kickstart, расположение шаблонов на сервере, формат скриптов, добавление произвольных команд и итоговый конфиг на устройстве

Подсказка

Параметры Kickstart редактируются администратором через веб-интерфейс на странице Kickstart. Этот раздел описывает, как они хранятся и применяются на уровне файловой системы

Как работает Kickstart

  1. Администратор задаёт параметры на странице Kickstart в веб-интерфейсе — отдельно для каждой платформы (Windows, Linux, macOS) и опционально добавляет произвольные команды

  2. При сохранении формы сервер RuDesktop генерирует скрипт настройки клиента под каждую ОС и сохраняет его в каталог /var/lib/rudesktop/kickstart/<os>/

  3. Скрипт автоматически запускается на устройстве при первой установке клиента RuDesktop, либо может быть применён вручную к уже установленному клиенту через кнопку Применить настройки Kickstart

  4. Скрипт обновляет клиентский конфиг RuDesktop2.toml на устройстве и выполняет добавленные администратором произвольные команды

Примечание

Команда kickstart клиента позволяет вручную запросить и применить настройки Kickstart с сервера:

rudesktop --kickstart

Шаблоны на сервере

Сгенерированные скрипты находятся на сервере в следующих каталогах:

/var/lib/rudesktop/kickstart/windows/   # Скрипт для Windows (PowerShell/CMD)
/var/lib/rudesktop/kickstart/linux/     # Скрипт для Linux (bash)
/var/lib/rudesktop/kickstart/macos/     # Скрипт для macOS (bash/zsh)

Важно

Содержимое этих каталогов формируется сервером автоматически при сохранении формы Kickstart в веб-интерфейсе. Не редактируйте сгенерированные скрипты напрямую — изменения будут перезаписаны при следующем сохранении

Произвольные команды

Помимо стандартных параметров, в Kickstart-скрипт можно добавить произвольные команды — например, очистку временных файлов или создание каталогов. Команды задаются на странице Kickstart во вкладке соответствующей платформы и записываются на стандартном языке оболочки этой ОС:

  • Windows — PowerShell или CMD

  • Linux — bash

  • macOS — bash или zsh

Примеры:

Очистка временных файлов пользователя:

& "C:\Windows\system32\cmd.exe" /c del /q /s "C:\Users\rude\AppData\Local\Temp\*"

Важно

Команды выполняются с правами учётной записи, под которой работает клиент RuDesktop на устройстве. Если требуется повышение прав, используйте средства ОС (sudo, runas и т. п.)

Добавленные команды также отображаются в веб-интерфейсе на странице Kickstart

Конфиг клиента на устройстве

После применения Kickstart клиентский конфиг располагается на устройстве в следующих каталогах:

%windir%\ServiceProfiles\LocalService\AppData\Roaming\RuDesktop\config\RuDesktop2.toml

Файл написан в формате TOML и содержит параметры клиента (тёмная тема, разрешение буфера обмена, автоматическая запись сессий и т. д.) — состав параметров соответствует формам на странице Kickstart в веб-интерфейсе

Подсказка

Параллельно с RuDesktop2.toml в том же каталоге могут находиться вспомогательные файлы:

  • peers/<server_id>.toml — сохранённые настройки для конкретного удалённого устройства

  • RuDesktop_logcollect.toml — конфигурация сборщика логов

Расположение и состав конфигурации клиента описаны на странице Описание логов клиента

Применение Kickstart

  • Автоматически при первой установке клиента RuDesktop — скрипт запускается сразу после развёртывания

  • Вручную к уже установленным клиентам — через кнопку Применить настройки Kickstart на странице Kickstart с выбором конкретного устройства, группы или всех устройств

  • С устройства — командой rudesktop --kickstart (см. kickstart) клиент запрашивает и применяет актуальные настройки с сервера

Важно

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