Инструкция — Windows

1. Обзор

UwebRDP для Windows 10/11 — универсальное приложение удалённого рабочего стола. Работает одновременно как хост (расшаривание экрана) и как клиент (управление удалённым компьютером). Соединение P2P через WebRTC, видео передаётся напрямую между устройствами.

2. Подключение

Доступно два режима подключения:

• Broker (Интернет) — хост регистрируется на сигнальном сервере wss://brocker.uwebrdp.ru/ws и получает код вида AB3-7X2. Клиент вводит этот код для подключения. Соединение P2P, брокер используется только для обмена адресами (SDP/ICE). При невозможности прямого соединения задействуется TURN-сервер.
• LAN (Локальная сеть) — хост запускает локальный HTTP+WS сервер на порту 9090. Клиент подключается по IP-адресу хоста, например 192.168.1.100:9090.

В обоих режимах хост может установить пароль. Клиенту потребуется ввести пароль для подключения.

3. Хост

После запуска хоста в режиме «Через интернет» приложение регистрируется на брокере и получает уникальный код сессии. Код отображается в карточке хоста. Функция LOCK фиксирует код — при перезапуске хоста код не изменится.

В режиме «Локальная сеть» хост запускает HTTP+WS сервер. Другие устройства в сети видят хост автоматически через LAN-обнаружение.

4. Сессия

После успешного подключения открывается экран удалённого рабочего стола. В верхней части экрана расположена плавающая панель инструментов с информацией о сессии и элементами управления.

Панель показывает: код сессии, кнопки управления (полноэкранный режим, чат, настройки качества), статистику соединения (FPS, битрейт, задержка, потери пакетов) и кнопку отключения.

Цветовая индикация статистики:

• Зелёный — отличное качество (FPS ≥ 25, RTT < 50мс, Loss < 0.5%)
• Жёлтый — среднее качество (предупреждение)
• Красный — плохое качество (требуется снизить настройки)

5. Чат

Встроенный текстовый чат между клиентом и хостом. Работает через DataChannel chat (reliable). Поддерживает текстовые сообщения и прикрепление изображений. Панель можно перетаскивать за заголовок.

Статусы сообщений: ✓ отправлено, ✓✓ доставлено, ✓✓ прочитано.

6. Боковая панель

Сайдбар (260px) содержит: поиск, карточки избранных хостов с обоями и информацией о системе, список недавних подключений, кнопки «Инструкция» и «Настройки».

Карточки избранного показывают: режим подключения (Broker/LAN), платформу (PC/Mac), статус (Online/Offline с анимацией пульса), hostname, ОС, адрес, дату последнего подключения и кнопку быстрого подключения.

7. Настройки

Настройки разделены на 4 вкладки: Подключение, Качество, Интерфейс, О программе. Все параметры сохраняются в %APPDATA%\UwebRDP\settings.json.

8. Решение проблем

Наиболее частые проблемы и их решения:

• «Не удаётся подключиться через Broker» — проверьте адрес брокера в настройках (wss://brocker.uwebrdp.ru/ws), убедитесь что интернет доступен. Проверьте логи — вкладка Client в терминале.
• «ICE FAILED» — прямое P2P-соединение не удалось и TURN-сервер тоже недоступен. Причины: файрвол блокирует UDP, корпоративный NAT. Попробуйте LAN-режим, если устройства в одной сети.
• «Чёрный экран / нет видео» — хост не захватывает экран. На Windows: проверьте что desktopCapturer имеет доступ. Перезапустите приложение.
• «Высокая задержка» — переключите кодек на VP8 (меньше нагрузки на CPU). Снизьте пресет качества. Проверьте RTT в панели сессии — при RTT > 100мс проблема в сети.
• «Клавиатура не работает» — инъекция ввода требует запуск от имени обычного пользователя (не администратора). UAC-окна не получают ввод из-за ограничений Windows UIPI.
• «Приложение не запускается» — удалите файл настроек %APPDATA%\UwebRDP\settings.json и запустите снова. Зашифрованные пароли могут быть повреждены при смене пользователя.

Для диагностики используйте лог-терминал внизу главного окна. Все три вкладки (Client, Host, Main) помогают определить источник проблемы.

Логи приложения также записываются в файлы:

• Режим разработки: windows/logs/
• Установленное приложение: %APPDATA%\UwebRDP\logs\