DeskVNCServer - Průvodce

Začínáme

1. Nastavte heslo

Otevřete Nastavení (ikona ozubeného kola, spodní lišta) a vyplňte VNC heslo. Standardní VNC klienti používají RFB DES challenge, která respektuje pouze prvních 8 ASCII-kompatibilních bajtů — zvolte heslo o maximální délce 8 znaků.

2. Spusťte server

1. V hlavním okně klikněte na Start. Indikátor stavu se přepne na Running.
2. Najednou se nastartují čtyři posluchače: VNC 5900, QREX control 5911, QREX media 4010 a file API 8766.
3. Klikněte na Copy Info a do schránky zkopírujete jednořádkový text s hostem, porty a aktuálním PIN.

3. Připojte klienta

Pro standardní VNC prohlížeč (macOS Screen Sharing, RealVNC, TightVNC, mobilní VNC aplikace):

1. Otevřete prohlížeč a jako adresu zadejte vnc://<your-mac-ip>:5900
2. Zadejte VNC heslo nastavené v kroku 1
3. Okamžitě ovládejte svůj Mac — klávesnice, myš, kopírování/vkládání přes RFB

Pro aplikaci QuickRemote:

1. Otevřete QuickRemote na telefonu nebo tabletu a zvolte Add Mac
2. Zadejte 6místný párovací PIN zobrazený v DeskVNCServer (nebo naskenujte QR kód, pokud to vaše sestavení QuickRemote podporuje)
3. QuickRemote uloží vrácený Bearer token a odemkne rozšířené funkce — IME, audio, synchronizaci schránky a přenos souborů

Přehled rozhraní

Stavový řádek

Akční tlačítka

• Start — Spustí všechny čtyři posluchače.
• Stop — Zavře každý posluchač a odpojí aktivní relace.
• Copy Info — Zkopíruje krátký souhrn připojení (host, VNC port, control port, PIN) do schránky pro snadné sdílení s klientem.

Panel připojení

Zobrazuje bind host, porty, aktuální Server ID a aktivní párovací PIN. Text se automaticky obnoví při změně nastavení.

Panel QuickRemote API

Rychlá reference pro protokoly, které server hovoří. Uvádí podporované verze RFB, tvary koncových bodů QREX a sadu IME příkazů, aby QuickRemote (nebo váš vlastní klient) věděl, co je k dispozici.

Protokoly a porty

Ověřování

• VNC klienti — RFB DES heslo (prvních 8 ASCII-kompatibilních bajtů nakonfigurovaného hesla).
• QREX klienti — Počáteční výměna 6místného PIN na POST /qr/v1/pair vrátí Bearer token. Každé následující QREX HTTP volání a WebSocket rámec musí obsahovat Authorization: Bearer <token>.
• Pokud je VNC heslo prázdné, server inzeruje standardní RFB no-auth režim. Užitečné pouze pro důvěryhodné segmenty LAN.

Rychlá reference koncových bodů 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

Nastavení

Příklady klientů

macOS Screen Sharing

1. Finder → Go → Connect to Server
2. Zadejte vnc://<your-mac-ip>:5900
3. Zadejte VNC heslo

cURL — zjištění schopností

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

cURL — spárování a volání IME bridge

# 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

• Snižte snímkovou frekvenci a maximální rozměry snímku, pokud jste na pomalém Wi-Fi spojení nebo směrujete připojení přes VPN.
• Každé zařízení spárujte jednou. Po počáteční výměně PIN přežije Bearer token restarty, takže QuickRemote se znovu připojí potichu.
• Použijte Copy Info jako rychlý způsob, jak poslat detaily připojení přes chat nebo email — obsahuje vše, co klient potřebuje.
• Nechte Enable file mutations vypnuté, pokud opravdu nepotřebujete nahrávání. Režim pouze pro čtení je dostatečný pro procházení snímků obrazovky, poznámek nebo stažených souborů.
• Vypněte audio API, když ho nepoužíváte. Nečinné kodeky stále stojí malé množství CPU na kódovací cestě.

Řešení problémů

Server se nespustí

• Jiný VNC server (např. macOS Screen Sharing) může již být na portu 5900. Zastavte ho v System Settings → General → Sharing, nebo změňte port v nastavení DeskVNCServer.
• Porty 5911 / 4010 / 8766 musí být všechny volné. Zkontrolujte pomocí lsof -i :5911 a podobných.

VNC klienti se nemohou autentizovat

• Ujistěte se, že heslo má nejvýše 8 ASCII-kompatibilních bajtů. Vícebajtové znaky nebo delší řetězce jsou tiše ořezány RFB DES ověřením.
• Pokud chcete úmyslně bez hesla, nechte pole prázdné a připojte se prohlížečem, který podporuje VNC no-auth.

QuickRemote se nemůže spárovat

• Potvrďte, že telefon nebo tablet je na stejné Wi-Fi jako Mac.
• Otevřete panel Connection a znovu si přečtěte PIN. PIN lze regenerovat z Nastavení.
• Zkontrolujte nastavení firewallu macOS — příchozí spojení na QREX portech musí být povolena.

Vzdálené ovládání je pomalé

• Snižte snímkovou frekvenci a maximální rozměry snímku v Nastavení.
• Vypněte funkce, které nepoužíváte (audio, schránka, IME), abyste uvolnili CPU.

Soubory se nepřenášejí

• Potvrďte, že Enable file transfer je zapnuto. Výpisy pouze pro čtení fungují bez Enable file mutations.
• Pokud nahrávání selhává, povolte také Enable file mutations. Jinak file API odpovídá pouze na požadavky čtení.

Soukromí

• Všechny relace běží přímo mezi klientem a vaším Macem. Není žádné cloudové relé, žádná telemetrie, žádné analytiky.
• VNC heslo, QREX Bearer token, párovací PIN a stabilní Server ID jsou uloženy pouze v místních nastaveních aplikace.
• Mutace souborů jsou ve výchozím nastavení vypnuté. Vzdálení klienti mohou pouze číst, dokud explicitně neudělíte přístup k zápisu.
• Kdykoli vypněte jakékoli rozšíření (audio, schránka, přenos souborů, IME, vzdálený vstup), abyste tuto schopnost okamžitě odebrali.
• Pokud chcete server udržet místní pro váš Mac, nastavte bind host na 127.0.0.1.