DeskVNCServer - Sprievodca

Začíname

1. Nastavte heslo

Otvorte nastavenia (ikona ozubeného kolieska na spodnom paneli nástrojov) a vyplňte Heslo VNC. Štandardní klienti VNC používajú výzvu RFB DES, ktorá zohľadňuje iba prvých 8 bajtov kompatibilných s ASCII — vyberte heslo s najviac 8 znakmi.

2. Spustite server

1. V hlavnom okne kliknite na Spustiť. Indikátor stavu sa zmení na Spustené.
2. Naraz sa spustia štyri prijímače: VNC 5900, ovládanie QREX 5911, médiá QREX 4010a API súborov 8766.
3. Kliknite na Kopírovať informácie a skopírujte do schránky jednoriadkové údaje s hostiteľom, portmi a aktuálnym kódom PIN.

3. Pripojte klienta

Pre štandardný prehliadač VNC (macOS Screen Sharing, RealVNC, TightVNC, mobilné aplikácie VNC):

1. Otvorte prehliadač a zadajte vnc://<your-mac-ip>:5900 ako adresu
2. Zadajte heslo VNC nastavené v kroku 1
3. Okamžite ovládajte svoj Mac — klávesnicu, myš a kopírovanie/vkladanie prostredníctvom RFB

Pre aplikáciu QuickRemote:

1. Otvorte QuickRemote v telefóne alebo tablete a vyberte Pridať Mac
2. Zadajte 6-ciferný párovací kód PIN zobrazený aplikáciou DeskVNCServer (alebo naskenujte kód QR, ak ho vaša zostava QuickRemote podporuje)
3. QuickRemote uloží vrátený nosný token a odomkne rozšírené funkcie — IME, zvuk, synchronizáciu schránky a prenos súborov

Prehľad rozhrania

Stavový riadok

Tlačidlá akcií

• Spustiť — Spustí všetky štyri prijímače.
• Zastaviť — Zatvorí všetky prijímače a odpojí aktívne relácie.
• Kopírovať informácie — Skopíruje do schránky krátky súhrn pripojenia (hostiteľ, port VNC, ovládací port, kód PIN), aby sa dal ľahko zdieľať s klientom.

Panel pripojenia

Zobrazuje hostiteľa viazania, porty, aktuálne ID servera a aktívny párovací kód PIN. Text sa pri zmene nastavení automaticky obnoví.

Panel API QuickRemote

Stručný prehľad protokolov používaných serverom. Uvádza podporované verzie RFB, tvary koncových bodov QREX a množinu príkazov IME, aby QuickRemote (alebo váš vlastný klient) vedel, čo je dostupné.

Protokoly a porty

Overovanie

• Klienti VNC — heslo RFB DES (prvých 8 bajtov nakonfigurovaného hesla kompatibilných s ASCII).
• Klienti QREX — Úvodná výmena 6-ciferného kódu PIN na adrese POST /qr/v1/pair vráti nosný token. Každé nasledujúce volanie HTTP QREX a rámec WebSocket musí obsahovať Authorization: Bearer <token>.
• Ak je heslo VNC prázdne, server oznámi štandardný režim RFB bez overovania. Je vhodný iba pre dôveryhodné segmenty siete LAN.

Stručný prehľad koncových bodov QREX

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

Nastavenia

Príklady klientov

Zdieľanie obrazovky macOS

1. Finder → Prejsť → Pripojiť k serveru
2. Zadajte vnc://<your-mac-ip>:5900
3. Zadajte heslo VNC

cURL — zistenie možností

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

cURL — spárovanie a volanie mosta IME

# 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"}'

Tipy

• Pri pomalom pripojení Wi-Fi alebo smerovaní pripojenia cez VPN znížte snímkovú frekvenciu a maximálne rozmery snímky.
• Každé zariadenie spárujte raz. Po úvodnej výmene PIN pretrvá token Bearer aj po reštarte, takže sa QuickRemote znova pripojí bez upozornenia.
• Použite Kopírovať informácie ako rýchly spôsob odoslania údajov o pripojení cez čet alebo e-mail — obsahuje všetko, čo klient potrebuje.
• Ponechajte Povoliť zmeny súborov vypnuté, ak odosielanie súborov naozaj nepotrebujete. Režim iba na čítanie postačuje na prezeranie snímok obrazovky, poznámok alebo stiahnutých súborov.
• Keď zvukové rozhranie API nepoužívate, vypnite ho. Aj nečinné kodeky spotrebúvajú pri kódovaní malé množstvo výkonu CPU.

Riešenie problémov

Server sa nespustí

• Port 5900 už môže používať iný server VNC (napr. Zdieľanie obrazovky macOS). Zastavte ho v časti Systémové nastavenia → Všeobecné → Zdieľanie alebo zmeňte port v nastaveniach DeskVNCServer.
• Porty 5911 / 4010 / 8766 musia byť voľné. Skontrolujte ich pomocou lsof -i :5911 a podobných príkazov.

Overenie klientov VNC zlyháva

• Uistite sa, že heslo má najviac 8 bajtov kompatibilných s ASCII. Viacbajtové znaky alebo dlhšie reťazce overenie RFB DES bez upozornenia skráti.
• Ak zámerne nechcete používať heslo, ponechajte pole prázdne a pripojte sa prehliadačom, ktorý podporuje VNC bez overenia.

QuickRemote sa nedá spárovať

• Skontrolujte, či je telefón alebo tablet v rovnakej sieti Wi-Fi ako Mac.
• Otvorte panel Pripojenie a znova si prečítajte PIN. Nový PIN môžete vytvoriť v Nastaveniach.
• Skontrolujte nastavenia firewallu macOS — prichádzajúce pripojenia na portoch QREX musia byť povolené.

Diaľkové ovládanie reaguje oneskorene

• V Nastaveniach znížte snímkovú frekvenciu a maximálne rozmery snímky.
• Vypnite funkcie, ktoré nepoužívate (zvuk, schránku, IME), aby ste uvoľnili výkon CPU.

Súbory sa neprenášajú

• Skontrolujte, či je Povoliť prenos súborov zapnuté. Zoznamy iba na čítanie fungujú aj bez Povoliť zmeny súborov.
• Ak odosielanie zlyháva, povoľte aj Povoliť zmeny súborov. V opačnom prípade odpovedá súborové rozhranie API iba na požiadavky na čítanie.

Súkromie

• Všetky relácie prebiehajú priamo medzi klientom a vaším Macom. Nepoužíva sa žiadny cloudový prenos, telemetria ani analytika.
• Heslo VNC, token QREX Bearer, párovací PIN a stabilné Server ID sa ukladajú iba v lokálnych nastaveniach aplikácie.
• Zmeny súborov sú predvolene vypnuté. Vzdialení klienti môžu iba čítať, kým výslovne nepovolíte prístup na zápis.
• Kedykoľvek vypnite ľubovoľné rozšírenie (zvuk, schránku, prenos súborov, IME, vzdialený vstup) a okamžite tak odvolajte dané oprávnenie.
• Ak chcete server ponechať lokálne na Macu, nastavte adresu hostiteľa na 127.0.0.1.