DeskVNCServer - Guide

Kom i gång

1. Ange ett lösenord

Öppna Inställningar (kugghjulsikonen i det nedre verktygsfältet) och fyll i VNC-lösenord. Vanliga VNC-klienter använder RFB DES-utmaningen, som bara använder de första 8 ASCII-kompatibla byten — välj ett lösenord på högst 8 tecken.

2. Starta servern

1. Klicka på i huvudfönstret Start. Statusindikatorn växlar till Körs.
2. Fyra lyssnare startas samtidigt: VNC 5900, QREX-kontroll 5911, QREX-media 4010och fil-API:t 8766.
3. Klicka på Kopiera info för att kopiera en rad med värd, portar och aktuell PIN-kod till urklippet.

3. Anslut en klient

För en vanlig VNC-visare (macOS Skärmdelning, RealVNC, TightVNC, mobila VNC-appar):

1. Öppna visaren och ange vnc://<your-mac-ip>:5900 som adress
2. Skriv VNC-lösenordet du angav i steg 1
3. Styr din Mac direkt — tangentbord, mus, kopiera/klistra in via RFB

För QuickRemote-appen:

1. Öppna QuickRemote på telefonen eller surfplattan och välj Lägg till Mac
2. Ange den sexsiffriga parkopplings-PIN som visas av DeskVNCServer (eller skanna QR-koden om din QuickRemote-version stöder det)
3. QuickRemote lagrar den returnerade Bearer-token och låser upp de utökade funktionerna — IME, ljud, urklippssynkronisering och filöverföring

Översikt över gränssnittet

Statusrad

Åtgärdsknappar

• Start — Starta alla fyra lyssnare.
• Stoppa — Stäng alla lyssnare och koppla från aktiva sessioner.
• Kopiera info — Kopiera en kort anslutningssammanfattning (värd, VNC-port, kontrollport, PIN) till urklippet för enkel delning med en klient.

Anslutningspanel

Visar bindningsvärd, portar, aktuellt server-ID och den aktiva parkopplings-PIN-koden. Texten uppdateras automatiskt när inställningarna ändras.

QuickRemote API-panel

Snabbreferens för protokollen som servern använder. Visar RFB-versioner som stöds, QREX-slutpunkternas form och IME-kommandouppsättningen så att QuickRemote (eller din egen klient) vet vad som är tillgängligt.

Protokoll och portar

Autentisering

• VNC-klienter — RFB DES-lösenord (de första 8 ASCII-kompatibla byten i det konfigurerade lösenordet).
• QREX-klienter — Inledande utbyte av sexsiffrig PIN-kod på POST /qr/v1/pair returnerar en Bearer-token. Varje efterföljande QREX HTTP-anrop och WebSocket-ram måste innehålla Authorization: Bearer <token>.
• Om VNC-lösenordet är tomt annonserar servern RFB:s vanliga läge utan autentisering. Användbart endast för betrodda LAN-segment.

Snabbreferens för QREX-slutpunkter

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

Inställningar

Klientexempel

macOS Skärmdelning

1. Finder → Gå → Anslut till server
2. Skriv vnc://<your-mac-ip>:5900
3. Ange VNC-lösenordet

cURL — upptäck funktioner

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

cURL — parkoppla och anropa IME-bryggan

# 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

• Sänk bildfrekvensen och de maximala ramdimensionerna när du har en långsam Wi-Fi-länk eller dirigerar anslutningen via VPN.
• Parkoppla varje enhet en gång. Efter det första PIN-utbytet överlever Bearer-token omstarter, så QuickRemote återansluter tyst.
• Använd Kopiera info som ett snabbt sätt att skicka anslutningsuppgifter via chatt eller e-post — den innehåller allt en klient behöver.
• Behåll Aktivera filändringar avstängt om du inte verkligen behöver uppladdningar. Skrivskyddat läge räcker för att bläddra bland skärmbilder, anteckningar eller hämtade filer.
• Inaktivera ljud-API:t när du inte använder det. Inaktiva kodekar kostar fortfarande lite CPU i kodningsvägen.

Felsökning

Servern startar inte

• En annan VNC-server (t.ex. macOS Skärmdelning) kan redan använda port 5900. Stoppa den via Systeminställningar → Allmänt → Delning eller ändra porten i inställningarna för DeskVNCServer.
• Portarna 5911 / 4010 / 8766 måste alla vara lediga. Kontrollera med lsof -i :5911 och liknande.

VNC-klienter kan inte autentisera

• Kontrollera att lösenordet är högst 8 ASCII-kompatibla byte. Flerbytes-tecken eller längre strängar trunkeras tyst av RFB DES-autentiseringen.
• Om du avsiktligt vill ha inget lösenord, lämna fältet tomt och anslut med en visare som stöder VNC utan autentisering.

QuickRemote kan inte parkoppla

• Bekräfta att telefonen eller surfplattan är ansluten till samma Wi-Fi som Macen.
• Öppna anslutningspanelen och läs PIN-koden igen. PIN-koden kan genereras om i Inställningar.
• Kontrollera macOS brandväggsinställningar — inkommande anslutningar på QREX-portarna måste tillåtas.

Fjärrstyrningen känns långsam

• Sänk bildfrekvensen och de maximala ramdimensionerna i Inställningar.
• Inaktivera funktioner du inte använder (ljud, urklipp, IME) för att frigöra CPU.

Filer överförs inte

• Bekräfta Aktivera filöverföring är på. Skrivskyddade listor fungerar utan Aktivera filändringar.
• Om uppladdningar misslyckas aktiverar du även Aktivera filändringar. Annars svarar fil-API:t bara på läsbegäranden.

Integritet

• Alla sessioner körs direkt mellan klienten och din Mac. Det finns inget molnrelä, ingen telemetri och ingen analys.
• VNC-lösenordet, QREX Bearer-token, parkopplings-PIN och stabilt server-ID lagras endast i appens lokala inställningar.
• Filändringar är avstängda som standard. Fjärrklienter kan bara läsa tills du uttryckligen ger skrivåtkomst.
• Inaktivera valfritt tillägg (ljud, urklipp, filöverföring, IME, fjärrinmatning) när som helst för att omedelbart återkalla den funktionen.
• Om du vill hålla servern lokal på din Mac ställer du bindningsvärden till 127.0.0.1.