DeskVNCServer - Útmutató

Első lépések

1. Állítson be jelszót

Nyissa meg a Beállításokat (fogaskerék ikon, alsó eszköztár) és töltse ki a VNC jelszót. A szabványos VNC kliensek az RFB DES challenge-et használják, amely csak az első 8 ASCII-kompatibilis bájtot fogadja el — válasszon legfeljebb 8 karakteres jelszót.

2. Indítsa el a kiszolgálót

1. A főablakban kattintson a Start gombra. Az állapotjelző átvált Running állapotra.
2. Négy figyelő indul el egyszerre: VNC 5900, QREX control 5911, QREX media 4010 és file API 8766.
3. Kattintson a Copy Info gombra, hogy egy soros szöveget másoljon a vágólapra a hosttal, portokkal és aktuális PIN-kóddal.

3. Csatlakoztasson egy klienst

Szabványos VNC megjelenítőhöz (macOS Screen Sharing, RealVNC, TightVNC, mobil VNC alkalmazások):

1. Nyissa meg a megjelenítőt és írja be címnek: vnc://<your-mac-ip>:5900
2. Írja be az 1. lépésben beállított VNC jelszót
3. Azonnal vezérelheti Macjét — billentyűzet, egér, másolás/beillesztés RFB-n keresztül

A QuickRemote alkalmazáshoz:

1. Nyissa meg a QuickRemote-ot telefonon vagy táblagépen, válassza az Add Mac opciót
2. Írja be a DeskVNCServer által megjelenített 6 számjegyű párosítási PIN-kódot (vagy olvassa be a QR-kódot, ha a QuickRemote verziója támogatja)
3. A QuickRemote tárolja a visszaadott Bearer tokent, és feloldja a bővített funkciókat — IME, hang, vágólap szinkronizálás és fájlátvitel

Felület áttekintése

Állapotsor

Műveleti gombok

• Start — Mind a négy figyelő elindítása.
• Stop — Minden figyelő bezárása és az aktív munkamenetek megszakítása.
• Copy Info — Rövid kapcsolódási összefoglaló (host, VNC port, vezérlőport, PIN) másolása a vágólapra a klienssel való könnyű megosztáshoz.

Kapcsolódási panel

Megjeleníti a bind hostot, portokat, aktuális Server ID-t és az aktív párosítási PIN-kódot. A szöveg automatikusan frissül a beállítások változásakor.

QuickRemote API panel

Gyors hivatkozás a kiszolgáló által támogatott protokollokhoz. Felsorolja a támogatott RFB verziókat, a QREX végpontok formáját és az IME parancskészletet, hogy a QuickRemote (vagy a saját kliense) tudja, mi áll rendelkezésre.

Protokollok és portok

Hitelesítés

• VNC kliensek — RFB DES jelszó (a konfigurált jelszó első 8 ASCII-kompatibilis bájtja).
• QREX kliensek — A 6 számjegyű PIN kezdeti cseréje a POST /qr/v1/pair-on Bearer tokent ad vissza. Minden további QREX HTTP hívásnak és WebSocket keretnek tartalmaznia kell: Authorization: Bearer <token>.
• Ha a VNC jelszó üres, a kiszolgáló a szabványos RFB no-auth módot hirdeti. Csak megbízható LAN szegmensekhez hasznos.

QREX végpontok gyors hivatkozása

GET  /qr/v1/capabilities    # public, returns supported features
POST /qr/v1/pair            # public, exchange PIN for Bearer token
GET  /qr/v1/ws              # WebSocket, auth required
POST /qr/v1/ime/get         # auth required, query active IME
POST /qr/v1/ime/list        # auth required, list available IMEs
POST /qr/v1/ime/set         # auth required, switch IME
POST /qr/v1/ime/toggle      # auth required, toggle IME on/off
POST /qr/v1/ime/commit      # auth required, commit a text string

Beállítások

Kliens példák

macOS Screen Sharing

1. Finder → Go → Connect to Server
2. Írja be: vnc://<your-mac-ip>:5900
3. Adja meg a VNC jelszót

cURL — képességek felfedezése

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

cURL — párosítás és az IME bridge hívása

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

# 2. Commit text via the IME bridge
curl http://<your-mac-ip>:5911/qr/v1/ime/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from remote"}'

Tippek

• Csökkentse a képkockasebességet és a maximális keretméreteket, ha lassú Wi-Fi kapcsolaton van vagy VPN-en keresztül irányítja a kapcsolatot.
• Minden eszközt párosítson egyszer. A kezdeti PIN csere után a Bearer token túléli az újraindításokat, így a QuickRemote csendben újracsatlakozik.
• Használja a Copy Info gombot a kapcsolódási adatok gyors elküldéséhez chaten vagy e-mailben — minden szükséges adatot tartalmaz, ami a kliensnek kell.
• Tartsa kikapcsolva az Enable file mutations opciót, hacsak nem szükségesek a feltöltések. A csak olvasható mód elegendő képernyőképek, jegyzetek vagy letöltések böngészéséhez.
• Tiltsa le az audio API-t, amikor nem használja. Az inaktív kodekek is kis CPU költséggel járnak a kódolási úton.

Hibaelhárítás

A kiszolgáló nem indul el

• Egy másik VNC kiszolgáló (pl. macOS Screen Sharing) már lehet az 5900-as porton. Állítsa le a System Settings → General → Sharing menüpontból, vagy módosítsa a portot a DeskVNCServer beállításaiban.
• Az 5911 / 4010 / 8766 portoknak mind szabadnak kell lenniük. Ellenőrizze a lsof -i :5911 és társai parancsokkal.

A VNC kliensek hitelesítése sikertelen

• Győződjön meg róla, hogy a jelszó legfeljebb 8 ASCII-kompatibilis bájt. A többbájtos karaktereket vagy hosszabb karaktersorozatokat az RFB DES hitelesítés csendben levágja.
• Ha szándékosan nem kíván jelszót, hagyja üresen a mezőt, és csatlakozzon olyan megjelenítővel, amely támogatja a VNC no-auth-ot.

A QuickRemote nem tud párosítani

• Erősítse meg, hogy a telefon vagy táblagép ugyanazon a Wi-Fi-n van, mint a Mac.
• Nyissa meg a Connection panelt és olvassa el újra a PIN-kódot. A PIN újragenerálható a Beállításokból.
• Ellenőrizze a macOS tűzfal beállításait — a QREX portokon érkező kapcsolatoknak engedélyezve kell lenniük.

A távoli vezérlés akadozik

• Csökkentse a képkockasebességet és a maximális keretméreteket a Beállításokban.
• Tiltsa le azokat a funkciókat, amelyeket nem használ (hang, vágólap, IME) a CPU felszabadításához.

A fájlok nem kerülnek átvitelre

• Erősítse meg, hogy az Enable file transfer be van kapcsolva. A csak olvasható listázás működik az Enable file mutations nélkül.
• Ha a feltöltések sikertelenek, engedélyezze az Enable file mutations opciót is. Egyébként a file API csak az olvasási kérésekre válaszol.

Adatvédelem

• Minden munkamenet közvetlenül a kliens és az Ön Mac-je között fut. Nincs felhőalapú relé, telemetria vagy analitika.
• A VNC jelszó, a QREX Bearer token, a párosítási PIN és a stabil Server ID csak a helyi alkalmazás-beállításokban tárolódnak.
• A fájlmutációk alapértelmezés szerint ki vannak kapcsolva. A távoli kliensek csak olvashatnak, amíg kifejezetten nem ad írási hozzáférést.
• Bármikor letilthat bármilyen kiterjesztést (hang, vágólap, fájlátvitel, IME, távoli bevitel), hogy azonnal visszavonja az adott képességet.
• Ha a kiszolgálót helyi szinten szeretné tartani a Macjén, állítsa a bind hostot 127.0.0.1-re.