DeskVNCServer - Vejledning

Kom godt i gang

1. Angiv en adgangskode

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

2. Start serveren

1. I hovedvinduet skal du klikke på Start. Statusindikatoren skifter til Kører.
2. Fire lyttere starter på én gang: VNC 5900, QREX-styring 5911, QREX-medier 4010og fil-API'et 8766.
3. Klik på Kopiér oplysninger for at kopiere en enkelt linje med værten, portene og den aktuelle PIN-kode til udklipsholderen.

3. Tilslut en klient

For en standard VNC-fremviser (macOS Skærmdeling, RealVNC, TightVNC, mobile VNC-apps):

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

For QuickRemote-appen:

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

Overblik over brugerfladen

Statusrække

Handlingsknapper

• Start — Start alle fire lyttere.
• Stop — Luk alle lyttere, og afbryd aktive sessioner.
• Kopiér oplysninger — Kopiér et kort forbindelsesresumé (vært, VNC-port, kontrolport, PIN) til udklipsholderen for nem deling med en klient.

Forbindelsespanel

Viser bindingsværten, portene, det aktuelle server-id og den aktive parrings-PIN. Teksten opdateres automatisk, når indstillingerne ændres.

QuickRemote API-panel

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

Protokoller og porte

Godkendelse

• VNC-klienter — RFB DES-adgangskode (de første 8 ASCII-kompatible byte af den konfigurerede adgangskode).
• QREX-klienter — Indledende udveksling af 6-cifret PIN på POST /qr/v1/pair returnerer et Bearer-token. Alle efterfølgende QREX HTTP-kald og WebSocket-rammer skal omfatte Authorization: Bearer <token>.
• Hvis VNC-adgangskoden er tom, annoncerer serveren standard-RFB-tilstanden uden godkendelse. Kun nyttigt for pålidelige LAN-segmenter.

Hurtig reference til QREX-endpoints

GET  /qr/v1/capabilities    # offentlig, returnerer understøttede funktioner
POST /qr/v1/pair            # offentlig, udveksl PIN med Bearer-token
GET  /qr/v1/ws              # WebSocket, godkendelse påkrævet
POST /qr/v1/ime/get         # godkendelse påkrævet, forespørg aktiv IME
POST /qr/v1/ime/list        # godkendelse påkrævet, vis tilgængelige IME'er
POST /qr/v1/ime/set         # godkendelse påkrævet, skift IME
POST /qr/v1/ime/toggle      # godkendelse påkrævet, slå IME til/fra
POST /qr/v1/ime/commit      # godkendelse påkrævet, indsæt en tekststreng

Indstillinger

Klienteksempler

macOS Skærmdeling

1. Finder → Gå → Opret forbindelse til server
2. Indtast vnc://<your-mac-ip>:5900
3. Indtast VNC-adgangskoden

cURL — find funktioner

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

cURL — par, og kald IME-broen

# 1. Udveksl PIN-koden med et 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. Indsæt tekst via IME-broen
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 rammedimensioner, når du er på en langsom Wi-Fi-forbindelse eller fører forbindelsen gennem en VPN.
• Par hver enhed én gang. Efter den første PIN-udveksling overlever Bearer-tokenet genstarter, så QuickRemote genopretter forbindelsen uden varsel.
• Brug Kopiér oplysninger som en hurtig måde at sende forbindelsesoplysninger via chat eller e-mail — den omfatter alt, hvad en klient har brug for.
• Hold Aktivér filændringer slået fra, medmindre du virkelig har brug for overførsler. Den skrivebeskyttede tilstand er nok til at gennemse skærmbilleder, noter eller downloads.
• Deaktivér lyd-API'et, når du ikke bruger det. Inaktive codecs bruger stadig en lille mængde CPU i kodningsprocessen.

Fejlfinding

Serveren starter ikke

• En anden VNC-server (f.eks. macOS Screen Sharing) bruger muligvis allerede port 5900. Stop den i Systemindstillinger → Generelt → Deling, eller skift porten i indstillingerne i DeskVNCServer.
• Portene 5911 / 4010 / 8766 skal alle være ledige. Kontrollér med lsof -i :5911 og lignende kommandoer.

VNC-klienter kan ikke godkendes

• Sørg for, at adgangskoden højst er 8 ASCII-kompatible byte. Multibyte-tegn eller længere strenge afkortes uden varsel af RFB DES-godkendelsen.
• Hvis du bevidst ønsker ingen adgangskode, skal du lade feltet være tomt og oprette forbindelse med en fremviser, der understøtter VNC uden godkendelse.

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 igen fra Indstillinger.
• Kontrollér macOS-firewallindstillingerne — indgående forbindelser på QREX-portene skal være tilladt.

Fjernstyringen føles forsinket

• Sænk billedfrekvensen og de maksimale rammedimensioner i Indstillinger.
• Deaktivér funktioner, du ikke bruger (lyd, udklipsholder, IME), for at frigøre CPU.

Filer overføres ikke

• Bekræft Aktivér filoverførsel er slået til. Skrivebeskyttede lister fungerer uden Aktivér filændringer.
• Hvis overførsler fejler, skal du også aktivere Aktivér filændringer. Ellers svarer fil-API'et kun på læseanmodninger.

Privatliv

• Alle sessioner kører direkte mellem klienten og din Mac. Der er ingen cloud-relæ, telemetri eller analyse.
• VNC-adgangskoden, QREX Bearer-tokenet, parrings-PIN-koden og det stabile server-id gemmes kun i de lokale appindstillinger.
• Filændringer er som standard slået fra. Fjernklienter kan kun læse, indtil du udtrykkeligt giver skriveadgang.
• Deaktivér enhver udvidelse (lyd, udklipsholder, filoverførsel, IME, fjerninput) når som helst for straks at tilbagekalde denne mulighed.
• Hvis du vil holde serveren lokal på din Mac, skal du angive bindingsværten til 127.0.0.1.