TERA. Конфигурационный файл x11tera.conf

Конфигурационный файл x11tera.conf

Конфигурационный файл /etc/xdg/x11tera/x11tera.conf используется для настройки ПО x11tera.

Перечень параметров, задающихся через файл /etc/xdg/x11tera/x11tera.conf, приведен в таблице.

После изменения параметров конфигурации нужно выполнить перезапуск ОС физической машины.

Параметры конфигурирования TERA для физических машин

Параметр	Значение по умолчанию	Описание
Сетевые настройки
`listen`	`5900`	Порт прослушивания для входящих подключений. По умолчанию адрес прослушивания устанавливается как `localhost`. Может задаваться: значение порта; диапазон значений. Примеры: `5900`; `5900-5910` - будет выбран свободный порт из указанного диапазона
Настройки использования пароля для подключения
`password`	`spicey`	Должен задаваться только один из перечисленных параметров данной секции. Использовать параметр не рекомендуется. Задание пароля для подключения пользователя к ОС физической машины. По умолчанию параметр не используется (закомментирован)
`generate-password`	`8`	Должен задаваться только один из перечисленных параметров данной секции. Использовать параметр не рекомендуется. Задание длины пароля. Если параметр используется, то для подключения пользователя к ОС физической машины будет автоматически сгенерирован пароль заданной длины. Пароль будет показан в интерфейсе командной строки при запуске службы с соответствующим параметром. По умолчанию параметр не используется (закомментирован)
`password-file`	`-`	Должен задаваться только один из перечисленных параметров данной секции. Использовать параметр не рекомендуется. Задание файла, хранящего пароль для подключения пользователя к ОС физической машины. Значение «-» соответствует чтению со стандартного устройства ввода. Пример использования (`P@s$w0rd` будет использовано как пароль, т.к. задано стандартное устройство ввода): cat "P@s$w0rd" \| x11tera --password-file=- По умолчанию параметр не используется (закомментирован)
`disable-ticketing`	`true`	Должен задаваться только один из перечисленных параметров данной секции. Управление механизмом аутентификации при подключении к ОС физической машины. Возможные значения: `true` - разрешить подключение без предоставления пароля; `false` - запретить подключение без предоставления пароля
Настройки `tera-vdagent`
`virtio-path`	`/tmp/xtera-virtio`	Путь к виртуальному устройству `virtio` для взаимодействия сервиса `tera-vdagentd` с ОС физической машины
`uinput-path`	`/tmp/xtera-uinput`	Путь к устройству `uinput`, используемому сервисом `tera-vdagentd` для отправки сигналов клавиатуры и мыши в ОС физической машины
Настройки доступа к периферийным устройствам
`on-connect`	`/usr/bin/x11tera_on_lock`	Путь к исполняемому файлу, задающему настройку периферийных устройств физической машины при подключении пользователя
`on-disconnect`	`/usr/bin/x11tera_on_unlock`	Путь к исполняемому файлу, задающему настройку периферийных устройств физической машины при отключении пользователя
Настройки использования мыши и клавиатуры
`allow-control`	`true`	Управление возможностью для подключенного пользователя перемещать мышь и нажимать клавиши. Возможные значения: `true` - разрешить перемещать мышь и нажимать клавиши; `false` - запретить перемещать мышь и нажимать клавиши
Настройки времени ожидания соединения
`timeout`	`0`	Задает время ожидания (в секундах), по истечении которого приложение `x11tera` прекратит работу, если соединение не было установлено. Пример использования: x11tera --timeout=5 127.0.0.1:5902 Значение `0` означает, что время ожидания не задано
Настройки параметров журналирования событий
`audit`	`false`	Управление режимом журналирования событий в системе аудита ОС. Для включения режима требуются расширенные права пользователя (в большинстве ОС права пользователя `root`) для подключения к системе аудита ОС. Если режим включен, но требования не выполнены, то приложение `x11tera` завершит работу. Возможные значения: `true` - режим журналирования включен; `false` - режим журналирования отключен
`audit-message-type`	`1196`	Параметр работает совместно с `audit`. Задание типа сообщения для регистрации в системе аудита ОС. Значение `1196` используется для событий ПО x11tera. Для просмотра событий указанного типа можно выполнить: sudo ausearch --message 1196
Настройки доверия к уведомлениям об изменении экрана
`trust-damage`	`auto`	Управление режимом доверия к повторяющимся уведомлениям об изменении экрана. Некоторые оконные менеджеры могут слишком часто уведомлять о полном изменении экрана. Для настройки доверия к таким уведомлениям используется параметр `trust-damage`. Возможные значения: `auto` - не доверять уведомлениям, начиная с третьего; `always` - доверять каждому уведомлению; `never` - не доверять всем уведомлениям
Настройки частоты передачи экрана
`full-screen-fps`	`0`	Задание частоты передачи экрана в ПО Termidesk Viewer. Значение `0` означает, что будет происходить автоматическое отслеживание изменений экрана и отправка только опорных кадров. Если задано значение, отличное от `0`, то полное опорное изображение будет отправляться с частотой: `<значение>` раз в секунду
Настройки кодирования видеопотока
`codecs`	`spice:mjpeg`	Выбор видеокодека, используемого для кодирования и декодирования видеопотока. Возможные значения: `spice:mjpeg`; `gstreamer:vp8`; `gstreamer:h264`
Настройки запуска и отображения графического интерфейса
`minimize`	`Не задано`	Запуск графического интерфейса приложения `x11tera` в оконном режиме. По умолчанию графический интерфейс не отображается, т.к. ПО x11tera запускается как служба ОС. Параметр является унарным аргументом и может использоваться при вызове приложения `x11tera`. Пример использования: x11tera --minimize 127.0.0.1:5905
`hide`	`Не задано`	Сокрытие графического интерфейса приложения `x11tera` в трей. По умолчанию графический интерфейс не отображается, т.к. ПО x11tera запускается как служба ОС. Параметр является унарным аргументом и может использоваться при вызове приложения `x11tera`. Пример использования: x11tera --hide 127.0.0.1:5905
Настройки дисплея
`display`	`:0`	Не рекомендуется менять параметр. Выбор дисплея для подключения пользователя. По умолчанию используется значение, полученное из переменной окружения ОС `DISPLAY`
Настройки завершения выполнения ПО x11tera
`exit-on-disconnect`	`false`	Параметр не используется, приведен для справки. Управление режимом завершения приложения `x11tera` после отключения первого пользователя. Возможные значения: `true` - ПО x11tera завершится после отключения первого пользователя от сессии; `false` - ПО x11tera не завершится после отключения первого пользователя от сессии
Настройки вывода диагностической информации
`debug-draws`	`0`	Управление режимом вывода диагностической информации в стандартное устройство вывода. Возможные значения: `0` - вывод диагностической информации отключен; `1` - вывод базовой диагностической информации; `2` - вывод подробной диагностической информации
Настройки перенаправления USB-устройств
`usb-channel-num`	`0`	Задание количества каналов для перенаправления USB-устройств. Диапазон значений: от 0 до 8
Настройки перенаправления каталога
`webdav-channel-enable`	`true`	Управление перенаправлением каталога из пользовательской рабочей станции в ОС физической машины. Возможные значения: `true` - разрешить перенаправление каталога; `false` - запретить перенаправление каталога
Настройки аудио
`audio-codec`	`opus`	Выбор аудиокодека, используемого для кодирования и декодирования аудиопотока. Возможные значения: `opus`; `pcm`
`audio-channels`	`2`	Управление количеством аудиоканалов. Возможные значения: `1,`2
`audio-sample-rate`	`0`	Управление частотой дискретизации (Гц). Возможные значения: для аудиокодека opus: `0`, `8000`, `12000`, `16000`, `24000`, `48000`; для аудиокодека pcm: `0`, `2000`, `4000`, `6000`, `8000`, `12000`, `16000`, `24000`, `44100`. Если для параметра используется значение `0`, то ключевым параметром кодирования становится битрейт
`audio-bitrate`	`0`	Задание битрейта (Кбит/с) на один канал. Возможные значения: `0`, `8`, `12`, `16`, `24`, `32`, `48`, `64`, `128`. Если для параметра используется значение `0`, то используется битрейт, поддерживаемый аудиокодеком
`audio-vbr`	`true`	Управление использованием среднего (переменного) битрейта (Кбит/с) аудиопотока на один канал. Возможные значения: `true` - используется среднее значение битрейта для аудиопотока; `false` - значение битрейта задается параметром `audio-bitrate`
Настройки SSL/TLS
`enabled`	`false`	Управление режимом использования защищенного соединения SSL/TLS. Возможные значения: `true` - SSL/TLS используется, должны быть указаны валидные сертификаты в соответствующих параметрах; `false` - SSL/TLS не используется
`ca-cert-file`	`ca-cert.pem`	Путь к файлу корневого сертификата для SSL/TLS. По умолчанию параметр не используется (закомментирован)
`certs-file`	`server-cert.pem`	Путь к файлу серверного сертификата SSL/TLS. По умолчанию параметр не используется (закомментирован)
`private-key-file`	`server-key.pem`	Путь к файлу ключа для SSL/TLS. По умолчанию параметр не используется (закомментирован)
`dh-key-file`	`Не задано`	Путь к файлу с ключами Диффи-Хеллмана для SSL/TLS. По умолчанию параметр не используется (закомментирован)
`ciphersuite`	`HIGH`	Выбор списка алгоритмов преобразования для использования в соединении SSL/TLS. Список поддерживаемых алгоритмов определяется SSL-библиотекой, установленной в ОС. По умолчанию параметр не используется (закомментирован)