Файл конфигурации /etc/default/rudesktop#

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

Описание#

Все службы сервера — веб-интерфейс, relay, executor, PXE и Redis — запускаются через команду rude, и при каждом запуске файл /etc/default/rudesktop читается как источник переменных окружения. Файл создаётся автоматически при установке сервера командой rude install; владелец — root, группа — rudesktop

Файл переживает обновления пакета: установщик не перезаписывает уже существующие значения. Полностью файл удаляется деструктивной командой rude reinstall или при полном удалении пакета сервера

Подсказка

На этой странице описаны базовые параметры. Конфигурация relay — на странице rudesktop-relay.toml, дополнительные параметры для нестандартных сценариев и диагностики — на странице Расширенные параметры

Применение изменений#

  1. Отредактируйте файл, например:

    nano /etc/default/rudesktop
    
  2. Перезапустите сервер целиком:

    rude restart
    

    или только нужную службу:

    rude restart rudesktop-web.service
    

Важно

Адрес сервера (PUBLIC_HOST, PUBLIC_PORT, PUBLIC_IP) и аргументы установки меняются командами установки, а не правкой файла. Порядок действий описан на странице Смена и установка IP; полная перегенерация конфигурации nginx и сертификатов выполняется деструктивной командой rude reinstall

Адреса и порты#

Переменная

Назначение

PUBLIC_HOST

Публичный домен или IP-адрес, по которому клиенты и браузеры обращаются к серверу. Используется веб-интерфейсом, relay и при генерации nginx

PUBLIC_PORT

Публичный порт. Если при установке порт не указан, используется 443

PUBLIC_IP

Публичный IP-адрес сервера; заполняется установщиком при генерации конфигурации. Используется PXE-сервером и публикацией образов ОС; при пустом значении PXE-сервер определяет адрес из PUBLIC_HOST

LOCAL_HOST / LOCAL_PORT

Локальный адрес сервера для режима двух IP, когда из внутренней и внешней сети сервер доступен по разным адресам. Если при установке передан один адрес, совпадают с PUBLIC_HOST / PUBLIC_PORT

Режим установки#

Переменная

Назначение

INSTALL_MODE

Роль узла при развёртывании. Задаётся при установке пакета и определяет состав включаемых служб: standalone — полный сервер (по умолчанию), relay — мост, executor — исполнитель или точка распространения

INSTALL_ARGS

Аргументы, переданные команде rude install (адреса сервера). Заполняется установщиком автоматически и используется при повторной установке без аргументов — вручную не редактируется

База данных#

Переменная

Назначение

POSTGRES_HOST

Адрес PostgreSQL. По умолчанию localhost

POSTGRES_PORT

Порт PostgreSQL. По умолчанию 5432

POSTGRES_DB

Имя базы данных. По умолчанию rudesktop

POSTGRES_USER

Пользователь базы данных. По умолчанию rudesktop

POSTGRES_PASSWORD

Пароль базы данных; генерируется установщиком

POSTGRES_SSL_MODE

Режим SSL-соединения с PostgreSQL. По умолчанию disable

POSTGRES_CA_FILE

Путь к сертификату CA (root.crt) для режимов проверки verify-ca и verify-full

Подсказка

Подключение к внешнему PostgreSQL и полный список значений POSTGRES_SSL_MODE — на странице Настройка подключения и SSL для сторонней БД

Служебные параметры#

Переменная

Назначение

SECRET_KEY

Секретный ключ веб-интерфейса: подпись сессий и токенов. Генерируется установщиком; смена значения прерывает активные сессии пользователей

SMB_PASSWORD

Пароль учётной записи rudesktop для доступа к файлам сервера по протоколу SMB — используется при установке ОС по сети и миграции Windows на Linux; генерируется установщиком

TFTP_BLOCK_SIZE_LIMIT

Лимит размера блока данных TFTP-сервера PXE в байтах. По умолчанию 512; подробнее — Настройка размера блока TFTP

UPGRADE_BACKUP

Резервная копия базы данных перед мажорным обновлением пакета: always (по умолчанию), ask, never. Подробнее — Резервное копирование

GUNICORN_WORKERS

Число рабочих процессов веб-интерфейса. Без значения рассчитывается автоматически. Подробнее — Настройка Gunicorn

REDIS_URL

Адрес Redis, например redis://localhost:32459; для подключения с паролем — redis://:password@address:port. Подробнее — Настройка Redis

Важно

Значения SECRET_KEY, POSTGRES_PASSWORD и SMB_PASSWORD генерируются автоматически. Не публикуйте их и не меняйте без необходимости: смена SECRET_KEY прерывает активные сессии и подписанные токены, а рассинхронизация POSTGRES_PASSWORD с самим PostgreSQL приводит к недоступности сервера

Типовые сценарии#

Подробные пошаговые инструкции по частым задачам вынесены в отдельные страницы: