Docs

Пошаговая инструкция

Ниже не “техническая свалка”, а три понятных сценария. Выберите тот, который похож на ваш случай, и идите сверху вниз без догадок.

Сценарий 1

Хочу просто открыть чужой ПК
  1. Откройте Telegram-бота и отправьте `/auth`.
  2. Введите код на сайте.
  3. Вернитесь в каталог на главной.
  4. Нажмите `Открыть` у онлайн-источника.

Сценарий 2

Хочу подключить свой обычный ПК
  1. Откройте `Подключить свой ПК`.
  2. Создайте `Native Agent` устройство.
  3. Выпустите pairing code.
  4. Введите pairing code в приложении-агенте.
  5. Когда устройство станет `ONLINE`, откройте viewer.

Сценарий 3

Хочу показать VM / QEMU / старую машину
  1. Используйте `Legacy VNC / SSH fallback` в дашборде.
  2. Создайте legacy-источник.
  3. Скачайте ключ и поднимите туннель.
  4. Если нужен звук, поднимите отдельный аудиопоток на хосте.
  5. Когда источник станет `ONLINE`, откройте viewer.

Как выбрать режим

  • `Native Agent` — нормальный путь для живого ПК пользователя.
  • `Legacy VNC / QEMU` — fallback для VM, старых машин и уже существующего VNC/RDP.
  • Если не уверены, почти всегда начинайте с `Native Agent`.

Что где находится на сайте

  • `Каталог и просмотр` — открыть уже работающий источник.
  • `Подключить свой ПК` — создать устройство или legacy-источник.
  • `Пошаговая инструкция` — быстро понять маршрут без чтения кода и логов.

Legacy VNC / QEMU: что нужно заранее

Видео
  • Рабочий VNC-сервер на `127.0.0.1:5900`.
  • SSH-клиент на той же машине или хосте, где крутится QEMU/VNC.
  • Приватный ключ, который вы скачали в дашборде.
Звук
  • Звук не идет внутри VNC сам по себе.
  • Его нужно поднимать отдельно на хосте VM или на машине с VNC.
  • Текущий fallback-путь — отдельный поток на `127.0.0.1:4900`.

Пример звука для legacy VNC / QEMU

Пример для Linux / PulseAudio / PipeWire:

ffmpeg -f pulse -i default -ac 2 -ar 44100 -b:a 192k -c:a libmp3lame -content_type audio/mpeg -f mp3 tcp://127.0.0.1:4900?listen=1

SSH endpoint для legacy VNC

SSH endpoint: pc@pc.kostz.ru

Если вы пришли сюда с QEMU или старой VM, то это именно тот режим, где пока остается ручной туннель.

Частые проблемы

  • Не понимаете, где создавать устройство: для обычного ПК — `Native Agent`, для QEMU/VM — `Legacy fallback`.
  • Есть видео, но нет звука в legacy VNC: не поднят отдельный аудиопоток на `127.0.0.1:4900`.
  • Источник `OFFLINE`: туннель завершился, агент не шлет heartbeat или сама машина недоступна.
  • Ошибка SSH-ключа: проверьте права файла, обычно нужен `chmod 600`.