Docs

Tunnel + Audio Setup

Инструкция для пользователя: как поднять VNC туннель и аудио туннель для своего ПК.

1. Что нужно локально

Ваш VNC сервер должен слушать `127.0.0.1:5900`.
Для звука нужен MP3 поток на `127.0.0.1:4900`.
Приватный ключ сервера, скачанный из дашборда.

2. Запустите аудио поток (если нужен звук)

Пример для 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

Если `default` не подходит, проверьте источники: `pactl list short sources`.

3. Запустите SSH туннель

Откройте свой сервер в дашборде.
Скопируйте «Команда туннеля» и выполните ее на той же машине, где VNC/audio.
Используйте ключ, который скачали для этого сервера.
Не закрывайте SSH процесс, иначе сервер станет `OFFLINE`.

SSH endpoint: pc@pc.kostz.ru

4. Проверка

На главной странице ваш сервер должен стать `ONLINE`.
Откройте noVNC и проверьте картинку/управление.
Для звука нажмите кнопку audio в viewer (автовоспроизведение может блокироваться браузером).

5. QEMU example (VNC + sound)

Пример запуска QEMU с VNC на `127.0.0.1:5900` и звуком через PulseAudio/PipeWire:

qemu-system-x86_64 \
  -name "SharedPC VM" \
  -m 4G \
  -smp 4 \
  -vnc 127.0.0.1:0 \
  -device usb-tablet \
  -audiodev pa,id=pa0,server=/run/user/$(id -u)/pulse/native \
  -device ich9-intel-hda \
  -device hda-output,audiodev=pa0 \
  -drive file=vm.qcow2,if=virtio

После запуска QEMU отдельно поднимите аудио-стрим командой `ffmpeg` из шага 2 и затем запустите SSH туннель из шага 3.

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

Видео есть, звука нет: не запущен MP3 поток на `127.0.0.1:4900`.
Сервер `OFFLINE`: SSH туннель завершился или не поднялся.
Ошибка ключа SSH: проверьте права файла (`chmod 600 your_key_file`).
Звук рвется: снизьте битрейт в `ffmpeg` и проверьте сеть/нагрузку CPU.