Файл конфигурации /etc/default/rudesktop#
Файл конфигурации — переменные окружения, через которые задаются адреса, параметры базы данных и режим работы всех компонентов сервера RuDesktop
Описание#
Все службы сервера — веб-интерфейс, relay, executor, PXE и Redis — запускаются через команду rude, и при каждом запуске файл /etc/default/rudesktop читается как источник переменных окружения. Файл создаётся автоматически при установке сервера командой rude install; владелец — root, группа — rudesktop
Файл переживает обновления пакета: установщик не перезаписывает уже существующие значения. Полностью файл удаляется деструктивной командой rude reinstall или при полном удалении пакета сервера
Подсказка
На этой странице описаны базовые параметры. Конфигурация relay — на странице rudesktop-relay.toml, дополнительные параметры для нестандартных сценариев и диагностики — на странице Расширенные параметры
Применение изменений#
Отредактируйте файл, например:
nano /etc/default/rudesktopПерезапустите сервер целиком:
rude restartили только нужную службу:
rude restart rudesktop-web.service
Важно
Адрес сервера (PUBLIC_HOST, PUBLIC_PORT, PUBLIC_IP) и аргументы установки меняются командами установки, а не правкой файла. Порядок действий описан на странице Смена и установка IP; полная перегенерация конфигурации nginx и сертификатов выполняется деструктивной командой rude reinstall
Адреса и порты#
Переменная |
Назначение |
|---|---|
|
Публичный домен или IP-адрес, по которому клиенты и браузеры обращаются к серверу. Используется веб-интерфейсом, relay и при генерации nginx |
|
Публичный порт. Если при установке порт не указан, используется |
|
Публичный IP-адрес сервера; заполняется установщиком при генерации конфигурации. Используется PXE-сервером и публикацией образов ОС; при пустом значении PXE-сервер определяет адрес из |
|
Локальный адрес сервера для режима двух IP, когда из внутренней и внешней сети сервер доступен по разным адресам. Если при установке передан один адрес, совпадают с |
Режим установки#
Переменная |
Назначение |
|---|---|
|
Роль узла при развёртывании. Задаётся при установке пакета и определяет состав включаемых служб: |
|
Аргументы, переданные команде |
База данных#
Переменная |
Назначение |
|---|---|
|
Адрес PostgreSQL. По умолчанию |
|
Порт PostgreSQL. По умолчанию |
|
Имя базы данных. По умолчанию |
|
Пользователь базы данных. По умолчанию |
|
Пароль базы данных; генерируется установщиком |
|
Режим SSL-соединения с PostgreSQL. По умолчанию |
|
Путь к сертификату CA ( |
Подсказка
Подключение к внешнему PostgreSQL и полный список значений POSTGRES_SSL_MODE — на странице Настройка подключения и SSL для сторонней БД
Служебные параметры#
Переменная |
Назначение |
|---|---|
|
Секретный ключ веб-интерфейса: подпись сессий и токенов. Генерируется установщиком; смена значения прерывает активные сессии пользователей |
|
Пароль учётной записи |
|
Лимит размера блока данных TFTP-сервера PXE в байтах. По умолчанию |
|
Резервная копия базы данных перед мажорным обновлением пакета: |
|
Число рабочих процессов веб-интерфейса. Без значения рассчитывается автоматически. Подробнее — Настройка Gunicorn |
|
Адрес Redis, например |
Важно
Значения SECRET_KEY, POSTGRES_PASSWORD и SMB_PASSWORD генерируются автоматически. Не публикуйте их и не меняйте без необходимости: смена SECRET_KEY прерывает активные сессии и подписанные токены, а рассинхронизация POSTGRES_PASSWORD с самим PostgreSQL приводит к недоступности сервера
Типовые сценарии#
Подробные пошаговые инструкции по частым задачам вынесены в отдельные страницы:
Вынести базу данных на отдельный PostgreSQL или включить SSL-соединение с БД — Настройка подключения и SSL для сторонней БД
Подключить внешний Redis, в том числе с паролем — Настройка Redis
Изменить число воркеров веб-интерфейса — Настройка Gunicorn
Управлять резервной копией базы данных перед обновлением пакета — Резервное копирование
Сменить адрес или порт сервера, настроить два IP-адреса — Смена и установка IP