DeskVNCServer - Útmutató

Első lépések

1. Állítson be jelszót

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

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

1. A főablakban kattintson az Indításgombra. Az állapotjelző erre vált: Fut.
2. Egyszerre négy figyelő indul el: VNC 5900, QREX-vezérlés 5911, QREX-média 4010és a fájl-API 8766.
3. Kattintson az Információk másolása gombbal egyetlen sorban a vágólapra másolhatja a gépnevet, a portokat és az aktuális PIN-kódot.

3. Csatlakoztasson egy klienst

Szabványos VNC-megjelenítő esetén (macOS Screen Sharing, RealVNC, TightVNC, mobil VNC-alkalmazások):

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

A QuickRemote alkalmazás esetében:

1. Nyissa meg a QuickRemote alkalmazást telefonján vagy táblagépén, majd válassza a Mac hozzáadása
2. lehetőséget. Adja meg a DeskVNCServer által mutatott 6 jegyű párosítási PIN-kódot (vagy olvassa be a QR-kódot, ha a QuickRemote adott verziója támogatja)
3. A QuickRemote eltárolja a visszakapott Bearer tokent, és feloldja a kibővített funkciókat — IME, hang, vágólap-szinkronizálás és fájlátvitel

A felület áttekintése

Állapotsor

Műveletgombok

• Indítás — Mind a négy figyelő elindítása.
• Leállítás — Minden figyelő bezárása és az aktív munkamenetek bontása.
• Információk másolása — Rövid kapcsolati összefoglaló (gépnév, VNC-port, vezérlőport, PIN-kód) másolása a vágólapra, hogy egyszerűen megosztható legyen egy klienssel.

Kapcsolat panel

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

QuickRemote API panel

Gyors áttekintés a kiszolgáló által használt protokollokról. Felsorolja a támogatott RFB-verziókat, a QREX-végpontok formáit és az IME-parancskészletet, hogy a QuickRemote (vagy saját kliense) tudja, mi érhető el.

Protokollok és portok

Hitelesítés

• VNC-kliensek — RFB DES-jelszó (a beállított jelszó első 8 ASCII-kompatibilis bájtja).
• QREX-kliensek — A kezdeti 6 jegyű PIN-csere ezen a végponton: POST /qr/v1/pair Bearer tokent ad vissza. Minden ezt követő QREX HTTP-hívásnak és WebSocket-keretnek tartalmaznia kell ezt: Authorization: Bearer <token>.
• Ha a VNC-jelszó üres, a kiszolgáló szabványos, hitelesítés nélküli RFB-módot hirdet. Csak megbízható LAN-szegmenseken használja.

QREX-végpontok gyors áttekintése

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

Klienspéldák

macOS Screen Sharing

1. Finder → Ugrás → Kapcsolódás szerverhez
2. Írja be: vnc://<your-mac-ip>:5900
3. Adja meg a VNC-jelszót

cURL — képességek lekérdezése

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

cURL — párosítás és az IME-híd meghí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

• Lassú Wi-Fi-kapcsolat vagy VPN-en át irányított kapcsolat esetén csökkentse a képkockasebességet és a képkockák maximális méretét.
• Minden eszközt egyszer párosítson. A kezdeti PIN-csere után a Bearer token újraindításkor is megmarad, így a QuickRemote észrevétlenül újracsatlakozik.
• Használja az Információk másolása lehetőséget a kapcsolati adatok gyors elküldéséhez csevegésben vagy e-mailben — mindent tartalmaz, amire a kliensnek szüksége van.
• Hagyja kikapcsolva a Fájlmódosítások engedélyezése beállítást, hacsak valóban nincs szüksége feltöltésre. A csak olvasható mód elegendő képernyőképek, jegyzetek és letöltések böngészéséhez.
• Tiltsa le a hang-API-t, amikor nem használja. A tétlen kodekek is igényelnek némi processzorteljesítményt a kódolási útvonalon.

Hibaelhárítás

A kiszolgáló nem indul el

• Lehet, hogy egy másik VNC-kiszolgáló (például a macOS Screen Sharing) már használja az 5900-as portot. Állítsa le a System Settings → General → Sharing menüben, vagy módosítsa a portot a DeskVNCServer beállításaiban.
• Az 5911 / 4010 / 8766 portoknak szabadnak kell lenniük. Ellenőrizze a következővel: lsof -i :5911 és a megfelelő további parancsokkal.

A VNC-kliensek hitelesítése sikertelen

• Győződjön meg arról, hogy a jelszó legfeljebb 8 ASCII-kompatibilis bájt. Az RFB DES-hitelesítés csendben levágja a több bájtos karaktereket és a hosszabb szövegeket.
• Ha szándékosan nem szeretne jelszót, hagyja üresen a mezőt, és hitelesítés nélküli VNC-t támogató megjelenítővel csatlakozzon.

A QuickRemote nem párosítható

• Ellenőrizze, hogy a telefon vagy táblagép ugyanahhoz a Wi-Fi-hálózathoz csatlakozik-e, mint a Mac.
• Nyissa meg a Kapcsolat panelt, és olvassa le újra a PIN-kódot. A PIN-kód a Beállításokból újragenerálható.
• Ellenőrizze a macOS tűzfalbeállításait — a QREX-portokon engedélyezni kell a bejövő kapcsolatokat.

A távoli vezérlés késik

• Csökkentse a képkockasebességet és a képkockák maximális méretét a Beállításokban.
• A processzor tehermentesítéséhez tiltsa le a nem használt funkciókat (hang, vágólap, IME).

A fájlok átvitele sikertelen

• Ellenőrizze, hogy a Fájlátvitel engedélyezése beállítás aktív-e. A csak olvasható listázás működik a Fájlmódosítások engedélyezése.
• nélkül. Ha a feltöltés sikertelen, engedélyezze a Fájlmódosítások engedélyezésebeállítást is. Ellenkező esetben a fájl-API csak olvasási kérésekre válaszol.

Adatvédelem

• Minden munkamenet közvetlenül a kliens és az Ön Mac gépe között fut. Nincs felhőalapú közvetítő, telemetria vagy elemzés.
• A VNC-jelszó, a QREX Bearer token, a párosítási PIN-kód és az állandó Server ID kizárólag a helyi alkalmazásbeállításokban tárolódik.
• A fájlmódosítások alapértelmezés szerint ki vannak kapcsolva. A távoli kliensek csak olvashatnak, amíg Ön kifejezetten nem ad írási hozzáférést.
• Bármikor letilthat bármely bővítményt (hang, vágólap, fájlátvitel, IME, távoli bevitel), és ezzel azonnal visszavonhatja az adott képességet.
• Ha a kiszolgálót kizárólag a Macen szeretné elérhetővé tenni, állítsa a kötési gépcímet erre: 127.0.0.1.