Интерфейс командной строки ПО tera-router

Пакет tera-router требуется для обеспечения подключения по UDP через шлюз, во всех других случаях (без UDP через шлюз, прямое подключение без шлюза) проксирование подключений не требуется

Параметры запуска ПО tera-router могут быть заданы:

Для получения краткой информации по доступным параметрам командной строки следует выполнить:

tera-router --help

Для запуска ПО tera-router из командной строки используется следующий формат вызова:

tera-router [ключ] [значение]

Список доступных параметров приведен в таблице (см. таблицу Параметры командной строки ПО tera-router).

Таблица 1. Параметры командной строки ПО tera-router
Ключ Описание

-d

Включение отладочного уровня журналирования событий.

Альтернативный метод: задать переменную окружения TDSK_DEBUG.

Не требует указания значения

-a

Клиентская часть: включение запроса схем маршрутизации с сервера.

Не требует указания значения

-l

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

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

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

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

-b

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

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

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

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]><:[время_ожидания]><:[размер_буфера]>.

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

Пример значения: 0:0:0:192.0.2.1:5800

-r

Маршрут для TCP/UDP трафика:

  • если применяется на клиентской стороне, то определяет маршрутизацию для TCP и UDP трафика;

  • если применяется на серверной стороне, то определяет обратную маршрутизацию UDP трафика.

Особенности функционирования:

  • для корректной работы TCP-маршрутизации необходимо, чтобы конфигурации сервера и клиента соответствовали друг другу;

  • при использовании UDP обязательна двусторонняя настройка маршрутов (-r) на обоих концах.

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

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]><:[время_ожидания]><:[размер_буфера]>.

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

Пример значения: 0:0:0:192.0.2.2:5800

-с

Интерфейс для подключения. Можно указать несколько, в этом случае будет использоваться первый доступный.

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

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]><:[время_ожидания]><:[размер_буфера]>.

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

Пример значения: 0:0:0:127.0.0.1:5900
Таблица 2. Параметры для значений ключей ПО tera-router
Параметр Описание

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

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

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

  • 1 - MAIN;

  • 2 - DISPLAY;

  • 3 - INPUTS;

  • 4 - CURSOR;

  • 5 - PLAYBACK;

  • 6 - RECORD;

  • 7 - TUNNEL;

  • 8 - SMARTCARD;

  • 9 - USBREDIR;

  • 10 - PORT;

  • 11 - WEBDAV

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

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

[метка]

Метка, выставляемая на пакеты. Обязательный параметр, устанавливается только для ключа -r

[IP-адрес]

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

[порт]

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

[протокол]

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

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

  • 0 (умолчанию) для TCP;

  • любое другое целочисленное значение для UDP

[время_ожидания]

Время ожидания (в миллисекундах) для операций чтения или записи. Необязательный параметр.

Значение по умолчанию: 1200 (1,2 секунды)

[размер_буфера]

Размер буфера (в Кбайтах) для чтения или записи данных. Необязательный параметр.

Значение по умолчанию:

  • 16 КБ (TCP);

  • 8 КБ (UDP)

Примеры использования приведены в таблице (см. таблицу Сценарии вызова ПО tera-router).

Таблица 3. Сценарии вызова ПО tera-router
Сценарий Пример

Передача всех каналов по протоколу TCP

Серверная часть (IP-адрес: 192.0.2.1):

tera-router -l 20:21 -b 0:0:0:192.0.2.1:5800 -c 0:0:0:127.0.0.1:5900

Клиентская часть (IP-адрес: 192.0.2.2):

tera-router -l 20:21 -b 0:0:0:127.0.0.1:5900 -r 0:0:0:192.0.2.2:5800

Раздельная маршрутизация по протоколам

Серверная часть (IP-адрес: 192.0.2.1):

tera-router -l 20:21 \
  -b 0:0:0:192.0.2.1:5800 \
  -b 10:0:0:192.0.2.1:5810:1 \
  -r 10:0:0:192.0.2.2:5810:1 \
  -c 0:0:0:127.0.0.1:5900

Клиентская часть (IP-адрес: 192.0.2.2):

tera-router -l 20:21 \
  -b 0:0:0:127.0.0.1:5900 \
  -r 0:0:0:192.0.2.1:5800 \
  -b 10:0:0:192.0.2.2:5810:1 \
  -r 10:0:0:192.0.2.1:5810:1

Пояснение:

  • канал 0:0 передается по TCP через порт 5800;

  • канал 10:0 передается по UDP (протокол = 1) через порт 5810;

  • на сервере и клиенте настроены взаимные UDP-маршруты для канала 10:0

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

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

Примеры запуска:

tera-router -l 20:21 \
  -b 3:0:0:0.0.0.0:6010:1
tera-router -l 20:21 \
  -b 3:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6010:1

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

 
tera-router -l 20:21 \
  -b 3:0:0:0.0.0.0:6010:1 \
  -b 4:0:0:0.0.0.0:6020:1
tera-router -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