Más allá de TAKT

qsm-rd

QSM Direct sustituye la imagen de noVNC en la consola web de Proxmox VE por un flujo de video WebRTC, en la misma pestaña del navegador, con el mismo inicio de sesión de PVE y el mismo permiso VM.Console. No se instala nada en el cliente, y pveproxy y pvedaemon funcionan sin modificaciones.

Proxmox VE
WebRTC
LXC

Repositorio en GitHub Proyecto relacionado: escrow-box

Estado: Versión 0.4.0. HEVC es experimental y la migración en vivo de una VM con QSM Display1 no se ha validado. Hay una solicitud de función registrada en Proxmox (bug #8106); en el repositorio están preparados un RFC y series de parches para qemu-server y pve-manager.
Licencia: GPL-3.0-or-later; el script de consola de PVE, el servicio de señalización, la consola LXC y la página del visor son AGPL-3.0-or-later.
Plataformas: Nodos Proxmox VE 9; en el cliente, un navegador con H.264 y Opus en WebRTC.

Qué resuelve

La consola noVNC estándar envía los rectángulos de pantalla que cambian. Para trabajar dentro de un escritorio en ejecución, con video, desplazamiento o interfaces animadas, eso significa pocas imágenes distintas por segundo con mucho ancho de banda, y sin 3D en el invitado. QSM Direct codifica la pantalla del invitado como video en el nodo y la transmite al navegador. El README publica una comparación medida con noVNC estándar, incluidos los casos en los que noVNC sigue siendo la mejor herramienta: la primera imagen, un evento de puntero aislado y todo lo que ocurre antes de que arranque un sistema operativo.

Funciones principales

H.264 por defecto mediante NVENC, QSV, VA-API o libx264 en la CPU; HEVC como opción explícita y experimental por VM.
Invitados VirGL con OpenGL y 3D, o adaptadores Standard VGA, VirtIO y VMware sin GPU.
Sonido (Opus), el micrófono del navegador en el invitado y portapapeles de texto en ambos sentidos; en una VM el portapapeles requiere un agente invitado opcional.
El movimiento del puntero viaja por su propio canal no ordenado que solo lleva el último estado, así que no puede quedar en cola detrás de un fotograma pesado.
Contenedores LXC con escritorio KDE Plasma: una consola por tty, cada una con su propia pantalla de inicio de sesión.

Cómo funciona

El navegador envía su oferta WebRTC a un servicio de señalización local del nodo en el puerto TLS 8007. El servicio comprueba el ticket de PVE del navegador y el permiso VM.Console a través del propio /access/ticket de PVE y entrega la oferta a un servicio de terminal, que inicia un proceso de medios por VM. Ese proceso lee la pantalla D-Bus de QEMU, codifica imagen y sonido y los envía directamente al navegador; la entrada vuelve por el mismo camino. Todos los espectadores de una VM comparten un mismo flujo del codificador.

apt install ./qsm-pve-direct_*.deb
systemctl enable --now qsm-pve-direct-terminal.service qsm-pve-direct-signal.service

Requisitos

Proxmox VE 9 (pve-manager 9.x); el paquete se compila en Debian 13 y se instala en cada nodo que pueda ejecutar la VM.
Navegador: Chrome, Edge, Chromium con códecs propietarios, Safari o Firefox con el plugin OpenH264.
Red: TCP 8006 y 8007 y UDP entrante desde las redes de los operadores; un nombre de host para el que sea válido el certificado del nodo.
Codificador: NVENC, QSV, VA-API o la CPU (alrededor de medio núcleo por consola abierta con libx264); el perfil VirGL necesita un dispositivo de renderizado DRM. Hasta 16 sesiones de consola por nodo.

Esta página resume el README y la documentación del repositorio a octubre de 2026. La fuente de referencia es el propio repositorio.

Repositorio en GitHub ← Todos los proyectos