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

1. Обзор

UwebRDP для macOS 14+ (включая macOS 26 Tahoe) — универсальное приложение удалённого рабочего стола. Работает одновременно как хост (расшаривание экрана) и как клиент (управление удалённым компьютером). Поддерживает Apple Silicon (ARM) и Intel (x86_64).

Платформа

macOS 14+ (включая macOS 26 Tahoe)

Архитектура

ARM (Apple Silicon) + x86_64 (Intel)

Технология

Electron + WebRTC (P2P)

Режимы

Хост + Клиент

Установка

DMG-образ — стандартная установка macOS

Видеокодеки

VP9 (приоритет), VP8, H264 (HW), AV1

Настройки

~/Library/Application Support/uwebrdp-mac/settings.json

Главное окно приложения (macOS)

UwebRDP

UwebRDP v1.0.0

🔍 Поиск...

⭐ Избранное

MacBook-Pro

192.168.1.50:9800

macOS 15 Sequoia

iMac-Office

192.168.1.80:9800

macOS 14 Sonoma

🕑 Недавние

Mac-Mini-Dev

10.0.0.25:9800

macOS 26 Tahoe

📖 Инструкция

⚙ Настройки

🖥

Подключиться

Управление удалённым рабочим столом

AB3-7X2 или IP:Port

Пароль👁

⚫ Не подключен

Подключиться

📡

Поделиться экраном

Разрешить удалённое управление

Через интернет

Локальная сеть

Пароль хоста

🟢 Хост запущен (Broker)

Остановить хост

Client Host Main

[14:23:01] INFO WebSocket подключен к wss://brocker.uwebrdp.ru/ws
[14:23:02] OK ICE candidates gathered: 3 host, 1 srflx, 1 relay
[14:23:03] INFO PeerConnection state: connected
[14:23:03] OK DataChannels opened: mouse, input, control, clipboard, files, chat
[14:23:04] INFO Video track received, codec: VP9, resolution: 1920x1080

2. Разрешения macOS

Для корректной работы UwebRDP на macOS необходимо предоставить два системных разрешения. Без них хост-режим не сможет захватывать экран и управлять вводом.

Откройте Системные настройки (System Settings).
Перейдите в Конфиденциальность и безопасность (Privacy & Security).
Найдите раздел Запись экрана (Screen Recording) и включите переключатель для UwebRDP.
Найдите раздел Специальные возможности (Accessibility) и включите переключатель для UwebRDP.
При появлении запроса введите пароль администратора для подтверждения.

Системные настройки — Запись экрана

Запись экрана

Разрешить приложениям записывать содержимое экрана

U

UwebRDP

Zoom

Системные настройки — Специальные возможности

Специальные возможности

Разрешить приложениям управлять компьютером

U

UwebRDP

Terminal

Разрешения можно предоставить заранее или при первом запуске — macOS автоматически покажет запрос. Если приложение не появляется в списке, нажмите «+» и выберите UwebRDP.app вручную.

После включения разрешений может потребоваться перезапуск UwebRDP. Если захват экрана или ввод не работают — перезапустите приложение.

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

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

Broker (Интернет) — хост регистрируется на сигнальном сервере и получает код вида AB3-7X2. Клиент вводит этот код для подключения. Соединение P2P, брокер используется только для обмена адресами. При невозможности прямого соединения задействуется TURN-сервер.
LAN (Локальная сеть) — хост запускает локальный сервер на порту 9800. Клиент подключается по IP-адресу хоста, например 192.168.1.50:9800.

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

Пароли шифруются через macOS Keychain и хранятся в формате safe:<base64> в файле настроек.

Карточка «Подключиться»

🖥

Подключиться

Управление удалённым рабочим столом

Код сессии или IP-адрес

AB3-7X2 или IP:Port

Пароль

•••••••• 👁

⚫ Не подключен

Подключиться

Карточка «Поделиться экраном»

📡

Поделиться экраном

Разрешить удалённое управление

Через интернет

Локальная сеть

Пароль хоста

•••••• 👁

AB3-7X2

Сообщите этот код клиенту

🟢 Хост запущен (Broker)

Остановить хост

4. Хост

Чтобы предоставить доступ к своему Mac:

Убедитесь, что разрешения Запись экрана и Специальные возможности включены (см. раздел 2).
Запустите UwebRDP и перейдите на экран хоста.
Выберите режим: Через интернет (Broker) или Локальная сеть (LAN).
Нажмите Запустить хост. Приложение зарегистрируется на брокере и покажет код сессии (например, AB3-7X2).
Сообщите код клиенту — он вводит его на своей стороне для подключения.
При необходимости задайте пароль сессии — клиенту будет предложено ввести его перед подключением.

Для LAN-режима хост автоматически запускает HTTP+WebSocket сервер на порту 9800. Клиенту достаточно знать IP-адрес и порт.

PIN-код защищает настройки хоста от несанкционированного изменения.

Карточка хоста — активный режим

📡

Поделиться экраном

Разрешить удалённое управление

Через интернет

Локальная сеть

Пароль хоста

••••••••

✓

Заблокировать настройки (LOCK)

AB3-7X2

Сообщите этот код клиенту

LAN порт 9800

🟢 Хост запущен (Broker)

Остановить хост

Блок кода сессии

AB3-7X2

Сообщите этот код клиенту

Переключатель режима

Через интернет

Локальная сеть

5. Сессия

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

Тулбар сессии

AB3-7X2

🖱

⛶

📌

📁

💬 3

🖵

Отключиться

🖱 Захват ввода

Перенаправляет мышь и клавиатуру на удалённый компьютер

⛶ Полный экран

Разворачивает окно сессии на весь экран

📌 Автоскрытие

Тулбар автоматически скрывается, появляется при наведении курсора

📁 Файлы

Передача файлов между клиентом и хостом

💬 Чат

Текстовый чат с поддержкой изображений. Красный бейдж — непрочитанные

🖵 Дисплей

Выбор монитора хоста (если подключено несколько)

Статистика соединения отображается в тулбаре. Цвет RTT зависит от задержки:

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

                    RTT
                    24ms
                    — < 50ms (отлично)
                

                    RTT
                    98ms
                    — < 150ms (приемлемо)
                

                    RTT
                    210ms
                    — > 150ms (высокая задержка)
                

RTT

Задержка (round-trip time) в миллисекундах

FPS

Частота кадров видеопотока

Bitrate

Текущий битрейт видео (Мбит/с)

Буфер обмена синхронизируется между клиентом и хостом автоматически через выделенный DataChannel.

6. Чат

Во время сессии доступен встроенный чат для обмена текстовыми сообщениями и изображениями.

Панель чата

Чат

─ ✕

Привет! Можешь открыть Мониторинг системы?

Клиент 14:23

Готово, открыл. Смотри на экране.

14:24 Хост ✓✓

Спасибо! Всё вижу 👍

Клиент 14:24

📎

Введите сообщение...

➤

Кнопка чата в тулбаре с непрочитанными

💬 3

← Непрочитанные сообщения

Enter

Отправить сообщение

Shift + Enter

Новая строка в сообщении

📎 (скрепка)

Прикрепить изображение из файла

⌘+V

Вставить изображение из буфера обмена

Drag & Drop

Перетащить изображение в область чата

Статусы сообщений:

Индикация статусов

✓ Отправлено

✓✓ Доставлено

✓✓ Прочитано

Звуковые уведомления воспроизводятся при получении нового сообщения. Бейдж на кнопке чата показывает количество непрочитанных сообщений.

История чата хранится только в оперативной памяти и не сохраняется после завершения сессии.

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

Сайдбар содержит карточки хостов для быстрого подключения:

Избранное — до 10 сохранённых хостов. Карточки отображают имя хоста, ОС, обои рабочего стола и статус подключения.
Недавние — до 10 последних подключений с историей.
Статусы: online / offline — обновляются автоматически для LAN-хостов.

Боковая панель (сайдбар)

UwebRDP v1.0.0

🔍 Поиск хостов...

⭐ Избранное

MacBook-Pro

192.168.1.50:9800

macOS 15 Sequoia

iMac-Office

192.168.1.80:9800

macOS 14 Sonoma

🕑 Недавние

Mac-Mini-Dev

10.0.0.25:9800

macOS 26 Tahoe

📖 Инструкция

⚙ Настройки

Карточка устройства

MacBook-Pro

192.168.1.50:9800

macOS 15 Sequoia

LAN

online

Для добавления хоста в избранное используйте кнопку на карточке хоста или в сессии.

8. Настройки

Окно настроек содержит 4 вкладки для управления параметрами приложения.

Панель вкладок настроек

← Назад Настройки

Подключение

Качество

Внешний вид

Информация

Содержимое вкладки

Вкладка «Подключение»

Сигнальный сервер

Адрес брокера

wss://brocker.uwebrdp.ru/ws

Пароль по умолчанию

•••••••• 👁

Хост

Автозапуск хоста

Выключен ▼

Локальная сеть

Порт LAN

9800

Папка загрузок

~/Downloads

Выбрать

Вкладка «Качество»

Частота кадров (FPS) 30

5 60

Видеокодек

Авто (VP9/VP8) ▼

Варианты: Авто / VP9 / VP8 / H264

Качество

High (15/30 Мбит) ▼

Варианты: Low / Medium / High / Ultra

Вкладка «Внешний вид»

Тема оформления

🌑 Тёмная

☀ Светлая

Файл настроек

~/Library/Application Support/uwebrdp-mac/settings.json

В авто-режиме кодек выбирается автоматически: VP9 для мощных CPU (8+ ядер), VP8 для слабых. VP9 обеспечивает лучшее сжатие при нулевой pipeline-задержке.

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

Чёрный экран / захват не работает — откройте Системные настройки → Конфиденциальность и безопасность → Запись экрана и убедитесь, что UwebRDP включён. После включения перезапустите приложение.
Мышь/клавиатура не работают на хосте — откройте Системные настройки → Конфиденциальность и безопасность → Специальные возможности и убедитесь, что UwebRDP включён. Перезапустите приложение.
macOS не даёт открыть приложение (Gatekeeper) — при первом запуске macOS может заблокировать приложение. Откройте Системные настройки → Конфиденциальность и безопасность, внизу появится кнопка «Всё равно открыть» (Open Anyway). Или: правый клик на приложении → Открыть.
Не подключается через брокер — проверьте интернет-соединение, убедитесь что адрес брокера корректен в настройках. Код сессии действителен ограниченное время.
Не подключается по LAN — убедитесь, что оба устройства в одной сети. Проверьте, что порт 9800 не заблокирован файрволом macOS (Системные настройки → Сеть → Брандмауэр).
Высокая задержка — попробуйте снизить пресет качества (Medium или Low). Проверьте нагрузку на сеть. При подключении через TURN задержка будет выше, чем при прямом P2P.
Кодек H264 не работает — убедитесь, что GPU поддерживает VideoToolbox. Переключитесь на VP9/VP8 в настройках качества.

Лог-терминал (пример логов)

Client Host Main

[14:23:01] INFO Запуск приложения UwebRDP v1.0.0
[14:23:01] INFO WebSocket подключен к wss://brocker.uwebrdp.ru/ws
[14:23:02] OK ICE candidates gathered: 3 host, 1 srflx, 1 relay
[14:23:03] INFO PeerConnection state: connected
[14:23:03] OK DataChannels opened: mouse, input, control, clipboard, files, chat
[14:23:04] INFO Video track received, codec: VP9, 1920x1080@30fps
[14:23:10] WARN RTT spike detected: 142ms (threshold: 100ms)
[14:23:15] OK Encoder adapted: bitrate 15.2 Mbps, resolution 1920x1080

Путь к логам

~/Library/Logs/UwebRDP/

Логи приложения расположены в ~/Library/Logs/UwebRDP/ — они помогут диагностировать проблему. Для отправки логов разработчику используйте кнопку в настройках.