DeskVNCServer - Veiledning

Kom i gang

1. Angi et passord

Åpne Innstillinger (tannhjulikon, nederste verktøylinje) og fyll inn VNC-passord. Vanlige VNC-klienter bruker RFB DES-utfordringen, som bare godtar de første 8 ASCII-kompatible bytene — velg et passord på høyst 8 tegn.

2. Start serveren

1. I hovedvinduet klikker du på Start. Statusindikatoren endres til Kjører.
2. Fire lyttere starter samtidig: VNC 5900, QREX-kontroll 5911, QREX-medier 4010, og fil-API-et 8766.
3. Klikk på Kopier info for å kopiere en enkelt linje med vert, porter og gjeldende PIN til utklippstavlen.

3. Koble til en klient

For en vanlig VNC-visning (macOS Skjermdeling, RealVNC, TightVNC, mobile VNC-apper):

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

For QuickRemote-appen:

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

Oversikt over grensesnittet

Statusrad

Handlingsknapper

• Start — Start alle de fire lytterne.
• Stopp — Lukk alle lytterne og koble fra aktive økter.
• Kopier info — Kopier en kort tilkoblingsoversikt (vert, VNC-port, kontrollport, PIN) til utklippstavlen for enkel deling med en klient.

Tilkoblingspanel

Viser bindingsvert, porter, gjeldende server-ID og den aktive sammenkoblings-PIN-en. Teksten oppdateres automatisk når innstillingene endres.

QuickRemote API-panel

Hurtigreferanse for protokollene serveren bruker. Viser støttede RFB-versjoner, QREX-endepunktformatene og IME-kommandosettet, slik at QuickRemote (eller din egen klient) vet hva som er tilgjengelig.

Protokoller og porter

Autentisering

• VNC-klienter — RFB DES-passord (de første 8 ASCII-kompatible bytene i det konfigurerte passordet).
• QREX-klienter — Innledende utveksling av 6-sifret PIN-kode på POST /qr/v1/pair returnerer et Bearer-token. Alle påfølgende QREX HTTP-kall og WebSocket-rammer må inkludere Authorization: Bearer <token>.
• Hvis VNC-passordet er tomt, annonserer serveren standard RFB-modus uten autentisering. Kun nyttig for pålitelige LAN-segmenter.

Hurtigreferanse for QREX-endepunkter

GET  /qr/v1/capabilities    # offentlig, returnerer støttede funksjoner
POST /qr/v1/pair            # offentlig, bytt PIN-kode mot Bearer-token
GET  /qr/v1/ws              # WebSocket, autentisering kreves
POST /qr/v1/ime/get         # autentisering kreves, spør etter aktiv IME
POST /qr/v1/ime/list        # autentisering kreves, list opp tilgjengelige IME-er
POST /qr/v1/ime/set         # autentisering kreves, bytt IME
POST /qr/v1/ime/toggle      # autentisering kreves, slå IME av/på
POST /qr/v1/ime/commit      # autentisering kreves, legg inn en tekststreng

Innstillinger

Klienteksempler

macOS-skjermdeling

1. Finder → Gå → Koble til tjener
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 — koble sammen og bruk IME-broen

# 1. Bytt PIN-koden mot 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. Legg inn 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

• Senk bildefrekvensen og de maksimale rammedimensjonene når du er på en treg Wi-Fi-forbindelse eller ruter tilkoblingen gjennom en VPN.
• Koble sammen hver enhet én gang. Etter den innledende PIN-utvekslingen overlever Bearer-tokenet omstarter, slik at QuickRemote kobler til igjen uten varsel.
• Bruk Kopier info som en rask måte å sende tilkoblingsdetaljer via chat eller e-post på — den inneholder alt en klient trenger.
• Hold Aktiver filendringer av med mindre du virkelig trenger opplastinger. Skrivebeskyttet modus er nok for å bla gjennom skjermbilder, notater eller nedlastinger.
• Deaktiver lyd-API-et når du ikke bruker det. Ledige kodeker bruker fortsatt litt CPU i kodingsprosessen.

Feilsøking

Serveren starter ikke

• En annen VNC-server (f.eks. macOS-skjermdeling) kan allerede bruke port 5900. Stopp den fra Systeminnstillinger → Generelt → Deling, eller endre porten i innstillingene for DeskVNCServer.
• Portene 5911 / 4010 / 8766 må alle være ledige. Sjekk med lsof -i :5911 og lignende.

VNC-klienter får ikke autentisert

• Kontroller at passordet er på maksimalt 8 ASCII-kompatible byte. Flerbyte-tegn eller lengre strenger blir stille avkortet av RFB DES-autentiseringen.
• Hvis du med hensikt vil ha ingen passord, lar du feltet stå tomt og kobler til med en fremviser som støtter VNC uten autentisering.

QuickRemote kan ikke koble sammen

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

Ekstern styring føles treg

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

Filer overføres ikke

• Bekreft at Aktiver filoverføring er på. Skrivebeskyttede oppføringer fungerer uten Aktiver filendringer.
• Hvis opplastinger mislykkes, aktiver også Aktiver filendringer. Ellers svarer fil-API-et bare på leseforespørsler.

Personvern

• Alle økter kjører direkte mellom klienten og Mac-en din. Det finnes ingen skysentral, telemetri eller analyse.
• VNC-passordet, QREX Bearer-tokenet, PIN-koden for sammenkobling og den stabile server-ID-en lagres bare i de lokale appinnstillingene.
• Filendringer er av som standard. Eksterne klienter kan bare lese til du uttrykkelig gir skrivetilgang.
• Deaktiver en hvilken som helst utvidelse (lyd, utklippstavle, filoverføring, IME, ekstern inndata) når som helst for å tilbakekalle denne funksjonen umiddelbart.
• Hvis du vil beholde serveren lokalt på Mac-en, angir du vertsadressen for binding til 127.0.0.1.