DeskVNCServer - Guia

Primers passos

1. Definiu una contrasenya

Obriu Configuració (icona d’engranatge, barra d’eines inferior) i empleneu Contrasenya VNC. Els clients VNC estàndard utilitzen el desafiament DES de RFB, que només té en compte els primers 8 bytes compatibles amb ASCII; trieu una contrasenya de 8 caràcters com a màxim.

2. Inicieu el servidor

1. A la finestra principal, feu clic a Inicia. L’indicador d’estat canvia a En execució.
2. S’activen quatre serveis d’escolta alhora: VNC 5900, control QREX 5911, mitjans QREX 4010i l’API de fitxers 8766.
3. Feu clic a Copy Info per copiar al porta-retalls una línia amb l’amfitrió, els ports i el PIN actual.

3. Connecteu un client

Per a un visor VNC estàndard (Compartició de pantalla de macOS, RealVNC, TightVNC o aplicacions VNC mòbils):

1. Obriu el visor i introduïu vnc://<your-mac-ip>:5900 com a adreça
2. Escriviu la contrasenya VNC que heu definit al pas 1
3. Controleu el Mac immediatament: teclat, ratolí i copiar/enganxar mitjançant RFB

Per a l’aplicació QuickRemote:

1. Obriu QuickRemote al telèfon o a la tauleta i trieu Add Mac
2. Introduïu el PIN d’aparellament de 6 dígits que mostra DeskVNCServer (o escanegeu el codi QR si la vostra versió de QuickRemote ho admet)
3. QuickRemote desa el token Bearer retornat i desbloqueja les funcions ampliades: IME, àudio, sincronització del porta-retalls i transferència de fitxers

Descripció general de la interfície

Fila d’estat

Botons d’acció

• Inicia — Activa els quatre serveis d’escolta.
• Atura — Tanca tots els serveis d’escolta i desconnecta les sessions actives.
• Copy Info — Copia al porta-retalls un resum breu de la connexió (amfitrió, port VNC, port de control i PIN) per compartir-lo fàcilment amb un client.

Tauler de connexió

Mostra l’amfitrió d’enllaç, els ports, l’ID de servidor actual i el PIN d’aparellament actiu. El text s’actualitza automàticament quan canvia la configuració.

Tauler de l’API de QuickRemote

Referència ràpida dels protocols que utilitza el servidor. Enumera les versions de RFB compatibles, els formats dels endpoints QREX i el conjunt d’ordres de l’IME perquè QuickRemote (o el vostre client) sàpiga què hi ha disponible.

Protocols i ports

Autenticació

• Clients VNC — contrasenya DES de RFB (els primers 8 bytes compatibles amb ASCII de la contrasenya configurada).
• Clients QREX — l’intercanvi inicial del PIN de 6 dígits a POST /qr/v1/pair retorna un token Bearer. Totes les crides HTTP QREX i les trames WebSocket posteriors han d’incloure Authorization: Bearer <token>.
• Si la contrasenya VNC és buida, el servidor anuncia el mode RFB estàndard sense autenticació. Utilitzeu-lo només en segments LAN de confiança.

Referència ràpida dels endpoints QREX

GET  /qr/v1/capabilities    # públic, retorna les funcions compatibles
POST /qr/v1/pair            # públic, intercanvia el PIN per un token Bearer
GET  /qr/v1/ws              # WebSocket, requereix autenticació
POST /qr/v1/ime/get         # requereix autenticació, consulta l’IME actiu
POST /qr/v1/ime/list        # requereix autenticació, mostra els IME disponibles
POST /qr/v1/ime/set         # requereix autenticació, canvia l’IME
POST /qr/v1/ime/toggle      # requereix autenticació, activa o desactiva l’IME
POST /qr/v1/ime/commit      # requereix autenticació, confirma una cadena de text

Configuració

Exemples de clients

Compartició de pantalla de macOS

1. Finder → Ves → Connecta’t al servidor
2. Escriviu vnc://<your-mac-ip>:5900
3. Introduïu la contrasenya VNC

cURL — descobriu les funcions disponibles

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

cURL — aparella i crida el pont de l’IME

# 1. Intercanvieu el PIN per 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. Confirmeu text mitjançant el pont de l’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"}'

Consells

• Reduïu la freqüència d’imatges i les dimensions màximes quan utilitzeu una connexió Wi-Fi lenta o encamineu la connexió mitjançant una VPN.
• Aparelleu cada dispositiu una sola vegada. Després de l’intercanvi inicial del PIN, el token Bearer es conserva entre reinicis, de manera que QuickRemote es torna a connectar sense avisar.
• Utilitzeu Copy Info com a manera ràpida d’enviar les dades de connexió per xat o correu electrònic; inclou tot el que necessita un client.
• Manteniu Activa les modificacions de fitxers desactivat tret que necessiteu realment carregar fitxers. El mode de només lectura és suficient per consultar captures de pantalla, notes o baixades.
• Desactiveu l’API d’àudio quan no la utilitzeu. Els còdecs inactius continuen consumint una petita quantitat de CPU durant la codificació.

Resolució de problemes

El servidor no s’inicia

• És possible que un altre servidor VNC (p. ex., Compartició de pantalla de macOS) ja utilitzi el port 5900. Atureu-lo a Configuració del Sistema → General → Compartir, o canvieu el port a la configuració de DeskVNCServer.
• Els ports 5911 / 4010 / 8766 han d’estar lliures. Comproveu-ho amb lsof -i :5911 i ordres similars.

Els clients VNC no es poden autenticar

• Assegureu-vos que la contrasenya tingui com a màxim 8 bytes compatibles amb ASCII. L’autenticació DES de RFB trunca silenciosament els caràcters multibyte o les cadenes més llargues.
• Si voleu prescindir expressament de la contrasenya, deixeu el camp buit i connecteu-vos amb un visor compatible amb VNC sense autenticació.

QuickRemote no es pot aparellar

• Confirmeu que el telèfon o la tauleta estiguin connectats a la mateixa xarxa Wi-Fi que el Mac.
• Obriu el tauler Connexió i torneu a llegir el PIN. Podeu regenerar-lo a Configuració.
• Comproveu la configuració del tallafoc de macOS; cal permetre les connexions entrants als ports QREX.

El control remot respon amb retard

• Reduïu la freqüència d’imatges i les dimensions màximes a Configuració.
• Desactiveu les funcions que no utilitzeu (àudio, porta-retalls, IME) per alliberar CPU.

Els fitxers no es transfereixen

• Confirmeu que Activa la transferència de fitxers estigui activat. Les llistes de només lectura funcionen sense Activa les modificacions de fitxers.
• Si les càrregues fallen, activeu també Activa les modificacions de fitxers. En cas contrari, l’API de fitxers només respon a sol·licituds de lectura.

Privadesa

• Totes les sessions s’estableixen directament entre el client i el Mac. No hi ha cap retransmissió al núvol, telemetria ni analítiques.
• La contrasenya VNC, el token Bearer de QREX, el PIN d’aparellament i l’ID de servidor estable només es desen a la configuració local de l’aplicació.
• Les modificacions de fitxers estan desactivades per defecte. Els clients remots només poden llegir fins que els concediu explícitament accés d’escriptura.
• Podeu desactivar qualsevol extensió (àudio, porta-retalls, transferència de fitxers, IME o entrada remota) en qualsevol moment per revocar immediatament aquesta capacitat.
• Si voleu mantenir el servidor restringit al Mac, establiu l’amfitrió d’enllaç en 127.0.0.1.