Инструкция — Android
1. Обзор
UwebRDP для Android 8+ — мобильный клиент удалённого рабочего стола. Подключается к хосту (Windows/macOS) через брокер по коду сессии или напрямую по IP в локальной сети. Видео передаётся P2P через WebRTC.
Платформа
Android 8+ (API 26)
Технология
Kotlin + Jetpack Compose + WebRTC
Режим
Только клиент (управление хостом)
Подключение
Broker (по коду) или LAN (по IP)
Безопасность
PIN-код, EncryptedSharedPreferences, DTLS-SRTP
Дизайн
Material 3, тёмная тема
Режим подключения
Код сессии
AB3-7X2
Пароль
☆
Добавить в избранное
Не подключён
Подключиться
🖥
DESKTOP-PC
Windows 11 Pro
AB3-7X2
🖥
NoutR
Windows 11 Pro
5X6-D6M
🖥
MacBook-Pro
macOS 15 Sequoia
192.168.1.46:9800
☆
Избранное
🔗
Подключиться
⚙
Настройки
👤
Профиль
2. Подключение
Приложение поддерживает два режима подключения: Broker (через интернет по коду сессии) и LAN (напрямую по IP-адресу в локальной сети). Переключение — через сегментированный контрол вверху формы.
Режим подключения
Код сессии
AB3-7X2
Пароль
Подключение...
Подключиться
Broker-режим: код от хоста
☆Избранное
🔗Подключиться
⚙Настройки
👤Профиль
Режим подключения
IP-адрес хоста
192.168.1.100:9090
Пароль
Не подключён
Подключиться
LAN-режим: IP хоста напрямую
☆Избранное
🔗Подключиться
⚙Настройки
👤Профиль
Broker
Хост генерирует код (например AB3-7X2). Клиент вводит код, обмен SDP/ICE идёт через wss://brocker.uwebrdp.ru/ws
LAN
Хост запускает HTTP+WS сервер. Клиент вводит IP:порт (например 192.168.1.100:9090). Прямое соединение
Пароль
Если хост установил пароль — клиент должен ввести его. HMAC-SHA256 для LAN, SHA-256 для Broker
3. Сессия
После подключения открывается экран сессии в ландшафтной ориентации. Видеопоток с хоста отображается на весь экран. Управление — жестами на экране.
Перемещение курсора
Одним пальцем провести по экрану
Клик (левый)
Коснуться одним пальцем
Правый клик
Долгое нажатие (удерживать палец)
Прокрутка
Двумя пальцами вверх/вниз
Масштаб
Двумя пальцами растянуть/сжать (pinch)
Клавиатура
Кнопка ⌨ — показать/скрыть экранную клавиатуру
Режим мыши
🖱 — переключение Прямой / Тачпад в настройках
4. Чат
Текстовый чат с хостом прямо из сессии. Поддерживаются текстовые сообщения и изображения. Данные передаются через DataChannel — не покидают P2P-канал.
←
Чат
DESKTOP-PC
Привет! Подключился к рабочему столу
14:23
Да, вижу экран. Сейчас настрою
14:24 ✓✓
5. Избранное
Сохранённые хосты для быстрого подключения. Каждая карточка показывает обои рабочего стола хоста (если доступны), режим подключения, ОС и статус. Максимум 10 записей.
Неизвестный хост
7T3-6P9
Добавлен 28.03.2026
NoutR
Windows 11 Pro
5X6-D6M
NoutR
Windows 11 Pro
192.168.1.46:9800
☆
Избранное
🔗
Подключиться
⚙
Настройки
👤
Профиль
6. Безопасность
Приложение защищено PIN-кодом (4 цифры). PIN шифруется через EncryptedSharedPreferences. После 5 неудачных попыток ввода — блокировка с progressive lockout (увеличивающаяся задержка).
PIN-код
4 цифры, хранится в EncryptedSharedPreferences (AES-256)
Блокировка
5 неудачных попыток — progressive lockout (30с, 60с, 120с...)
Пароли
Сохранённые пароли хостов зашифрованы в EncryptedSharedPreferences
7. Настройки
Все настройки приложения собраны на одном экране с разделами. Изменения применяются после нажатия кнопки «Сохранить».
Подключение
Broker URL
wss://brocker.uwebrdp.ru/ws
Порт LAN по умолчанию
9090
Внешний вид
Управление
Безопасность
Буфер обмена
Синхронизация
Буфер обмена с хостом
☆
Избранное
🔗
Подключиться
⚙
Настройки
👤
Профиль
8. Решение проблем
Типичные проблемы и способы их решения.
Не подключается через Broker
Проверьте интернет-соединение. Убедитесь, что код сессии введён верно (формат: ABC-XYZ). Проверьте URL брокера в настройках: wss://brocker.uwebrdp.ru/ws
Не подключается по LAN
Убедитесь, что телефон и хост в одной Wi-Fi сети. Проверьте IP-адрес и порт хоста. Firewall на хосте должен разрешать входящие соединения
Чёрный экран после подключения
На хосте (Windows/macOS) должно быть разрешение на захват экрана. Перезапустите сессию. Проверьте логи хоста
Высокая задержка видео
Переключитесь на LAN-режим если устройства в одной сети. Снизьте качество видео в настройках хоста. Проверьте скорость Wi-Fi
Клавиатура не работает
Нажмите кнопку ⌨ в сессии для открытия экранной клавиатуры. Убедитесь что на хосте работает инъекция ввода
Забыл PIN-код
Очистите данные приложения: Настройки Android → Приложения → UwebRDP → Очистить данные. Все сохранённые пароли и избранное будут удалены
ICE Failed
Обе стороны за NAT без TURN-сервера. Убедитесь что брокер brocker.uwebrdp.ru доступен — он раздаёт TURN credentials
Cleartext-трафик: В Android-приложении разрешён cleartext (HTTP) трафик через network_security_config.xml. Это необходимо для LAN-подключения по IP-адресу (WebSocket без TLS). Broker-подключение всегда использует WSS (шифрование).
Логи: Для диагностики проблем включите вывод логов через Android Studio (Logcat). Фильтр: тег UwebRDP. При обращении в поддержку приложите логи клиента и хоста.