| apps | ||
| crates | ||
| deploy | ||
| docs | ||
| shared | ||
| vendor | ||
| web | ||
| .gitattributes | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| configure-wake.ps1 | ||
| deploy-relay.ps1 | ||
| deploy.ps1 | ||
| README.md | ||
| ЧТО-НОВОГО.md | ||
BoomDesk
Удалённый рабочий стол — аналог AnyDesk / RustDesk: маленький, быстро открывается, минимальная задержка при максимальном качестве.
Запуск
boomdesk окно программы: ID, пароль, «Подключиться»
boomdesk host [--port N] [--password P] только принимать подключения
boomdesk connect 123456789 --password P подключиться по ID (или по IP в локальной сети)
boomdesk selftest --seconds 10 подключиться к самому себе и замерить задержку
boomdesk selftest --by-id | --relay то же через сервер ID / только через ретранслятор
--server АДРЕС другой сервер ID на этот запуск
Настройки — %APPDATA%\BoomDesk\boomdesk.conf (сервер ID, выданный ID, ключ компьютера).
Журнал — в консоль и в %TEMP%\boomdesk.log, подробнее: BOOMDESK_LOG=debug.
На Windows обычный ввод работает без запуска от администратора. Если системное окно блокирует управление, BoomDesk запрашивает UAC на управляемом ПК и включает службу ввода после подтверждения. На первом таком запросе разрешение подтверждает человек за управляемым ПК. При отказе обычные окна продолжают работать; повторные запросы ограничены интервалом пять минут. Службу также можно включить вручную в настройках. Обычные клавиши проходят через сообщения окна, системные сочетания — через отдельный перехватчик; нажатия экранных клавиатур тоже передаются.
Сборка: cargo build → target\debug\boomdesk.exe, cargo build --release →
target\release\boomdesk.exe (один файл, без установки). Выпуск (deploy.ps1) тоже
пишет всё в target\: Windows в target\publish, Linux в target\linux,
сервер в target\linux-musl, подписанные файлы перед заливкой — в target\pack.
Полный экран (Windows)
В окне сеанса нажмите «Полный экран» или Ctrl+Alt+Enter. Повторное нажатие возвращает прежний размер и положение окна. Рамка, обычное меню и локальная панель задач скрываются; подведите мышь к верхнему краю по центру, чтобы показать панель BoomDesk с настройками, выходом в окно и сворачиванием. F11 и Esc остаются клавишами удалённого компьютера. В меню «Масштаб» выберите «Вписать» для сохранения пропорций или «Растянуть» для заполнения всего окна без чёрных полей. В полном экране этот выбор находится в «Настройках» верхней панели. Растяжение меняет пропорции картинки; координаты мыши пересчитываются под выбранный режим.
Доступ на экране блокировки и после перезагрузки (Windows)
На управляемом ПК задайте постоянный пароль (от 8 символов), включите
«Доступ до входа в Windows и после перезагрузки» и подтвердите UAC.
Служба устанавливается в %ProgramFiles%\BoomDesk и запускается автоматически.
После перезагрузки подключайтесь по прежнему ID и постоянному паролю BoomDesk;
пароль учётной записи Windows вводится на показанном экране входа.
Настройки системного хоста защищены DPAPI и правами владельца, SYSTEM и администраторов.
После обновления portable приложения при отличающейся версии службы нажмите «Обновить системную службу». Копия службы обновляется с подтверждением Windows. В меню сеанса Windows и на панели Android есть «Перезагрузить ПК…» с подтверждением. Сохраните документы перед перезагрузкой: приложения могут задержать завершение работы.
Linux (Fedora и др.) — хост и зритель
На Linux можно подключаться к другим компьютерам и разрешать управление своим.
С версии 0.2.27 окно сеанса запрашивает перехват системных сочетаний: Alt+Tab,
Win+D, Win+стрелки, Ctrl+Shift+Esc уходят удалённому компьютеру, пока окно в фокусе.
Ctrl+Alt+G выключает/включает перехват; его состояние видно в заголовке окна.
При потере фокуса или закрытии сеанса удержанные клавиши отпускаются.
Режим «Только просмотр» не захватывает клавиатуру. В X11 используется захват
клавиатуры текущего окна, в Wayland —
keyboard-shortcuts-inhibit.
Оболочка должна поддерживать этот протокол и может оставить за собой отдельные
защищённые сочетания. Её отказ не обходится; настройки оболочки не меняются.
С версии 0.2.25 в блоке «Этот компьютер · Linux» есть «Постоянный пароль → Задать…».
Укажите не менее 8 символов и сохраните. Пароль не меняется после перезапуска
приложения или Linux, его можно изменить или удалить; временный пароль также работает.
Изменение применяется к новым подключениям сразу. Пароль хранится в
~/.config/BoomDesk/boomdesk.conf (или $XDG_CONFIG_HOME/BoomDesk/boomdesk.conf)
с правами 0600, папка — 0700. Это защита правами файловой системы, не шифрование.
С версии 0.2.26 включите «Запускать с Linux и включать доступ»: запись
~/.config/autostart/boomdesk.desktop запускает текущий файл BoomDesk после входа
в графический сеанс, и приложение само включает приём подключений. При смене
места установки запустите BoomDesk из нового места: запись автозапуска обновится.
Для восстановления Wayland используется persist_mode=2 и одноразовый
restore_token; новый токен сохраняется сразу после разрешения. Для совмещённого
управления и показа экрана настройки сохранения передаются только RemoteDesktop;
для niri — ScreenCast. Токены лежат отдельно в папке BoomDesk с правами 0600.
Сохранение должно поддерживаться порталом: первое разрешение, его отзыв или
изменение выбранного экрана могут потребовать действий пользователя.
На проверенной Fedora/niri wlr уже настроен на chooser_type=none и монитор
eDP-1; BoomDesk не меняет эту политику и не отключает диалоги для других приложений.
«Остановить доступ» останавливает хост до следующего запуска. Переключатель
автозапуска управляет следующими запусками; уже открытый доступ останавливается
отдельной кнопкой. Закрытие приложения завершает доступ.
Автозапуск до входа в графический сеанс (GDM/SDDM) не реализован.
Спецификации: ScreenCast,
RemoteDesktop,
XDG Autostart.
Нажмите «Разрешить управление» в блоке «Этот компьютер», затем передайте ID и пароль.
В Wayland выберите экран и разрешите клавиатуру/мышь в системном окне GNOME/KDE.
Начиная с 0.2.22 поддерживается niri: показ экрана идёт через
ScreenCast, ввод — через виртуальные устройства Wayland после разрешения показа.
Настройки системного портала приложение не изменяет. На проверенном ПК с niri
используется портал wlr; стандартная конфигурация niri использует GNOME.
В X11 захват идёт через XImage, ввод — XTest. Доступ можно остановить той же кнопкой.
Окно зрителя — отдельный процесс (boomdesk session) на winit + OpenGL.
Ctrl+Alt+Enter переключает полный экран, Ctrl+Alt+F — вписать/растянуть;
Shift+F8 меняет качество во время сеанса. Перехват системных сочетаний зависит от
композитора Linux: полного перехвата всех сочетаний Wayland эта версия не обещает.
Декодер — OpenH264: системный (в Fedora — пакет openh264 из включённого по умолчанию
репозитория fedora-cisco-openh264, быстрее и с патентной лицензией Cisco), иначе встроенный.
Сборка (в WSL Ubuntu; файл работает на glibc 2.39+, т. е. Fedora 40 и новее).
Каталог сборки — target\linux этого проекта, не домашний каталог WSL:
CARGO_TARGET_DIR=/mnt/b/Projects/BoomDesk/target/linux cargo build --release -p boomdesk
Установка на Fedora: скопировать boomdesk в ~/.local/bin, chmod +x.
Нужны gstreamer1, gstreamer1-plugins-base, gstreamer1-plugins-good,
pipewire-gstreamer, xdg-desktop-portal и портал своего рабочего стола
(xdg-desktop-portal-gnome или xdg-desktop-portal-kde). Для X11 нужен
libxkbcommon-x11. Кодер OpenH264 встроен, RPM Fusion не требуется.
Принимающая сторона пока работает только в открытом графическом сеансе с одним
зрителем. Системного хоста до входа в Linux, передачи звука и микрофона на Linux
пока нет. Для GNOME/KDE нужен портал RemoteDesktop; для niri — ScreenCast и
протоколы виртуальной клавиатуры и мыши Wayland. На Fedora 43/niri 26.04 проверены
видеосеанс, смена качества, повторный вход, клавиатура, Unicode, мышь и прокрутка.
На старых версиях niri системные сочетания не проходят через протокол виртуальной
клавиатуры Wayland. BoomDesk автоматически использует uinput для обычных клавиш,
если текущему пользователю уже разрешён доступ к /dev/uinput; Unicode остаётся
на Wayland. С версии 0.2.30 при отсутствии доступа нажмите «Включить сочетания
оболочки…» в окне хоста и подтвердите системный запрос администратора. Нужны
pkexec и работающий агент polkit рабочего стола; пароль обрабатывает система.
BoomDesk устанавливает /etc/modules-load.d/boomdesk-uinput.conf и
/etc/udev/rules.d/70-boomdesk-uinput.rules: модуль загружается при старте,
а udev/logind даёт доступ активному локальному пользователю через uaccess.
Клавиатура переключается без разрыва текущего сеанса. Отмена запроса сохраняет
прежний режим ввода, повторить можно той же кнопкой. Изменённые администратором
файлы правил приложение не перезаписывает. Пароль входа в Linux сохраняется.
Общий текстовый буфер Linux ↔ Windows работает в обоих направлениях после входа
по паролю, в том числе в Wayland/niri. Поддерживаются Unicode и переносы строк,
до 256 КиБ текста.
Начиная с 0.2.23, если обе стороны обновлены, через Ctrl+C / Ctrl+V также передаются
картинки и файлы с папками. Дождитесь сообщения «Файлы получены» перед вставкой
в Проводник или файловый менеджер Linux. Изображение вставляется непосредственно
в приложение, поддерживающее картинки в буфере, без преобразования в текст или путь.
Передача идёт отдельным каналом с низким приоритетом. За одну операцию — до 1 ГиБ
и 2000 элементов; PNG до 32 МиБ и 16 мегапикселей. Ссылки не передаются, а «вырезать»
переносится как копирование без удаления исходника. Временные копии находятся в
%LOCALAPPDATA%\BoomDesk\clipboard или $XDG_CACHE_HOME/BoomDesk/clipboard
(по умолчанию ~/.cache/BoomDesk/clipboard), общий предел кэша — 2 ГиБ.
Кэш можно очистить после вставки, когда ни один файловый менеджер уже не копирует
из него. При обрыве незавершённые файлы автоматически удаляются.
Если экран разрешён, но кадры не идут, убедитесь, что монитор включён.
Зависший системный портал может потребовать перезапуска его служб — это прерывает
текущие демонстрации экрана и в других приложениях.
Журнал — /tmp/boomdesk.log и /tmp/boomdesk-session.log, встроенный декодер вместо
системного — BOOMDESK_OPENH264=builtin.
Android
С версии 0.2.24 Android поддерживает общий буфер файлов и изображений с ПК
(Windows/Linux 0.2.23 или новее). Скопируйте файл или картинку и вернитесь в
BoomDesk; после сообщения о завершении передачи вставьте на ПК через Ctrl+V.
Если файловый менеджер телефона не использует системный буфер Android, откройте
в сеансе настройки → «Буфер и файлы» → «Выбрать файлы на ПК» или «Картинку в буфер ПК».
Также можно отправить файл через системное меню «Поделиться» → BoomDesk.
Полученное с ПК доступно для вставки в приложения с поддержкой файлов/картинок,
через «Поделиться полученным…» или «Сохранить полученное…» в Загрузки/BoomDesk.
Папки с ПК упаковываются в ZIP. Android разрешает читать общий буфер, когда
BoomDesk открыт на экране; после копирования в другом приложении вернитесь в него.
Во время подключения действует уведомление активного сеанса: оно сохраняет
сетевой обмен при выборе файлов и переходе в другое приложение. После выхода
из сеанса уведомление и служба подключения останавливаются.
Лимиты совпадают с ПК: 1 ГиБ и 2000 элементов за операцию, картинки до 16 Мп
и 32 МиБ PNG. Временные копии хранятся в закрытом кэше приложения (до 2 ГиБ);
после сохранения нужных файлов его можно очистить в системных настройках Android.
Телефон подключается к компьютерам, а тестовая версия 0.2.21 также принимает подключения: «Настройки → Этот телефон → Разрешить показ экрана». Показ выдаётся системой Android; для касаний и ввода отдельно включается служба BoomDesk в специальных возможностях. Затем подключайтесь по показанному ID и паролю. Уведомление «BoomDesk · показ экрана включён» содержит кнопку остановки. Доступ не включается скрытно после перезагрузки. Защищённые экраны приложений подчиняются ограничениям Android. При повороте телефона показ нужно разрешить заново; входящий сеанс пока один. Нужна проверка на реальном телефоне. В сеансе есть два режима: «Касание» — клик в выбранной точке и перетаскивание; «Тачпад» — относительное движение указателя без нажатия. В тачпаде короткое касание кликает, удержание зажимает левую кнопку для перетаскивания. Палец можно перемещать по всей области просмотра, включая поля вокруг видео. Кнопками выбираются левая, правая кнопка или колесо. Два пальца меняют масштаб и сдвигают увеличенную картинку, три пальца прокручивают удалённое окно. Масштаб также можно выбрать регулятором 1×–8×; «Вписать» возвращает весь экран. Для сдвига сначала увеличьте изображение. Режим «Двигать экран» позволяет сдвигать его одним пальцем без отправки движения мыши на компьютер. Кнопка клавиатуры открывает системное поле Android с подсказками и исправлениями. Оно передаёт русский текст и другие символы (BoomDesk на ПК должен быть версии 0.2.4 или новее). Общий текстовый буфер работает, пока приложение телефона открыто. Карточки недавних компьютеров показывают последние снимки рабочего стола. С версии 0.2.16 на Android доступны поиск, избранное, карточки и компактный список; подключение открывается отдельной панелью над клавиатурой. Качество меняется в настройках сеанса.
Кнопка геймпада в нижней панели открывает полупрозрачные стики, крестовину,
A/B/X/Y, плечи и триггеры. Несколько пальцев управляют ими одновременно.
При потере фокуса и закрытии панели кнопки отпускаются; принимающий Windows-хост
сбрасывает состояние и при отсутствии сообщений дольше 750 мс.
При ручной сборке Android после cargo apk build --release -p boomdesk-mobile
обязательно выполните powershell -File apps/mobile/android/package.ps1 -Apk target/release/apk/boomdesk.apk:
этот шаг добавляет Android-службы и подписывает APK существующим ключом.
deploy.ps1 выполняет его автоматически, включая уже собранные APK.
На принимающем Windows-ПК для Xbox-совместимого контроллера нужен ViGEmBus (официальный выпуск). Это отдельный драйвер; текущий проект ViGEmBus архивирован. BoomDesk не устанавливает его молча и сообщает, если он отсутствует. Виртуальный геймпад на Linux и Android как принимающих устройствах пока не реализован.
Звук и микрофон
На Windows в меню сеанса «Звук ПК» включает звук удалённого Windows-компьютера. На Android такой же переключатель расположен на панели управления. Требуется 0.2.10 на обеих сторонах. Linux пока принимает только изображение и управление. Звук передаётся Opus, 48 кГц, стерео; очереди ограничены, чтобы задержка не накапливалась.
«Мой микрофон» в Windows выключен при начале каждого сеанса. Для его использования установите на управляемом ПК VB-CABLE и перезагрузите этот ПК после установки драйвера. В нужной удалённой программе выберите микрофон CABLE Output, затем включите «Мой микрофон» в BoomDesk на ноутбуке. BoomDesk направляет полученный звук в CABLE Input, откуда драйвер передаёт его в CABLE Output. При отсутствии драйвера появляется объяснение; звук микрофона не отправляется в обычные колонки. Ноутбук использует свой микрофон Windows по умолчанию.
С Android 0.2.16 можно передавать микрофон телефона: в сеансе нажмите значок микрофона и разрешите запись. На управляемом Windows-ПК нужен тот же VB-CABLE. Запись начнётся после подтверждения готовности виртуального входа; индикатор показывает уровень звука. При сворачивании приложения, выходе из сеанса или ошибке запись останавливается. Для следующего сеанса микрофон нужно включить снова. Сам BoomDesk драйвер не устанавливает и устройство «BoomDesk Microphone» не создаёт.
Wake-on-LAN и MSI B760
Начиная с 0.2.13: обновите обе стороны, системную службу и серверы; подключитесь к нужному ПК один раз. MAC и разрешение пробуждения сохраняются сами. Оставьте его и другой Windows-ПК с BoomDesk (или Orange Pi с новым сервером) включёнными в одной домашней сети около минуты. Затем достаточно кнопки «Разбудить» прямо в карточке. Ключи, адреса и проброс портов для обычного ПК-помощника не нужны: запрос приходит по его существующему соединению с сервером, включая TCP. Видеосеанс не открывается.
Помощник подтверждает отправку трёх пакетов, затем приложение до 90 секунд ждёт появления ПК в сети. Эти два состояния различаются. Если все устройства дома выключены, нужен постоянно включённый Orange Pi, другой BoomDesk или WOL роутера. Кабель, питание и настройку BIOS приложение заменить не может. Параметры и встроенная инструкция находятся в отдельном окне «Настройки пробуждения»; главное окно не растёт.
Соседи обнаруживаются подписанными пакетами внутри физической LAN, а не по совпадению внешнего IP или частной подсети. Кэш связан с сетевой картой и MAC шлюза, поэтому переезд ноутбука в другую квартиру не переносит разрешённые цели в новую сеть. Ключ запроса выдаётся после входа по паролю и привязан к MAC и устройству; он действует 90 дней и обновляется при подключении. Помощник проверяет подписи и локальный кэш, сам выбирает интерфейс и широковещательный адрес. VPN/Docker не используются для обнаружения. Гостевая сеть с изоляцией клиентов и разные VLAN могут блокировать поиск.
У MSI B760 названия зависят от точной модели и версии BIOS. По инструкции MSI:
- При включении нажмите Delete, перейдите в Advanced (обычно F7).
- Settings → Advanced → Power Management Setup → ErP Ready: Disabled.
- Settings → Advanced → Wake Up Event Setup → Resume by PCI-E/Networking Device: Enabled.
- F10 → сохранить изменения.
- В Windows: Диспетчер устройств → сетевой адаптер Ethernet → Управление электропитанием → разрешить пробуждение. Если есть Wake on Magic Packet, включите его.
- В параметрах кнопок питания Windows отключите быстрый запуск — это также рекомендует MSI.
Сервер ID в интернете доставляет запрос включённому помощнику в нужной сети. Сам по себе облачный сервер не может отправить широковещательный пакет в чужую LAN. Обычный проброс порта на старый IP выключенного ПК не гарантирует доставку.
Обновления Android
Новая версия проверяется так же: через 8 с и потом каждые 6 часов, пока приложение открыто. Появляется баннер и уведомление Android. «Обновить» скачивает apk с сервера ID и открывает установщик системы (нужно разрешить установку из BoomDesk).
Сборка (NDK и cargo-apk, результат в target\, не во временной папке):
$env:ANDROID_HOME = "C:\Android"
$env:ANDROID_NDK_HOME = "C:\Android\ndk\27.0.12077973"
$env:CARGO_TARGET_DIR = "B:\Projects\BoomDesk\target"
$env:CARGO_APK_RELEASE_KEYSTORE = "$env:USERPROFILE\.boomdesk\android.keystore"
$env:CARGO_APK_RELEASE_KEYSTORE_PASSWORD = Get-Content -Raw "$env:USERPROFILE\.boomdesk\android.keystore.pass"
cargo apk build --release -p boomdesk-mobile
Отладочная сборка — та же команда без --release (её подписывает отладочный ключ
Android на этом компьютере). Пакет com.boomdesk.app. Сам apk:
target\release\apk\boomdesk.apk (отладочный — target\debug\apk\boomdesk.apk),
нативные библиотеки — в target\aarch64-linux-android\. Выпускной apk подписывается
ключом %USERPROFILE%\.boomdesk\android.keystore — его нужно хранить вместе с
release-signing.key: без того же ключа телефон не поставит новую версию поверх старой.
Трей, постоянный пароль, автозапуск (Windows)
- Крестик прячет окно в трей: хост остаётся на связи. Щелчок по значку — открыть окно, правая кнопка — «Открыть BoomDesk» / «Выход». Повторный запуск программы показывает окно уже работающей копии, а не открывает вторую.
- Постоянный пароль — для доступа, когда у компьютера никого нет. Подходит любой из двух паролей: зритель ведёт два обмена SPAKE2 сразу (протокол входа v2), хост отвечает на один одноразовым паролем, на другой — постоянным (если постоянного нет — случайным, так что снаружи не видно, задан ли он). В настройках пароль хранится зашифрованным DPAPI — прочитать его может только эта учётная запись Windows. Не короче 8 символов.
- Автозапуск — значение
BoomDeskвHKCU\Software\Microsoft\Windows\CurrentVersion\Run, программа стартует с--tray(сразу в трее).
Карточки и работа в сеансе
В «Недавних» видно доступность и задержку, проверяемые каждые 15 секунд. Для ID значок «≈» означает оценку пути через сервер; прямое соединение может быть быстрее. При ошибке связи с сервером показывается «Статус неизвестен». Проверка не начинает управление и не заменяет действующего зрителя.
После успешного входа пароль запоминается, если включён флажок «Запомнить пароль». Выбор плитки подставляет адрес и пароль; двойной щелчок или «Подключиться» в её меню открывает сеанс. Звезда добавляет компьютер в избранное и поднимает его в начало списка. Фон плитки — значок монитора; снимки удалённого экрана пока не сохраняются. Удаление карточки удаляет и её сохранённый пароль. На Windows пароли защищены DPAPI, на Android — AES-GCM с ключом Android Keystore; на Linux файл настроек доступен только владельцу (права 0600).
Качество меняется во время работы: меню «Качество видео» в окне Windows, список «Качество» в Android, Shift+F8 переключает варианты на Linux. Доступны авто, исходное, 1080p, 720p и 540p. Авто подстраивает битрейт и разрешение, не меняя разрешение монитора. Буфер обмена общий для текста; файлы и изображения пока не передаются.
Автообновление
Программа проверяет новую версию через 8 с после запуска и потом каждые 6 часов; в
окне заголовок выпуска и список изменений, затем «Обновить» → прогресс → «Перезапустить
и обновить». Если окно спрятано в трей, то же самое приходит уведомлением Windows
(щелчок по нему открывает окно). Без клика ничего не ставится; крестик — не напоминать
до следующей версии. Без окна: boomdesk update (с --check — только проверить).
Ошибка сети проверку не превращает в отказ запуска.
- Номер версии, заголовок и текст изменений читаются с каталога
http://77.66.186.226:8080/api/apps/boomdesk. Страница для человека:http://77.66.186.226:8080/. Старые сборки тоже оттуда, изhistoryиplatforms[].url. Своего архива нет. - Файл качается по
platforms[].url, сверяются размер и SHA-256. Перед заменой программы скачиваютсяsigned_manifest_urlиsigned_signature_url(https://77.66.186.226/releases/boomdesk/version.jsonи подпись рядом) и проверяются ключом, зашитым в программу. Подпись с порта 8080 эту проверку не заменяет. Сертификат HTTPS выписан наnuar.local: цепочка до Nuar Dev CA проверяется, имяnuar.localпринимается только если адрес не совпал. - Пока программа качает обновление, копия лежит в
%LOCALAPPDATA%\BoomDesk\updateи после установки удаляется. Закрытый ключ подписи —~/.boomdesk/release-signing.key. Его нужно хранить в надёжном месте: без него уже установленные программы новых версий не примут. - Замена: работающий exe переименовывается в
*.old, на его место кладётся новый и запускается с--wait-pid— он ждёт выхода старого (освобождения порта) и прибирает.
Выпуск версии: поднять version в Cargo.toml, дописать раздел в ЧТО-НОВОГО.md и
powershell -File deploy.ps1
Скрипт проверит, что такой версии в каталоге ещё нет и в ЧТО-НОВОГО.md есть её раздел.
Файл, внутри которого уже эта версия, заново не собирается. Остальные собираются,
список подписывается и заливается в /home/orangepi/nuar/releases/boomdesk
(сначала файлы, потом version.json; старые сборки не удаляются). Те же файлы
кладутся на сервер ID, старые сборки там тоже остаются. Готовые файлы скрипт
положит ещё и в dist\. После каждого изменения, которое должно попасть к людям,
версию выпускают сразу этим скриптом. Ключи: -Server — заодно обновить сам сервер ID,
-DryRun — ничего не заливать, -NoLinux — без Linux, -NoAndroid — без телефона,
-Force — выложить ту же версию ещё раз.
Сервер ID
Несколько серверов и выбор по задержке (0.2.31)
Встроенные серверы 77.66.186.226:26661 и 186.246.19.103:26661 проверяются
параллельно. Хост поддерживает независимые регистрации: отказ одного узла не
отключает другой. Фоновые проверки раз в 15 секунд работают и без сохранённых ПК;
измерения старше 45 секунд не влияют на порядок запасных попыток. Полный путь до
ПК измеряется заново при подключении. Запасная попытка начинается через 200 мс,
не ожидая таймаута предыдущей.
На встроенных серверах согласованы ID и сохранены исторические псевдонимы. Для
новых устройств сервер рассчитывает ID по ключу, проверяя занятость; возможные
коллизии требуют согласования реестров оператором. deploy/merge-directory-ids.py
объединяет снимки остановленных реестров с проверкой конфликтов, без потери прежних
ID. Перед заменой данных нужны резервные копии обоих реестров.
Обновите обе стороны и системную службу до 0.2.32. Уже открытый сеанс через исправный сервер сохраняется при отказе другого. При обрыве текущего маршрута Windows, Linux и Android автоматически устанавливают новый сеанс в прежнем окне, используя пароль из памяти. Это повторное соединение с полной проверкой входа, а не перенос QUIC-потока: на время восстановления изображение замирает. При восстановлении предыдущий сервер пробуется после альтернативных маршрутов, даже если он продолжает отвечать на запросы каталога. Он остаётся запасным вариантом. После 8 секунд без сообщений хоста начинается восстановление; общий предел повторных попыток — 2 минуты. Неподвижный экран с работающим Ping/Pong не считается обрывом. Закрытие окна, отказ во входе или явное завершение хостом останавливают повторы. Качество и параметры звука восстанавливаются; ввод и одноразовые команды, отправленные во время обрыва, не накапливаются.
Для собственного сервера сохраняется отдельное пространство ID и прежняя схема:
Основной сервер хранит прежние ID. В /var/lib/boomdesk/relays.json укажите массив
адресов дополнительных серверов, например ["77.66.186.226:26661"] (до восьми адресов).
Хост получает список раз в минуту, регистрируется на дополнительных узлах тем же
ключом и публикует их внутренние ID. Пользователь продолжает вводить прежний ID;
карточки и сохранённые пароли не меняются. Реестры разных серверов копировать нельзя.
Перед подключением зритель параллельно измеряет доступные пути и выбирает наименьшую
сумму RTT «зритель—сервер» и «сервер—хост». Неответившие и недоступные узлы пропускаются;
при ошибке соединения пробуется следующий. Прямые адреса проверяются, как раньше.
В заголовке сеанса виден выбранный сервер. Команда boomdesk routes ID показывает
оценки маршрутов без открытия экрана и ввода пароля. Карточки тоже показывают лучшую
оценку. Эти числа — сетевой RTT; задержка изображения также включает кодирование
и декодирование, а загрузка канала может меняться после проверки.
Обновите обе стороны до 0.2.9; если используется системный хост, обновите и службу кнопкой в программе. Старые клиенты продолжают работать через основной сервер. В схеме с собственным сервером основной узел по-прежнему нужен для поиска ID: это выбор пути передачи, а не независимые копии реестра. Работающий сеанс не переносится на другой сервер; автовыбор выполняется заново при следующем подключении.
Для каждого дополнительного узла нужны открытые TCP и UDP порты 26661. За NAT
пробросьте оба протокола на компьютер с сервером. Для ARM64 Orange Pi есть
deploy-relay.ps1: он собирает сервер, загружает отдельный контейнер boomdesk-relay
и сохраняет данные в ~/boomdesk-relay/data. Список relays.json на основном сервере
следует обновлять только после проверки доступности нового узла извне.
apps/server — boomdesk-server: выдаёт компьютерам постоянные ID, сводит зрителя
с хостом и ретранслирует трафик, если напрямую соединиться не вышло. Порт 26661 — UDP
и TCP (запасной путь для сетей, где UDP закрыт).
Рабочий сервер: 186.246.19.103 (служба boomdesk-server, SSH bumaga-server).
От ноутбука разработчика до него ~160 мс — для ретранслятора лучше сервер поближе к людям,
прямые соединения от расположения сервера не зависят.
Сборка под Linux (статический файл, работает на любом x86_64-дистрибутиве), в WSL.
Каталог сборки — target\linux-musl этого проекта:
CARGO_TARGET_DIR=/mnt/b/Projects/BoomDesk/target/linux-musl CC_x86_64_unknown_linux_musl=gcc \
cargo build --release --target x86_64-unknown-linux-musl -p boomdesk-server
Установка: скопировать на сервер boomdesk-server и файлы из deploy/, запустить
sh install.sh от root. Служба boomdesk-server работает от отдельного пользователя
без прав, реестр ID и ключ сервера — в /var/lib/boomdesk. Журнал: journalctl -u boomdesk-server.
Как устроено
Хост: DXGI Desktop Duplication → видеопроцессор BGRA→NV12 → аппаратный H.264 (Media Foundation)
└───────────── всё в видеопамяти, без копий в ОЗУ ─────────────┘
Сеть: QUIC (quinn): управляющий поток (вход, ввод, пинг) + поток видео
Зритель: аппаратный декодер H.264 (DXVA) → видеопроцессор NV12→BGRA → flip-swapchain с tearing
- Задержка не копится. Хост держит «в пути» не больше
2 + RTT/интервал кадракадров, лишние изменения экрана склеиваются в один свежий кадр. Кодер без B-кадров, ключевые кадры только по запросу, буфер кодера — полтора кадра. - Курсор зрителя свой — мышь двигается без задержки.
- Вход по паролю через SPAKE2, привязанный к ключам TLS-сессии: пароль не передаётся даже в виде хэша, а посредник (в том числе сервер ID) не может встать посередине. После трёх неверных попыток подряд ответ замедляется.
- Ноутбуки с двумя видеокартами: захват и кодер создаются на той, к которой подключён монитор.
Подключение по ID
- Хост держит QUIC-соединение с сервером с того же UDP-порта, что принимает зрителей (26660): сервер видит его внешний адрес, и этот адрес годится зрителю. ID закреплён за ключом устройства (Ed25519); регистрация подписана поверх ключей TLS-сессии, поэтому занять чужой ID нельзя.
- Зритель просит ID. Сервер сначала говорит хосту «к тебе идут с такого-то адреса» — хост шлёт пакеты навстречу и открывает свой NAT, — и только потом отдаёт зрителю адреса хоста (внутренние — если оба за одним роутером) и номер канала ретранслятора.
- Зритель пробует прямые адреса, через 0,8 с параллельно — ретранслятор. Кто первым ответил, тот и победил.
QUIC и служебные пакеты делят один сокет (crates/net/src/socket.rs): наши начинаются
с байта 0x00, у QUIC в первом байте всегда бит 0x40 (его «смазка» по RFC 9287 выключена).
Через ретранслятор идут обычные пакеты QUIC с 6-байтным заголовком канала — сервер
пересылает их, не имея возможности прочитать: шифрование сквозное.
Если UDP закрыт (офисы, гостиницы, часть мобильных сетей): сервер не ответил по UDP
за 2 с — до него открывается TCP-туннель (crates/net/src/tunnel.rs), и те же датаграммы
QUIC идут внутри TCP. Для QUIC ничего не меняется; сервер видит такого клиента под
виртуальным адресом 241.x.y.z и соединяет его со зрителем только через ретранслятор.
Битрейт подстраивается под канал (apps/desktop/src/rate.rs): хост сравнивает, сколько
кадр шёл до зрителя, с лучшим временем за последние секунды. Выросла очередь больше
40 мс — битрейт ×0,7; очереди нет — ×1,1 до потолка. Большая, но стабильная задержка
(далёкий сервер) снижением качества не считается.
| Каталог | Что внутри |
|---|---|
crates/proto |
сообщения протокола и сервера ID (общие для всех платформ) |
crates/net |
QUIC, общий сокет, вход по паролю, ключ устройства, клиент сервера ID — пойдёт и в Android |
apps/desktop |
программа: win/ — захват, кодер, декодер, окно, ввод (Windows); linux/ — окно сеанса, декодер, клавиши (Linux) |
apps/server |
сервер ID; tests/ — сквозные проверки: по ID, только через ретранслятор, реестр |
deploy/ |
служба systemd и скрипт установки сервера |
Пробуждение из другой сети
Для прежней ручной схемы в настройках WOL выберите «Указанный посредник». На посреднике
должен работать boomdesk-server 0.2.12 или новее. Он остаётся включённым в той же
локальной сети, что и пробуждаемый ПК. Обычное подключение к серверу ID не пересылает
широковещательные пакеты в чужую квартиру. По одному посреднику на квартиру обычно
достаточно; для разделённых VLAN нужен доступ именно к сети нужного ПК.
Для Orange Pi сначала обновите контейнер через deploy-relay.ps1. Контейнер работает
с --network host, чтобы пакет выходил в физическую LAN, а не в сеть Docker.
Другие контейнеры скрипт не меняет. Снаружи должны быть доступны TCP/UDP 26661; при
закрытом UDP клиент использует TCP. Если у квартиры нет входящего доступа (CGNAT),
можно дать клиенту доступ к посреднику через VPN: сам WOL отправляется уже в его LAN.
В 0.2.13 обычный Windows-клиент работает исходящим помощником автоматически;
он подходит и для квартир за CGNAT. Сервер на Orange Pi также обнаруживает соседей
автоматически, поэтому дальнейшие команды нужны только для ручной схемы 0.2.12.
Разрешить пробуждение одного ПК и сохранить настройки на текущем ноутбуке:
.\configure-wake.ps1 -ComputerId 280854548 -Mac '34:5A:60:F6:51:DA' -Source '192.168.3.20' -Destination '192.168.3.255:9'
Для другого посредника укажите также -SshHost, -SshPort, -Key, -PublicAddress
и при необходимости -RemoteData. Source — физический IPv4 посредника в сети
пробуждаемого ПК, Destination — широковещательный адрес этой сети и UDP-порт.
Скрипт сохраняет разрешённые MAC в wake.json рядом с ids.txt. Файл закрыт для
других пользователей Linux; ключи не попадают в код или подписанные обновления.
Копия настроек для переноса на другой клиент находится в
%USERPROFILE%\.boomdesk\wake-relays\<ID>.json. На Android выберите тот же ПК,
«Через посредника» и введите поля server и key из этого файла. Это отдельный
ключ только для пробуждения, он не заменяет пароль доступа к рабочему столу.
Повторный запуск скрипта сохраняет ключ; -Rotate заменяет его и отзывает прежние
клиенты. Удаление записи из серверного wake.json запрещает пробуждение без
перезапуска сервера. Не публикуйте файл с ключами. Один MAC — один отдельный ключ.
Для ручной установки deploy/configure-wake.py запускается на посреднике с
--data, --mac, --source, --destination, --server (публичный адрес).
Его stdout содержит приватные настройки клиента, не журнал для публикации.
Протокол проверяет HMAC-SHA256 от MAC и TLS exporter разными метками для запроса
и подтверждения; повтор запроса в другом соединении и подмена подтверждения
отклоняются. Ограничения: 60 запросов в минуту на посредник, один запуск на MAC
за 5 секунд. Клиент не задаёт адрес назначения и содержимое пакета посреднику.
Успех означает, что посредник отправил три пакета, а не что ПК уже включился.
Проверяйте получение Wireshark (udp.dstport == 9) при включённом ПК, затем отдельно
пробуждение из сна/выключения. Для диагностики сохранённого профиля:
boomdesk wake 280854548.
План
Прототип в локальной сети: захват → H.264 → QUIC → показ, мышь и клавиатураСервер ID: постоянный ID вместо IP, пробивка NAT, ретранслятор- Интерфейс уровня AnyDesk: панель в окне сеанса, полный экран, несколько мониторов, буфер обмена, форма курсора, HEVC/AV1
- Служба Windows: окна UAC, экран входа, доступ без подтверждения; файлы, звук; установщик, автообновление, подпись кода
- Android-клиент (Kotlin + MediaCodec, сеть — эти же
protoиnetна Rust)
Отложено для сервера: запоминание отпечатка сервера клиентами, ограничение скорости ретранслятора на канал, IPv6.
Клавиатура при управлении Android
Начиная с 0.2.33, Android 13+ использует системный канал ввода службы специальных возможностей: обычный текст, поля пароля, Enter, удаление, стрелки и сочетания редактирования. Windows и Linux передают печатный текст в раскладке зрителя, если телефон объявил поддержку этого режима. Обновите оба устройства и включите на телефоне службу «BoomDesk · управление телефоном».
С 0.2.34 в «Настройки → Этот телефон» можно задать постоянный пароль (не меньше 8 символов без пробелов). Он хранится зашифрованным через Android Keystore, не зависит от выбранного сервера и применяется к новым подключениям сразу после сохранения. Временный пароль также остаётся действующим. Разрешения Android на показ экрана и управление всё ещё нужны; постоянный пароль не включает скрытый доступ после перезагрузки телефона.
Если при восстановлении уже открытого сеанса хост явно отклоняет прежний пароль, зритель показывает запрос нового. Отмена завершает сеанс; ошибочный пароль вызывает повторный запрос. Пока пользователь отвечает, таймер восстановления приостановлен. Windows/Linux сохраняют новый пароль в памяти текущего сеанса, Android обновляет запомненный пароль только после успешного входа, если включено запоминание. Отзыв доступа и неверное подтверждение подлинности хоста остаются окончательными ошибками.
На Android 10–12 используется резервный ввод через доступное редактируемое поле. Он зависит от поддержки Accessibility приложением; защищённые поля в этом режиме не переписываются. Настоящий ввод в Android проверяется отдельным тестовым APK: apps/mobile/android/tests-emulator.ps1 (только эмулятор Android 13+); локальные проверки — apps/mobile/android/tests.ps1.