Параметры запуска службы tera-router

Параметры запуска службы tera-router задаются в файле /lib/systemd/system/tera-router.service.

В зависимости от дистрибутива ОС путь может отличаться.

При запуске службы tera-route передаются дополнительные аргументы командной строки ПО tera-router (см. подраздел Интерфейс командной строки ПО tera-router), что обеспечивает гибкую настройку работы ПО.

Одним из параметров службы tera-router является аргумент EnvironmentFile, задающий путь к переменным окружения, а также дополнительные аргументы, перечисленные в файле /etc/termidesk/tera-router.conf.

Файл /etc/termidesk/tera-router.conf:

  • является необязательным и может отсутствовать в ОС;
  • содержит параметры, задающие дополнительные аргументы для запуска службы tera-router. 

Пример содержимого файла /etc/termidesk/tera-router.conf по умолчанию:

TERA_SRV_PRIMARY_ARGS="-c 0:0:0:127.0.0.1:5900"
#TERA_ROUTER_ADDRESS=0.0.0.0
#TERA_ROUTER_PORT=6000
#TERA_SRV_FALLBACK_ARGS="-c 0:0:0:127.0.0.1:5902"
#TERA_ROUTER_UDP_ARGS="-l 20:21 -b 3:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6010:1
#TERA_ROUTER_EXTRA_ARGS="-d"
BASH

Настройка службы tera-router зависит от настроек конфигурационного файла /etc/X11/xorg.conf.d/30-teraqxl.xorg.conf.

Например, для направления всех подключений на порт 5900 используются следующие настройки в /etc/termidesk/tera-router.conf:

  • если заданы Option "SpicePort" "5902,5904" и Option "SpiceAddr" "127.0.0.1", то:
TERA_ROUTER_PORT=5900
TERA_SRV_PRIMARY_ARGS="-c 0:0:0:127.0.0.1:5902"
TERA_SRV_FALLBACK_ARGS="-c 0:0:0:127.0.0.1:5904"
BASH
  • если заданы Option "SpicePort" "5903,5905" и Option "SpiceAddr" "127.0.0.1", то:
TERA_ROUTER_PORT=5901
TERA_SRV_PRIMARY_ARGS="-c 0:0:0:127.0.0.1:5903"
TERA_SRV_FALLBACK_ARGS="-c 0:0:0:127.0.0.1:5905"
BASH

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

Параметры запуска службы tera-router

ПараметрЗначение по умолчаниюОписание
TERA_ROUTER_ADDRESS

0.0.0.0

Адрес прослушивания входящих подключений.

Значение 0.0.0.0 - зарезервированный адрес,  задающий прослушивание подключений на всех сетевых интерфейсах. При необходимости его можно заменить на IP-адрес какого-то одного сетевого интерфейса

TERA_ROUTER_PORT6000

Порт прослушивания входящих подключений

TERA_SRV_PRIMARY_ARGS

"-c 0:0:0:127.0.0.1:5900"

Основные настройки для подключения к TERA, которые будут использоваться для всех входящих подключений

TERA_SRV_FALLBACK_ARGS
Не задано

Резервные настройки для подключения к TERA, которые будут использоваться для всех входящих подключений, если интерфейс с основными настройками недоступен

TERA_ROUTER_UDP_ARGS
Не задано

Настройки для UDP-трафика. Описание параметров приведено в таблице

TERA_ROUTER_EXTRA_ARGSНе заданоПеременная окружения для передачи дополнительных аргументов командной строки в ПО tera-router (см. подраздел Интерфейс командной строки ПО tera-router)
Ключи, используемые в параметре TERA_ROUTER_EXTRA_ARGS

КлючОписание

-l

Включение определения типа канала по пакету состояния канала.

Ключ применим только для открытого трафика.

Формат значения: [type_offset]:[id_offset]

Пример значения: 20:21

-b

Прослушиваемый интерфейс. Можно указать несколько.

По умолчанию используется 0.0.0.0. Значение рекомендуется переопределить, указав реальный IP-адрес. При использовании значения по умолчанию будет использоваться адрес первого доступного сетевого интерфейса (не localhost).

Формат значения:

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]>.

Информация по параметрам, передающимся в значении, приведена в таблице.

Пример значения: 3:0:0:0.0.0.0:6010:1

Параметры для значений ключей

ПараметрОписание

[тип_канала]

Тип канала. Обязательный параметр.

Возможные значения:

  • 1 - MAIN;
  • 2 - DISPLAY;
  • 3 - INPUTS;
  • 4 - CURSOR;
  • 5 - PLAYBACK;
  • 6 - RECORD;
  • 7 - TUNNEL;
  • 8 - SMARTCARD;
  • 9 - USBREDIR;
  • 10 - PORT;
  • 11 - WEBDAV

[идентификатор_канала]

Идентификатор канала. Обязательный параметр

[метка]

Метка, выставляемая на пакеты. Обязательный параметр

[IP-адрес]

IP-адрес. Обязательный параметр

[порт]

Порт. Обязательный параметр

[протокол]

Протокол. Необязательный параметр

Возможные значения:

  • 0 (умолчанию) для TCP;
  • любое другое целочисленное значение для UDP

Примеры использования приведены в таблице.

Примеры использования для UDP

СценарийПример

Настройка для UDP-канала INPUTS (3) c идентификатором 0 и меткой 0

Значение для ключа -b: 3:0:0.

Примеры задания TERA_ROUTER_UDP_ARGS:

TERA_ROUTER_UDP_ARGS="-l 20:21 -b 3:0:0:0.0.0.0:6010:1"
BASH 
TERA_ROUTER_UDP_ARGS="-l 20:21 -b 3:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6010:1"
BASH

Настройка для UDP-каналов INPUTS и CURSOR

Значения для ключа -b: 3:0:0 и 4:0:0.

Примеры задания TERA_ROUTER_UDP_ARGS:

TERA_ROUTER_UDP_ARGS="-l 20:21 -b 3:0:0:0.0.0.0:6010:1 -b 4:0:0:0.0.0.0:6020:1
BASH 
TERA_ROUTER_UDP_ARGS="-l 20:21 -b 3:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6010:1 -b 4:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6020:1"
BASH