Инструкция — 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, тёмная тема
Подключиться
Режим подключения
Broker
LAN
Код сессии
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-адресу в локальной сети). Переключение — через сегментированный контрол вверху формы.

Подключиться
Режим подключения
Broker
LAN
Код сессии
AB3-7X2
Пароль
••••••
👁
Подключение...
Подключиться
Broker-режим: код от хоста
Избранное
🔗Подключиться
Настройки
👤Профиль
Подключиться
Режим подключения
Broker
LAN
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. Сессия

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

AB3-7X2 💬 3 Выйти
🖱
Перемещение курсора
Одним пальцем провести по экрану
Клик (левый)
Коснуться одним пальцем
Правый клик
Долгое нажатие (удерживать палец)
Прокрутка
Двумя пальцами вверх/вниз
Масштаб
Двумя пальцами растянуть/сжать (pinch)
Клавиатура
Кнопка ⌨ — показать/скрыть экранную клавиатуру
Режим мыши
🖱 — переключение Прямой / Тачпад в настройках

4. Чат

Текстовый чат с хостом прямо из сессии. Поддерживаются текстовые сообщения и изображения. Данные передаются через DataChannel — не покидают P2P-канал.

Чат
DESKTOP-PC
Привет! Подключился к рабочему столу
14:23
Да, вижу экран. Сейчас настрою
14:24 ✓✓
DESKTOP-PC
📷
Скриншот ошибки
14:25
Понял, исправлю
14:26 ✓✓
📎 📷
Сообщение...

5. Избранное

Сохранённые хосты для быстрого подключения. Каждая карточка показывает обои рабочего стола хоста (если доступны), режим подключения, ОС и статус. Максимум 10 записей.

Избранное
BROKER
🗑
Неизвестный хост
7T3-6P9
Добавлен 28.03.2026
Offline
Подключиться
BROKER PC
🗑
NoutR
Windows 11 Pro
5X6-D6M
Offline
Подключиться
LAN PC
🗑
NoutR
Windows 11 Pro
192.168.1.46:9800
Offline
Подключиться
Избранное
🔗 Подключиться
Настройки
👤 Профиль

6. Безопасность

Приложение защищено PIN-кодом (4 цифры). PIN шифруется через EncryptedSharedPreferences. После 5 неудачных попыток ввода — блокировка с progressive lockout (увеличивающаяся задержка).

🔒
Введите PIN-код
1
2
3
4
5
6
7
8
9
0
PIN-код
4 цифры, хранится в EncryptedSharedPreferences (AES-256)
Блокировка
5 неудачных попыток — progressive lockout (30с, 60с, 120с...)
Пароли
Сохранённые пароли хостов зашифрованы в EncryptedSharedPreferences

7. Настройки

Все настройки приложения собраны на одном экране с разделами. Изменения применяются после нажатия кнопки «Сохранить».

Настройки
💾 Сохранить
Подключение
Broker URL
wss://brocker.uwebrdp.ru/ws

Порт LAN по умолчанию
9090
Внешний вид
Тёмная тема
Управление
Режим мыши
Прямой
Тачпад
Чувствительность 1.0x
Безопасность
🔒 Установить PIN-код
PIN не установлен
Буфер обмена
Синхронизация
Буфер обмена с хостом
Избранное
🔗 Подключиться
Настройки
👤 Профиль

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. При обращении в поддержку приложите логи клиента и хоста.