DeskVNCServer - Vodič

Početak rada

1. Postavite lozinku

Otvorite Postavke (ikona zupčanika na donjoj alatnoj traci) i ispunite polje VNC lozinka. Standardni VNC klijenti upotrebljavaju RFB DES izazov koji uvažava samo prvih 8 bajtova kompatibilnih s ASCII-jem — odaberite lozinku od najviše 8 znakova.

2. Pokrenite poslužitelj

1. U glavnom prozoru kliknite Pokreni. Pokazatelj stanja promijenit će se u Pokrenuto.
2. Istodobno se pokreću četiri slušatelja: VNC 5900, QREX upravljanje 5911, QREX mediji 4010i API za datoteke 8766.
3. Kliknite Kopiraj podatke kako biste u međuspremnik kopirali jedan redak s nazivom računala, priključcima i trenutačnim PIN-om.

3. Povežite klijent

Za standardni VNC preglednik (macOS Screen Sharing, RealVNC, TightVNC, mobilne VNC aplikacije):

1. Otvorite preglednik i unesite vnc://<your-mac-ip>:5900 kao adresu
2. Unesite VNC lozinku koju ste postavili u 1. koraku
3. Odmah upravljajte svojim Macom — tipkovnicom, mišem i kopiranjem/lijepljenjem putem RFB-a

Za aplikaciju QuickRemote:

1. Otvorite QuickRemote na telefonu ili tabletu i odaberite Dodaj Mac
2. Unesite 6-znamenkasti PIN za uparivanje koji prikazuje DeskVNCServer (ili skenirajte QR kôd ako ga vaša inačica aplikacije QuickRemote podržava)
3. QuickRemote pohranjuje vraćeni token nositelja i otključava proširene značajke — način unosa, zvuk, sinkronizaciju međuspremnika i prijenos datoteka

Pregled sučelja

Redak stanja

Akcijski gumbi

• Pokreni — pokreće sva četiri slušatelja.
• Zaustavi — zatvara sve slušatelje i prekida aktivne sesije.
• Kopiraj podatke — kopira kratak sažetak veze (naziv računala, VNC priključak, upravljački priključak, PIN) u međuspremnik radi jednostavnog dijeljenja s klijentom.

Ploča veze

Prikazuje adresu vezanja, priključke, trenutačni ID poslužitelja i aktivni PIN za uparivanje. Tekst se automatski osvježava kada se postavke promijene.

Ploča QuickRemote API-ja

Brzi pregled protokola koje poslužitelj podržava. Navodi podržane inačice RFB-a, oblike QREX krajnjih točaka i skup naredbi načina unosa kako bi QuickRemote (ili vaš vlastiti klijent) znao što je dostupno.

Protokoli i priključci

Provjera autentičnosti

• VNC klijenti — RFB DES lozinka (prvih 8 bajtova konfigurirane lozinke kompatibilnih s ASCII-jem).
• QREX klijenti — početna razmjena 6-znamenkastog PIN-a na adresi POST /qr/v1/pair vraća token nositelja. Svaki sljedeći QREX HTTP poziv i WebSocket okvir mora sadržavati Authorization: Bearer <token>.
• Ako je VNC lozinka prazna, poslužitelj oglašava standardni RFB način bez provjere autentičnosti. Upotrebljavajte ga samo na pouzdanim LAN segmentima.

Brzi pregled QREX krajnjih točaka

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

Postavke

Primjeri klijenata

macOS Screen Sharing

1. Finder → Idi → Spoji se na poslužitelj
2. Upišite vnc://<your-mac-ip>:5900
3. Unesite VNC lozinku

cURL — otkrivanje mogućnosti

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

cURL — uparivanje i pozivanje mosta načina unosa

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

Savjeti

• Smanjite broj sličica i najveće dimenzije okvira kada ste na sporoj Wi-Fi vezi ili vezu usmjeravate putem VPN-a.
• Svaki uređaj uparite jednom. Nakon početne razmjene PIN-a token nositelja zadržava se i nakon ponovnog pokretanja, pa se QuickRemote neprimjetno ponovno povezuje.
• Upotrijebite Kopiraj podatke za brzo slanje podataka za povezivanje putem čavrljanja ili e-pošte — sadrži sve što je klijentu potrebno.
• Držite Omogući izmjene datoteka isključeno osim ako doista trebate prijenos na poslužitelj. Način samo za čitanje dovoljan je za pregledavanje snimki zaslona, bilježaka ili preuzimanja.
• Onemogućite API za zvuk kada ga ne upotrebljavate. Neaktivni kodeci ipak troše malo procesorskih resursa na putu kodiranja.

Rješavanje problema

Poslužitelj se ne pokreće

• Drugi VNC poslužitelj (npr. macOS Screen Sharing) možda već upotrebljava priključak 5900. Zaustavite ga u Postavke sustava → Općenito → Dijeljenje ili promijenite priključak u postavkama aplikacije DeskVNCServer.
• Svi priključci 5911 / 4010 / 8766 moraju biti slobodni. Provjerite naredbom lsof -i :5911 i sličnim naredbama.

VNC klijenti ne prolaze provjeru autentičnosti

• Provjerite ima li lozinka najviše 8 bajtova kompatibilnih s ASCII-jem. Višebajtni znakovi i dulji nizovi neprimjetno se skraćuju pri RFB DES provjeri autentičnosti.
• Ako namjerno ne želite lozinku, ostavite polje prazno i povežite se preglednikom koji podržava VNC bez provjere autentičnosti.

QuickRemote se ne može upariti

• Provjerite jesu li telefon ili tablet na istoj Wi-Fi mreži kao Mac.
• Otvorite ploču Veza i ponovno pročitajte PIN. PIN možete ponovno generirati u Postavkama.
• Provjerite postavke vatrozida sustava macOS — dolazne veze na QREX priključcima moraju biti dopuštene.

Udaljeno upravljanje sporo reagira

• Smanjite broj sličica i najveće dimenzije okvira u Postavkama.
• Onemogućite značajke koje ne upotrebljavate (zvuk, međuspremnik, način unosa) kako biste oslobodili procesorske resurse.

Datoteke se ne prenose

• Provjerite je li Omogući prijenos datoteka uključeno. Popisi samo za čitanje rade i bez Omogući izmjene datoteka.
• Ako prijenos na poslužitelj ne uspije, omogućite i Omogući izmjene datoteka. U suprotnom API za datoteke odgovara samo na zahtjeve za čitanje.

Privatnost

• Sve sesije odvijaju se izravno između klijenta i vašeg Maca. Nema releja u oblaku, telemetrije ni analitike.
• VNC lozinka, QREX token nositelja, PIN za uparivanje i stalni ID poslužitelja pohranjuju se samo u lokalnim postavkama aplikacije.
• Izmjene datoteka zadano su isključene. Udaljeni klijenti mogu samo čitati dok im izričito ne odobrite pristup za pisanje.
• U svakom trenutku onemogućite bilo koje proširenje (zvuk, međuspremnik, prijenos datoteka, način unosa, udaljeni unos) kako biste odmah opozvali tu mogućnost.
• Ako poslužitelj želite zadržati lokalno na svojem Macu, postavite adresu vezanja na 127.0.0.1.