DeskVNCServer - Vejledning

Kom godt i gang

1. Indstil en adgangskode

Åbn Indstillinger (tandhjulsikon, nederste værktøjslinje) og udfyld VNC-adgangskode. Standard VNC-klienter bruger RFB DES challenge, som kun respekterer de første 8 ASCII-kompatible bytes — vælg en adgangskode på højst 8 tegn.

2. Start serveren

1. Klik på Start i hovedvinduet. Statusindikatoren skifter til Running.
2. Fire lyttere kommer op på samme tid: VNC 5900, QREX control 5911, QREX media 4010 og file API 8766.
3. Klik på Copy Info for at kopiere en énlinjes tekst med vært, porte og aktuel PIN til din udklipsholder.

3. Tilslut en klient

For en standard VNC-viewer (macOS Screen Sharing, RealVNC, TightVNC, mobile VNC-apps):

1. Åbn vieweren og indtast vnc://<your-mac-ip>:5900 som adresse
2. Indtast den VNC-adgangskode, du indstillede i trin 1
3. Styr din Mac med det samme — tastatur, mus, kopier/indsæt over RFB

For QuickRemote-appen:

1. Åbn QuickRemote på telefonen eller tabletten, vælg Add Mac
2. Indtast den 6-cifrede parrings-PIN, som DeskVNCServer viser (eller scan QR-koden, hvis din QuickRemote-version understøtter det)
3. QuickRemote gemmer den returnerede Bearer-token og låser op for de udvidede funktioner — IME, lyd, synkronisering af udklipsholder og filoverførsel

Oversigt over grænseflade

Statusrække

Handlingsknapper

• Start — Starter alle fire lyttere.
• Stop — Lukker hver lytter og afbryder aktive sessioner.
• Copy Info — Kopierer et kort forbindelsesresumé (vært, VNC-port, kontrolport, PIN) til udklipsholderen for nem deling med en klient.

Forbindelsespanel

Viser bind host, porte, aktuelt Server ID og den aktive parrings-PIN. Teksten opdateres automatisk, når indstillingerne ændres.

QuickRemote API-panel

Hurtig reference til de protokoller, serveren taler. Lister de understøttede RFB-versioner, QREX-endpoint-formerne og IME-kommandosættet, så QuickRemote (eller din egen klient) ved, hvad der er tilgængeligt.

Protokoller og porte

Autentificering

• VNC-klienter — RFB DES-adgangskode (første 8 ASCII-kompatible bytes af den konfigurerede adgangskode).
• QREX-klienter — Indledende udveksling af 6-cifret PIN ved POST /qr/v1/pair returnerer en Bearer-token. Hvert efterfølgende QREX HTTP-kald og WebSocket-frame skal indeholde Authorization: Bearer <token>.
• Hvis VNC-adgangskoden er tom, annoncerer serveren standard RFB no-auth tilstand. Kun nyttigt for betroede LAN-segmenter.

Hurtig reference til QREX-endpoints

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

Indstillinger

Klienteksempler

macOS Screen Sharing

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

cURL — find kapabiliteter

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

cURL — par og kald 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

• Sænk billedfrekvensen og de maksimale frame-dimensioner, når du er på et langsomt Wi-Fi-link eller fører forbindelsen gennem en VPN.
• Par hver enhed én gang. Efter den indledende PIN-udveksling overlever Bearer-token genstarter, så QuickRemote tilslutter sig stille igen.
• Brug Copy Info som en hurtig måde at sende forbindelsesdetaljer over chat eller e-mail — det inkluderer alt, hvad en klient har brug for.
• Lad Enable file mutations være slået fra, medmindre du virkelig har brug for uploads. Skrivebeskyttet tilstand er nok til at gennemse skærmbilleder, noter eller downloads.
• Deaktiver lyd-API'et, når du ikke bruger det. Inaktive codecs koster stadig en lille mængde CPU på kodningsstien.

Fejlfinding

Serveren vil ikke starte

• En anden VNC-server (f.eks. macOS Screen Sharing) er muligvis allerede på port 5900. Stop den fra System Settings → General → Sharing, eller skift porten i DeskVNCServers indstillinger.
• Portene 5911 / 4010 / 8766 skal alle være ledige. Tjek med lsof -i :5911 og lignende.

VNC-klienter kan ikke autentificere

• Sørg for, at adgangskoden er højst 8 ASCII-kompatible bytes. Multibyte-tegn eller længere strenge afkortes stille af RFB DES-auth.
• Hvis du med vilje ikke vil have nogen adgangskode, lad feltet være tomt og tilslut med en viewer, der understøtter VNC no-auth.

QuickRemote kan ikke parre

• Bekræft, at telefonen eller tabletten er på samme Wi-Fi som Mac'en.
• Åbn forbindelsespanelet og læs PIN-koden igen. PIN-koden kan genereres på ny fra Indstillinger.
• Tjek macOS firewall-indstillingerne — indgående forbindelser på QREX-portene skal være tilladt.

Fjernstyring føles langsom

• Sænk billedfrekvensen og de maksimale frame-dimensioner i Indstillinger.
• Deaktiver funktioner, du ikke bruger (lyd, udklipsholder, IME), for at frigøre CPU.

Filer overføres ikke

• Bekræft, at Enable file transfer er slået til. Skrivebeskyttede lister fungerer uden Enable file mutations.
• Hvis uploads mislykkes, så aktivér også Enable file mutations. Ellers svarer file API'et kun på læseanmodninger.

Privatliv

• Alle sessioner kører direkte mellem klienten og din Mac. Der er intet cloud-relæ, ingen telemetri, ingen analyse.
• VNC-adgangskoden, QREX Bearer-tokenet, parrings-PIN og det stabile Server-ID gemmes kun i appens lokale indstillinger.
• Filmutationer er slået fra som standard. Fjernklienter kan kun læse, indtil du udtrykkeligt giver skriveadgang.
• Deaktiver enhver udvidelse (lyd, udklipsholder, filoverførsel, IME, fjerninput) når som helst for straks at tilbagekalde den kapabilitet.
• Hvis du vil holde serveren lokal på din Mac, så sæt bind host til 127.0.0.1.