Skip to Content

Трансляция RDP-сессии

Трансляция RDP-сессий позволяет просматривать сеансы машин роботов и управлять ими через веб-интерфейс Оркестратора. Для работы трансляции необходимо согласовать конфигурации службы RDP2, WebApi и обратного прокси-сервера Nginx (либо IIS).

Настройка зависит от количества экземпляров службы RDP2:

  • Один экземпляр RDP2 обслуживает все машины роботов. В WebApi используется параметр RdpBaseUrl.
  • Несколько экземпляров RDP2 обслуживают непересекающиеся наборы машин роботов. Распределение задаётся параметром AddressFilter, а адреса трансляций — параметром RdpBaseUrls в WebApi.

Параметры конфигурации

Параметры трансляции RDP-сессий находятся в секции RDP конфигурационного файла WebApi.

Секция RDP в конфигурационном файле WebApi

ПараметрНазначениеПримечание
RdpBaseUrlВнешний URL точки доступа к единственной службе RDP2 через Nginx или IIS.Используется при настройке одного экземпляра RDP2 для всех машин роботов. Формируется на основе внешнего адреса Оркестратора, например https://192.168.0.19:44392/rdpstream.
RdpBaseUrlsСопоставление IP-адресов машин роботов с внешними URL трансляции, которые проксируются на соответствующие экземпляры RDP2.Ключ — IP-адрес машины робота, значение — внешний URL вида https://<адрес-оркестратора>/rdpstreamN. IP-адрес сервера RDP2 здесь не используется как ключ.

Важно. В конфигурации с несколькими службами RDP2 ключи RdpBaseUrls должны соответствовать адресам машин роботов из AddressFilter, а не значениям Host. Если для IP машины не найдено соответствие, WebApi может вернуть 404 при запросе адреса трансляции. Такое поведение проверено на WebApi 1.26.7.18.

Вариант 1. Один экземпляр RDP2 для всех машин роботов

Если все машины роботов обслуживает одна служба RDP2, в WebApi используется RdpBaseUrl. Параметр RdpBaseUrls не применяется. В конфигурации службы RDP2 параметр AddressFilter не задаётся, а параметр Host можно не указывать.

Ниже приведён пример конфигурации Nginx для одного экземпляра RDP2.

Настройка Nginx для одной службы RDP2

Важно. Правило проксирования трансляции необходимо разместить перед правилом проксирования /api/ либо выше него с учётом используемых правил сопоставления URI.

Если вместо Nginx используется IIS, аналогичное правило настраивается в файле Web.config узла Primo.UI.

Настройка IIS для одной службы RDP2

Вариант 2. Несколько экземпляров RDP2

В конфигурации с несколькими службами каждая служба RDP2 обслуживает собственный набор машин роботов. Наборы задаются параметрами AddressFilter и не должны пересекаться. Каждый экземпляр RDP2 развёртывается на отдельном сервере.

Распределение машин роботов между службами RDP2

Ниже приведён пример для двух служб RDP2. В нём используются следующие адреса:

КомпонентIP-адресНазначение
Оркестратор192.168.61.133Внешний адрес https://192.168.61.133:44392
RDP2 № 1192.168.61.210Обслуживает машину робота 192.168.61.200
RDP2 № 2192.168.61.215Обслуживает машину робота 192.168.61.230

Примеры соответствуют тестовому стенду с Оркестратором 1.26.7.18 (Windows Server 2019) и RDP2 1.26.7.3 (Astra Linux). Адреса и пути необходимо заменить значениями своего окружения.

1. Настройка служб RDP2

На Astra Linux конфигурационный файл службы RDP2 расположен по пути:

/opt/Primo/RDP2/appsettings.ProdLinux.json

ПараметрНазначение
Orchestrator.BaseUrlВнешний URL Оркестратора, доступный со стороны сервера RDP2.
EnabledOriginsРазрешённые источники запросов к RDP2. Должен содержать внешний URL Оркестратора.
HostСобственный IP-адрес сервера RDP2. Рекомендуется задавать явно, поскольку автоматическое определение адреса по HTTP-запросу может быть неверным.
AddressFilterIP-адреса машин роботов, обслуживаемых экземпляром RDP2. Если адресов несколько, они перечисляются через запятую.
Kestrel.EndPoints.ExternalHttps.UrlHTTPS-адрес и порт, на которых служба принимает подключения через прокси.
MaxSessionsLimitКоличество RDP-подключений, создаваемых службой за один цикл.

Для RDP2 № 1 (сервер 192.168.61.210, машина робота 192.168.61.200) задайте следующие значения параметров в соответствующих секциях конфигурационного файла:

{ "EnabledOrigins": ["https://192.168.61.133:44392"], "Orchestrator": { "BaseUrl": "https://192.168.61.133:44392" }, "Host": "192.168.61.210", "MaxSessionsLimit": 3, "AddressFilter": "192.168.61.200" }

Для RDP2 № 2 (сервер 192.168.61.215, машина робота 192.168.61.230):

{ "EnabledOrigins": ["https://192.168.61.133:44392"], "Orchestrator": { "BaseUrl": "https://192.168.61.133:44392" }, "Host": "192.168.61.215", "MaxSessionsLimit": 3, "AddressFilter": "192.168.61.230" }

Приведены только параметры, относящиеся к описываемой настройке. Остальные параметры существующего конфигурационного файла необходимо сохранить.

Важно. Если используется несколько экземпляров RDP2, не оставляйте AddressFilter пустым и не включайте одну машину робота в фильтры разных экземпляров. Иначе службы могут одновременно пытаться обслуживать одну RDP-сессию.

После изменения конфигурации перезапустите службу RDP2 на каждом сервере:

sudo systemctl restart Primo.Orchestrator.RDP2

Убедитесь, что служба зарегистрировалась в Оркестраторе. В журнале WebApi при этом может появиться сообщение Обновление таблицы Rdp2AddressFilter от RDP2 на <Host>.

2. Настройка WebApi

На Windows конфигурация WebApi в приведённом примере находится в файле C:\Primo\WebApi\appsettings.ProdWin.json; на Linux используется файл appsettings.ProdLinux.json соответствующего развертывания.

В секции RDP задайте RdpBaseUrls, сопоставив IP-адреса машин роботов с путями проксирования на обслуживающие их экземпляры RDP2:

{ "RDP": { "RdpBaseUrls": { "192.168.61.200": "https://192.168.61.133:44392/rdpstream1", "192.168.61.230": "https://192.168.61.133:44392/rdpstream2" } } }

Это фрагмент секции RDP; другие существующие параметры секции сохраняются.

IP машины робота (ключ)URL трансляцииСервер RDP2
192.168.61.200https://192.168.61.133:44392/rdpstream1192.168.61.210:5102
192.168.61.230https://192.168.61.133:44392/rdpstream2192.168.61.215:5102

Если одна служба RDP2 обслуживает несколько машин, добавьте для каждой машины отдельный ключ RdpBaseUrls с одинаковым URL трансляции.

При открытии трансляции веб-интерфейс запрашивает GET /api/RdpSessions/BaseUrl/{id_сессии}. WebApi определяет IP-адрес машины робота и ищет его в RdpBaseUrls. Для WebApi 1.26.7.18 отсутствие ключа приводит к ответу 404: автоматического перехода на RdpBaseUrl не происходит.

После изменения конфигурации перезапустите службу Primo.Orchestrator.WebApi и обновите страницу браузера, чтобы веб-интерфейс получил актуальный URL трансляции.

3. Настройка Nginx

Для каждого пути /rdpstreamN, указанного в RdpBaseUrls, настройте отдельный upstream и location с поддержкой WebSocket.

В приведённом примере конфигурационный файл Nginx расположен по пути C:\Primo\nginx-1.21.1\conf\nginx.conf.

Внутри блока http { ... } добавьте:

upstream rdpstream1 { server 192.168.61.210:5102; } upstream rdpstream2 { server 192.168.61.215:5102; }

Внутри соответствующего блока server { ... }, принимающего HTTPS-запросы Оркестратора, добавьте правила проксирования:

location /rdpstream1/ { proxy_pass https://rdpstream1; rewrite ^/rdpstream1/(.*) /$1 break; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; proxy_read_timeout 3600s; proxy_send_timeout 3600s; } location /rdpstream2/ { proxy_pass https://rdpstream2; rewrite ^/rdpstream2/(.*) /$1 break; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; proxy_read_timeout 3600s; proxy_send_timeout 3600s; }

Особенности настройки:

  • proxy_pass использует https://, поскольку в данном примере RDP2 принимает TLS-подключения на порту 5102.
  • rewrite удаляет префикс /rdpstreamN/ перед отправкой запроса в RDP2. Например, /rdpstream1/api/DesktopStream/36/mjpeg преобразуется в /api/DesktopStream/36/mjpeg.
  • Заголовки Upgrade и Connection обеспечивают проксирование WebSocket; увеличенные тайм-ауты используются для длительных подключений.
  • Старый путь /rdpstream/ допустимо сохранить для существующей конфигурации. Если за ним нет доступной службы RDP2, обращения к нему могут возвращать 502.

Проверьте конфигурацию Nginx из каталога его установки:

.\nginx.exe -t

После успешной проверки примените изменения, перезапустив службу nginx в соответствии с порядком администрирования сервера. При запуске Nginx как службы команда nginx.exe -s reload в некоторых окружениях завершается ошибкой Access is denied.

Если вместо Nginx используется IIS, настройте соответствующие правила маршрутизации в Web.config узла Primo.UI. Примеры конкретных правил IIS для нескольких RDP2 в исходном материале не приведены.

4. Синхронизация времени на серверах

Системное время серверов RDP2 должно быть синхронизировано с временем Оркестратора. Значительное расхождение часов может приводить к отклонению токенов и повторяющимся сообщениям Ошибка DefiningAndRecordingChange и Ошибка авторизации в Оркестраторе в журнале RDP2.

На Astra Linux проверьте настройки времени:

timedatectl

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

Если NTP недоступен и установлено, что RTC содержит местное время, а система неверно интерпретирует его как UTC, возможен следующий вариант исправления:

sudo timedatectl set-local-rtc 1 --adjust-system-clock sudo systemctl restart Primo.Orchestrator.RDP2

Предупреждение. Изменение режима RTC применяйте только после проверки конфигурации времени виртуальной машины и операционной системы. Обычно предпочтительнее использовать RTC в UTC и настроенную синхронизацию NTP.

Для просмотра журнала текущего процесса RDP2 можно использовать:

journalctl _PID=$(systemctl show -p MainPID --value Primo.Orchestrator.RDP2) --no-pager

5. Проверка работы трансляции

После настройки выполните проверки:

  1. Убедитесь, что каждая служба RDP2 запущена и прослушивает нужный HTTPS-порт (в примере — 5102). На Linux используйте systemctl status Primo.Orchestrator.RDP2 и журнал службы.

  2. Проверьте доступность Оркестратора с сервера RDP2:

    curl -sk -o /dev/null -w "%{http_code}\n" https://192.168.61.133:44392/

    Для приведённого стенда ожидается HTTP 200.

  3. С сервера Оркестратора проверьте доступность порта каждого сервера RDP2:

    Test-NetConnection 192.168.61.210 -Port 5102 Test-NetConnection 192.168.61.215 -Port 5102

    Ожидается TcpTestSucceeded: True.

  4. Убедитесь, что запросы службы к GET /api/RdpSessions?addressFilter=... получают ответ 200.

  5. Проверьте проксирование запроса к трансляции без токена, например https://192.168.61.133:44392/rdpstream1/api/DesktopStream/1/mjpeg. На описанном стенде ожидается 401 от RDP2. Ответ 200 с содержимым index.html указывает на возможное отсутствие правила location, а 502 — на проблему соединения с upstream.

  6. Откройте трансляцию в веб-интерфейсе. Убедитесь, что запрос GET /api/RdpSessions/BaseUrl/{id_сессии} возвращает 200, а запрос /rdpstreamN/api/DesktopStream/... направляется к нужной службе RDP2.

6. Типовые ошибки

СимптомВозможная причинаРекомендуемые действия
Ошибка авторизации в Оркестраторе повторяется в журнале RDP2Расхождение системного времени серверовПроверьте синхронизацию времени по разделу 4.
No route to host или Connection refused при подключении к ОркестраторуНет сетевой доступности Оркестратора или не работает проксиПроверьте сеть, правила межсетевого экрана и состояние Nginx.
StatusCode=BadGateway в журнале RDP2Nginx доступен, но WebApi не запущен либо временно недоступенПроверьте работу WebApi и его журнал.
Не найдено соответствие для <IP> в RdpBaseUrls секции RDP; запрос BaseUrl/{id} возвращает 404В RdpBaseUrls отсутствует ключ с IP-адресом машины роботаСверьте RdpBaseUrls и AddressFilter. Не используйте IP сервера RDP2 вместо IP робота.
Трансляция возвращает 502; в error.log есть ошибка подключения к upstreamСлужба RDP2 недоступна по указанному адресу или портуПроверьте upstream, IP-адрес, порт и состояние службы RDP2.
Вместо трансляции возвращается HTML-страницаДля /rdpstreamN/ отсутствует или неверно применяется правило locationПроверьте маршрутизацию в Nginx.

Расположение журналов для приведённого стенда:

  • RDP2 (Astra Linux): /opt/Primo/RDP2/Logs/log-YYYYMMDD.txt, journalctl -u Primo.Orchestrator.RDP2.
  • WebApi (Windows): C:\Primo\WebApi\Logs\.
  • Nginx (Windows): C:\Primo\nginx-1.21.1\logs\access.log и error.log.

Примечание. Примеры настройки и диагностики нескольких экземпляров RDP2 приведены по результатам проверки на Оркестраторе 1.26.7.18 и RDP2 1.26.7.3. Для других версий и схем развёртывания необходимо проверить применимость параметров и команд.

Пример параметра EnabledOrigins службы RDP2