DeskVNCServer - Guía

Primeros pasos

1. Establezca una contraseña

Abra Ajustes (icono de engranaje, barra de herramientas inferior) y rellene Contraseña VNC. Los clientes VNC estándar usan el desafío DES de RFB, que solo tiene en cuenta los primeros 8 bytes compatibles con ASCII: elija una contraseña de 8 caracteres como máximo.

2. Inicie el servidor

1. En la ventana principal, haga clic en Iniciar. El indicador de estado cambia a En ejecución.
2. Se activan cuatro escuchas a la vez: VNC 5900, control QREX 5911, medios QREX 4010y la API de archivos 8766.
3. Haga clic en Copy Info para copiar al portapapeles una línea con el host, los puertos y el PIN actual.

3. Conecte un cliente

Para un visor VNC estándar (Compartir pantalla de macOS, RealVNC, TightVNC, apps VNC para móvil):

1. Abra el visor e introduzca vnc://<your-mac-ip>:5900 como dirección
2. Escriba la contraseña VNC que estableció en el paso 1
3. Controle su Mac de inmediato: teclado, ratón y copiar/pegar a través de RFB

Para la aplicación QuickRemote:

1. Abra QuickRemote en el teléfono o la tableta y elija Add Mac
2. Introduzca el PIN de emparejamiento de 6 dígitos que muestra DeskVNCServer (o escanee el código QR si su versión de QuickRemote lo admite)
3. QuickRemote guarda el token Bearer recibido y desbloquea las funciones ampliadas: IME, audio, sincronización del portapapeles y transferencia de archivos

Descripción de la interfaz

Fila de estado

Botones de acción

• Iniciar — Activa los cuatro escuchas.
• Detener — Cierra todos los escuchas y desconecta las sesiones activas.
• Copy Info — Copia al portapapeles un breve resumen de la conexión (host, puerto VNC, puerto de control, PIN) para compartirlo fácilmente con un cliente.

Panel de conexión

Muestra el host de vinculación, los puertos, el ID de servidor actual y el PIN de emparejamiento activo. El texto se actualiza automáticamente cuando cambian los ajustes.

Panel de la API de QuickRemote

Referencia rápida de los protocolos que habla el servidor. Enumera las versiones de RFB compatibles, los formatos de los endpoints QREX y el conjunto de comandos del IME, para que QuickRemote (o su propio cliente) sepa qué está disponible.

Protocolos y puertos

Autenticación

• Clientes VNC — Contraseña DES de RFB (los primeros 8 bytes compatibles con ASCII de la contraseña configurada).
• Clientes QREX — El intercambio inicial del PIN de 6 dígitos en POST /qr/v1/pair devuelve un token Bearer. Todas las llamadas HTTP QREX y los frames de WebSocket posteriores deben incluir Authorization: Bearer <token>.
• Si la contraseña VNC está vacía, el servidor anuncia el modo estándar de RFB sin autenticación. Útil solo en segmentos de red LAN de confianza.

Referencia rápida de endpoints QREX

GET  /qr/v1/capabilities    # público, devuelve las funciones disponibles
POST /qr/v1/pair            # público, canjea el PIN por un token Bearer
GET  /qr/v1/ws              # WebSocket, requiere autenticación
POST /qr/v1/ime/get         # requiere autenticación, consulta el IME activo
POST /qr/v1/ime/list        # requiere autenticación, lista los IME disponibles
POST /qr/v1/ime/set         # requiere autenticación, cambia de IME
POST /qr/v1/ime/toggle      # requiere autenticación, activa o desactiva el IME
POST /qr/v1/ime/commit      # requiere autenticación, confirma una cadena de texto

Ajustes

Ejemplos de cliente

Compartir pantalla de macOS

1. Finder → Ir → Conectarse al servidor
2. Escriba vnc://<your-mac-ip>:5900
3. Introduzca la contraseña VNC

cURL — descubrir las funciones disponibles

curl http://<your-mac-ip>:5911/qr/v1/capabilities

cURL — emparejar y llamar al puente de IME

# 1. Canjear el PIN por un token Bearer
TOKEN=$(curl -s http://<your-mac-ip>:5911/qr/v1/pair \
  -H "Content-Type: application/json" \
  -d '{"pin":"123456"}' | jq -r .token)

# 2. Confirmar texto mediante el puente de IME
curl http://<your-mac-ip>:5911/qr/v1/ime/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from remote"}'

Consejos

• Reduzca la frecuencia de fotogramas y las dimensiones máximas cuando use una conexión Wi-Fi lenta o dirija la conexión a través de una VPN.
• Empareje cada dispositivo una sola vez. Tras el intercambio inicial del PIN, el token Bearer sobrevive a los reinicios, por lo que QuickRemote se reconecta de forma silenciosa.
• Use Copy Info como forma rápida de enviar los datos de conexión por chat o correo electrónico: incluye todo lo que necesita un cliente.
• Mantenga Activar las modificaciones de archivos desactivado salvo que realmente necesite subir archivos. El modo de solo lectura basta para consultar capturas, notas o descargas.
• Desactive la API de audio cuando no la utilice. Los códecs inactivos siguen consumiendo algo de CPU en la ruta de codificación.

Resolución de problemas

El servidor no se inicia

• Puede que otro servidor VNC (por ejemplo, Compartir pantalla de macOS) ya esté usando el puerto 5900. Deténgalo en Ajustes del Sistema → General → Compartir, o cambie el puerto en los ajustes de DeskVNCServer.
• Los puertos 5911 / 4010 / 8766 deben estar todos libres. Compruébelo con lsof -i :5911 y comandos similares.

Los clientes VNC no consiguen autenticarse

• Asegúrese de que la contraseña tenga como máximo 8 bytes compatibles con ASCII. La autenticación DES de RFB trunca en silencio los caracteres multibyte o las cadenas más largas.
• Si desea intencionadamente no usar contraseña, deje el campo vacío y conéctese con un visor compatible con el modo VNC sin autenticación.

QuickRemote no consigue emparejarse

• Confirme que el teléfono o la tableta están en la misma red Wi-Fi que el Mac.
• Abra el panel de conexión y vuelva a leer el PIN. El PIN puede regenerarse desde Ajustes.
• Revise los ajustes del firewall de macOS: deben permitirse las conexiones entrantes en los puertos QREX.

El control remoto va con retardo

• Reduzca la frecuencia de fotogramas y las dimensiones máximas en Ajustes.
• Desactive las funciones que no utilice (audio, portapapeles, IME) para liberar CPU.

Los archivos no se transfieren

• Confirme que Activar la transferencia de archivos está activado. Los listados de solo lectura funcionan sin Activar las modificaciones de archivos.
• Si las subidas fallan, active también Activar las modificaciones de archivos. De lo contrario, la API de archivos solo responde a solicitudes de lectura.

Privacidad

• Todas las sesiones se establecen directamente entre el cliente y su Mac. No hay relé en la nube, ni telemetría, ni analíticas.
• La contraseña VNC, el token Bearer de QREX, el PIN de emparejamiento y el ID de servidor estable se guardan únicamente en los ajustes locales de la aplicación.
• Las modificaciones de archivos están desactivadas de forma predeterminada. Los clientes remotos solo pueden leer hasta que usted conceda acceso de escritura explícitamente.
• Desactive cualquier extensión (audio, portapapeles, transferencia de archivos, IME, entrada remota) en cualquier momento para revocar esa capacidad de inmediato.
• Si desea mantener el servidor limitado a su Mac, establezca el host de vinculación en 127.0.0.1.