Трансляция RDP-сессии
Трансляция RDP-сессий позволяет просматривать сеансы машин роботов и управлять ими через веб-интерфейс Оркестратора. Для работы трансляции необходимо согласовать конфигурации службы RDP2, WebApi и обратного прокси-сервера Nginx (либо IIS).
Настройка зависит от количества экземпляров службы RDP2:
- Один экземпляр RDP2 обслуживает все машины роботов. В WebApi используется параметр
RdpBaseUrl. - Несколько экземпляров RDP2 обслуживают непересекающиеся наборы машин роботов. Распределение задаётся параметром
AddressFilter, а адреса трансляций — параметромRdpBaseUrlsв WebApi.
Параметры конфигурации
Параметры трансляции RDP-сессий находятся в секции 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.

Важно. Правило проксирования трансляции необходимо разместить перед правилом проксирования
/api/либо выше него с учётом используемых правил сопоставления URI.
Если вместо Nginx используется IIS, аналогичное правило настраивается в файле Web.config узла Primo.UI.

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

Ниже приведён пример для двух служб RDP2. В нём используются следующие адреса:
| Компонент | IP-адрес | Назначение |
|---|---|---|
| Оркестратор | 192.168.61.133 | Внешний адрес https://192.168.61.133:44392 |
| RDP2 № 1 | 192.168.61.210 | Обслуживает машину робота 192.168.61.200 |
| RDP2 № 2 | 192.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-запросу может быть неверным. |
AddressFilter | IP-адреса машин роботов, обслуживаемых экземпляром RDP2. Если адресов несколько, они перечисляются через запятую. |
Kestrel.EndPoints.ExternalHttps.Url | HTTPS-адрес и порт, на которых служба принимает подключения через прокси. |
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.200 | https://192.168.61.133:44392/rdpstream1 | 192.168.61.210:5102 |
192.168.61.230 | https://192.168.61.133:44392/rdpstream2 | 192.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-pager5. Проверка работы трансляции
После настройки выполните проверки:
-
Убедитесь, что каждая служба RDP2 запущена и прослушивает нужный HTTPS-порт (в примере —
5102). На Linux используйтеsystemctl status Primo.Orchestrator.RDP2и журнал службы. -
Проверьте доступность Оркестратора с сервера RDP2:
curl -sk -o /dev/null -w "%{http_code}\n" https://192.168.61.133:44392/Для приведённого стенда ожидается HTTP
200. -
С сервера Оркестратора проверьте доступность порта каждого сервера RDP2:
Test-NetConnection 192.168.61.210 -Port 5102 Test-NetConnection 192.168.61.215 -Port 5102Ожидается
TcpTestSucceeded: True. -
Убедитесь, что запросы службы к
GET /api/RdpSessions?addressFilter=...получают ответ200. -
Проверьте проксирование запроса к трансляции без токена, например
https://192.168.61.133:44392/rdpstream1/api/DesktopStream/1/mjpeg. На описанном стенде ожидается401от RDP2. Ответ200с содержимымindex.htmlуказывает на возможное отсутствие правилаlocation, а502— на проблему соединения с upstream. -
Откройте трансляцию в веб-интерфейсе. Убедитесь, что запрос
GET /api/RdpSessions/BaseUrl/{id_сессии}возвращает200, а запрос/rdpstreamN/api/DesktopStream/...направляется к нужной службе RDP2.
6. Типовые ошибки
| Симптом | Возможная причина | Рекомендуемые действия |
|---|---|---|
Ошибка авторизации в Оркестраторе повторяется в журнале RDP2 | Расхождение системного времени серверов | Проверьте синхронизацию времени по разделу 4. |
No route to host или Connection refused при подключении к Оркестратору | Нет сетевой доступности Оркестратора или не работает прокси | Проверьте сеть, правила межсетевого экрана и состояние Nginx. |
StatusCode=BadGateway в журнале RDP2 | Nginx доступен, но 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. Для других версий и схем развёртывания необходимо проверить применимость параметров и команд.
