DeskVNCServer - Veiledning

Komme i gang

1. Angi et passord

Åpne Innstillinger (tannhjulikon, nedre verktøylinje) og fyll inn VNC-passord. Standard VNC-klienter bruker RFB DES challenge, som bare respekterer de første 8 ASCII-kompatible bytene — velg et passord på maksimalt 8 tegn.

2. Start serveren

1. Klikk Start i hovedvinduet. Statusindikatoren skifter til Running.
2. Fire lyttere starter samtidig: VNC 5900, QREX control 5911, QREX media 4010 og file API 8766.
3. Klikk Copy Info for å kopiere en enlinjes tekst med vert, porter og gjeldende PIN til utklippstavlen.

3. Koble til en klient

For en standard VNC-viser (macOS Screen Sharing, RealVNC, TightVNC, mobile VNC-apper):

1. Åpne viseren og skriv inn vnc://<your-mac-ip>:5900 som adresse
2. Skriv VNC-passordet du satte i trinn 1
3. Kontroller Macen umiddelbart — tastatur, mus, kopier/lim inn over RFB

For QuickRemote-appen:

1. Åpne QuickRemote på telefonen eller nettbrettet, velg Add Mac
2. Skriv inn den 6-sifrede paring-PIN-en som DeskVNCServer viser (eller skann QR-koden, hvis QuickRemote-versjonen din støtter det)
3. QuickRemote lagrer den returnerte Bearer-tokenet og låser opp de utvidede funksjonene — IME, lyd, synkronisering av utklippstavle og filoverføring

Grensesnittoversikt

Statusrad

Handlingsknapper

• Start — Starter alle fire lytterne.
• Stop — Lukker hver lytter og kobler fra aktive økter.
• Copy Info — Kopierer et kort sammendrag av tilkoblingen (vert, VNC-port, kontrollport, PIN) til utklippstavlen for enkel deling med en klient.

Tilkoblingspanel

Viser bind host, porter, gjeldende Server ID og den aktive paring-PIN-en. Teksten oppdateres automatisk når innstillingene endres.

QuickRemote API-panel

Rask referanse til protokollene serveren bruker. Lister opp støttede RFB-versjoner, QREX-endepunktformer og IME-kommandosettet, slik at QuickRemote (eller din egen klient) vet hva som er tilgjengelig.

Protokoller og porter

Autentisering

• VNC-klienter — RFB DES-passord (første 8 ASCII-kompatible bytes av det konfigurerte passordet).
• QREX-klienter — Innledende utveksling av 6-sifret PIN på POST /qr/v1/pair returnerer en Bearer-token. Hvert påfølgende QREX HTTP-kall og WebSocket-ramme må inkludere Authorization: Bearer <token>.
• Hvis VNC-passordet er tomt, annonserer serveren standard RFB no-auth modus. Bare nyttig for klarerte LAN-segmenter.

Rask referanse til QREX-endepunkter

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

Innstillinger

Klienteksempler

macOS Screen Sharing

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

cURL — oppdag funksjoner

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

cURL — par og kall IME-broen

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

Tips

• Senk bildehastigheten og de maksimale rammedimensjonene når du er på en treg Wi-Fi-tilkobling eller ruter forbindelsen gjennom en VPN.
• Par hver enhet én gang. Etter den innledende PIN-utvekslingen overlever Bearer-tokenet omstarter, så QuickRemote kobler til på nytt stille.
• Bruk Copy Info som en rask måte å sende tilkoblingsdetaljer over chat eller e-post — det inkluderer alt en klient trenger.
• Hold Enable file mutations av med mindre du virkelig trenger opplastinger. Skrivebeskyttet modus er nok til å bla i skjermbilder, notater eller nedlastinger.
• Deaktiver lyd-API-et når du ikke bruker det. Inaktive kodeker koster fortsatt en liten mengde CPU på kodingsbanen.

Feilsøking

Serveren vil ikke starte

• En annen VNC-server (f.eks. macOS Screen Sharing) kan allerede være på port 5900. Stopp den fra System Settings → General → Sharing, eller endre porten i DeskVNCServers innstillinger.
• Portene 5911 / 4010 / 8766 må alle være ledige. Sjekk med lsof -i :5911 og lignende.

VNC-klienter klarer ikke autentisere

• Pass på at passordet er maksimalt 8 ASCII-kompatible bytes. Multibyte-tegn eller lengre strenger blir stille avkortet av RFB DES-auth.
• Hvis du med vilje vil ha intet passord, la feltet stå tomt og koble til med en viser som støtter VNC no-auth.

QuickRemote kan ikke pare

• Bekreft at telefonen eller nettbrettet er på samme Wi-Fi som Macen.
• Åpne Connection-panelet og les PIN på nytt. PIN kan genereres på nytt fra Innstillinger.
• Sjekk macOS-brannmurinnstillinger — innkommende tilkoblinger på QREX-portene må være tillatt.

Fjernstyring føles treg

• Senk bildehastigheten og de maksimale rammedimensjonene i Innstillinger.
• Deaktiver funksjoner du ikke bruker (lyd, utklippstavle, IME) for å frigjøre CPU.

Filer overføres ikke

• Bekreft at Enable file transfer er på. Skrivebeskyttede oppføringer fungerer uten Enable file mutations.
• Hvis opplastinger mislykkes, aktiver også Enable file mutations. Ellers svarer file API kun på leseforespørsler.

Personvern

• Alle økter går direkte mellom klienten og Macen din. Det er ingen skyrelé, ingen telemetri, ingen analyse.
• VNC-passordet, QREX Bearer-tokenet, paring-PIN-en og den stabile Server-ID-en lagres kun i appens lokale innstillinger.
• Filmutasjoner er av som standard. Fjernklienter kan bare lese inntil du eksplisitt gir skrivetilgang.
• Deaktiver enhver utvidelse (lyd, utklippstavle, filoverføring, IME, fjerninndata) når som helst for å trekke tilbake den evnen umiddelbart.
• Hvis du vil holde serveren lokal til Macen din, sett bind host til 127.0.0.1.