Шлюз. Параметры конфигурирования

Параметры конфигурирования компонента

Параметры Шлюза задаются переменными, описанными в файле /etc/opt/termidesk-vdi/termidesk.conf, а также аргументами командной строки.

Перечень доступных переменных и аргументов приведен в таблице.

Информация в таблице относится к ранее установленному с Termidesk Шлюзу termidesk-wsproxy.

Доступные переменные Шлюза

Наименование переменной	Значение по умолчанию	Описание	Аргумент командной строки
`WSPROXY_PORT`	`5099`	Порт прослушивания службы	`Не задан`
`WSPROXY_BIND_ADDRESS`	`"127.0.0.1"`	Адрес прослушивания службы. При распределенной установке необходимо использовать значение `"0.0.0.0"`, чтобы порт `5099` прослушивался не только `localhost`, если планируется принимать запросы на подключения с внешних систем (например, с балансировщиков нагрузки)	`Не задан`
`WSPROXY_HEALTH_CHECK_PORT`	`8101`	Порт веб-сервера для обслуживания API-запросов по состоянию Шлюза (`healthcheck`). По умолчанию переменная не используется (закомментирована)	`Не задан`
`WSPROXY_HEALTH_CHECK_CERT`	`/etc/opt/termidesk-vdi/wsproxy-healthcheck.pem`	Путь к сертификату (открытому ключу), который используется для защиты подключения API-запросов по состоянию Шлюза (`healthcheck`). По умолчанию переменная не используется (закомментирована)	`Не задан`
`WSPROXY_HEALTH_CHECK_KEY`	`/etc/opt/termidesk-vdi/wsproxy-healthcheck.key`	Путь к закрытому ключу, который используется для защиты подключения API-запросов по состоянию Шлюза (`healthcheck`). По умолчанию переменная не используется (закомментирована)	`Не задан`
`LOG_LEVEL`	INFO	Аргумент командной строки применяется для изменения уровня логирования Шлюза. Изначально уровень логирования применяется из значения переменной `LOG_LEVEL` конфигурационного файла `/etc/opt/termidesk-vdi/termidesk.conf`. Для того, чтобы применить уровень логирования из аргумента командной строки, необходимо отредактировать `unit`-файл службы Шлюза: открыть для редактирования файл `/lib/systemd/system/termidesk-wsproxy.service`; найти строку, начинающуюся с `ExecStart` и добавить ключ `--loglevel` с нужным уровнем. Пример строки: `ExecStart=/opt/termidesk/share/termidesk-vdi/venv/bin/python wsproxy.py --verification-key=/etc/opt/termidesk-vdi/wsproxy/id_rsa.pub --host=${WSPROXY_BIND_ADDRESS} --port=${WSPROXY_PORT} --loglevel=INFO` BASH Затем выполнить перезапуск конфигурации и службы: выполнить команду `sudo systemctl daemon-reload`; выполнить команду `sudo systemctl restart termidesk-wsproxy`.	`--loglevel`

Далее информация относится к новому (экспериментальному) Шлюзу termidesk-gateway.

Параметры конфигурирования нового Шлюза задаются из конфигурационного файла /etc/termidesk/termidesk-gateway.conf.

Для задания параметров конфигурирования нового Шлюза из файла необходимо:

создать пустой файл /etc/termidesk/termidesk-gateway.conf:

:~$ sudo touch /etc/termidesk/termidesk-gateway.conf

BASH

отредактировать файл termidesk-gateway, указав необходимые значения для параметров:

# Адреса, на которых принимать входящие подключения
wsServerIP=0.0.0.0
# Прослушиваемый порт для входящих подключений
wsServerPort=5099
# Адрес брокера, по которому будет осуществляться проверка пользовательских подключений
urlCheckToken=http://127.0.0.1:8000/api/wsproxy/v1/verify
# Режим журналирования. 
# gatewayLogMode=-l - включить отладку уровня INFO.
# gatewayLogMode=-d - включить отладку уровня DEBUG.
# Пустое значение параметра gatewayLogMode= - выключить отладку.
# gatewayLogMode=-l

BASH

выполнить перезагрузку службы:

:~$ sudo systemctl restart termidesk-gateway

BASH

Доступные параметры, а также аргументы командной строки для нового Шлюза приведены в таблице.

Доступные переменные нового Шлюза

Наименование переменной	Значение по умолчанию после установки Шлюза	Описание	Аргумент командной строки
`wsServerPort`	`5099`	Порт прослушивания службы для входящих подключений	`Не задан`
`wsServerIP`	`127.0.0.1`	Адрес прослушивания входящих подключений. При распределенной установке необходимо использовать значение `"0.0.0.0"`, чтобы порт `5099` прослушивался не только `localhost`, если планируется принимать запросы на подключения с внешних систем (например, с балансировщиков нагрузки)	`Не задан`
`urlCheckToken`	`http://127.0.0.1:8080/api/wsproxy/v1/verify`	Адрес диспетчера Termidesk для обслуживания API-запросов по состоянию Шлюза	`Не задан`
`gatewayLogMode`	`Нет`	Активация и переключение режима журналирования. Значение задается через файл `termidesk-gateway.conf`. При значении «`-d`» активируется подробный режим уровня DEBUG, при значении «`-l`» активируется менее подробный режим уровня INFO. Пустое значение параметра приводит к отключению режима журналирования. Активировать режим можно также через аргумент командной строки, для этого выполнить: `:~$ termidesk-gateway <значение>` BASH Пример: `:~$ termidesk-gateway -l` BASH Информация будет выводится в стандартный вывод (в интерфейс командной строки). Для прекращения вывода и отключения режима необходимо нажать сочетание клавиш <Ctrl>+<C>	`-d` `-l`