DeskVNCServer - Opas

Aloittaminen

1. Aseta salasana

Avaa Asetukset (hammasratakuvake, alapalkki) ja täytä VNC-salasana. Vakio-VNC-asiakkaat käyttävät RFB DES challengea, joka huomioi vain ensimmäiset 8 ASCII-yhteensopivaa tavua — valitse salasana, joka on enintään 8 merkkiä pitkä.

2. Käynnistä palvelin

1. Napsauta pääikkunassa Start. Tilan ilmaisin vaihtuu tilaan Running.
2. Neljä kuuntelijaa käynnistyy samanaikaisesti: VNC 5900, QREX control 5911, QREX media 4010 ja file API 8766.
3. Napsauta Copy Info kopioidaksesi yhden rivin tekstin, jossa on isäntä, portit ja nykyinen PIN leikepöydällesi.

3. Yhdistä asiakas

Vakio-VNC-katselijalle (macOS Screen Sharing, RealVNC, TightVNC, mobiili-VNC-sovellukset):

1. Avaa katselija ja syötä osoitteeksi vnc://<your-mac-ip>:5900
2. Kirjoita vaiheessa 1 asettamasi VNC-salasana
3. Hallitse Maciasi heti — näppäimistö, hiiri, kopiointi/liittäminen RFB:n yli

QuickRemote-sovellukselle:

1. Avaa QuickRemote puhelimessa tai tabletissa, valitse Add Mac
2. Syötä DeskVNCServerin näyttämä 6-numeroinen paritus-PIN (tai skannaa QR-koodi, jos QuickRemote-versiosi tukee sitä)
3. QuickRemote tallentaa palautetun Bearer-tunnuksen ja avaa laajennetut ominaisuudet — IME, ääni, leikepöydän synkronointi ja tiedostonsiirto

Käyttöliittymän yleiskatsaus

Tilarivi

Toimintopainikkeet

• Start — Käynnistää kaikki neljä kuuntelijaa.
• Stop — Sulkee jokaisen kuuntelijan ja katkaisee aktiiviset istunnot.
• Copy Info — Kopioi lyhyen yhteyden yhteenvedon (isäntä, VNC-portti, ohjausportti, PIN) leikepöydälle helposti jaettavaksi asiakkaalle.

Yhteyspaneeli

Näyttää bind hostin, portit, nykyisen Server ID:n ja aktiivisen paritus-PIN-koodin. Teksti päivittyy automaattisesti asetusten muuttuessa.

QuickRemote API -paneeli

Nopea viite palvelimen käyttämiin protokolliin. Listaa tuetut RFB-versiot, QREX-päätepisteiden muodot ja IME-komentosarjan, jotta QuickRemote (tai oma asiakkaasi) tietää, mitä on saatavilla.

Protokollat ja portit

Todennus

• VNC-asiakkaat — RFB DES -salasana (määritetyn salasanan ensimmäiset 8 ASCII-yhteensopivaa tavua).
• QREX-asiakkaat — Alkuperäinen 6-numeroinen PIN-vaihto kohdassa POST /qr/v1/pair palauttaa Bearer-tunnuksen. Jokaisen seuraavan QREX HTTP -kutsun ja WebSocket-kehyksen on sisällettävä Authorization: Bearer <token>.
• Jos VNC-salasana on tyhjä, palvelin ilmoittaa vakio-RFB no-auth -tilan. Hyödyllinen vain luotetuille LAN-segmenteille.

QREX-päätepisteiden pikaviite

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

Asetukset

Asiakasesimerkkejä

macOS Screen Sharing

1. Finder → Go → Connect to Server
2. Kirjoita vnc://<your-mac-ip>:5900
3. Syötä VNC-salasana

cURL — selvitä ominaisuudet

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

cURL — parita ja kutsu IME-siltaa

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

Vinkkejä

• Alenna kehysnopeutta ja enimmäiskehysmittoja, kun olet hitaalla Wi-Fi-yhteydellä tai reitität yhteyttä VPN:n kautta.
• Parita jokainen laite kerran. Alkuperäisen PIN-vaihdon jälkeen Bearer-tunnus säilyy uudelleenkäynnistyksissä, joten QuickRemote yhdistää uudelleen huomaamattomasti.
• Käytä Copy Info-toimintoa nopeana tapana lähettää yhteystiedot chatin tai sähköpostin kautta — se sisältää kaiken, mitä asiakas tarvitsee.
• Pidä Enable file mutations pois päältä, ellet todella tarvitse latauksia. Vain luku -tila riittää näyttökuvien, muistiinpanojen tai latausten selaamiseen.
• Poista ääni-API käytöstä, kun et käytä sitä. Käyttämättömät koodekit kuluttavat silti pienen määrän CPU:ta koodauspolulla.

Vianetsintä

Palvelin ei käynnisty

• Toinen VNC-palvelin (esim. macOS Screen Sharing) voi jo olla portissa 5900. Pysäytä se kohdasta System Settings → General → Sharing tai vaihda porttia DeskVNCServerin asetuksissa.
• Porttien 5911 / 4010 / 8766 on kaikkien oltava vapaita. Tarkista komennolla lsof -i :5911 ja vastaavilla.

VNC-asiakkaat eivät pysty todentumaan

• Varmista, että salasana on enintään 8 ASCII-yhteensopivaa tavua. Monitavuiset merkit tai pidemmät merkkijonot katkaistaan hiljaa RFB DES -todennuksen toimesta.
• Jos haluat tarkoituksellisesti olla ilman salasanaa, jätä kenttä tyhjäksi ja yhdistä katselijalla, joka tukee VNC no-auth -tilaa.

QuickRemote ei voi parittaa

• Varmista, että puhelin tai tabletti on samassa Wi-Fissä kuin Mac.
• Avaa Connection-paneeli ja lue PIN uudelleen. PIN voidaan luoda uudelleen Asetuksista.
• Tarkista macOS-palomuurin asetukset — saapuvat yhteydet QREX-porteilla on sallittava.

Etäohjaus tuntuu hitaalta

• Alenna kehysnopeutta ja enimmäiskehysmittoja Asetuksissa.
• Poista käytöstä ominaisuudet, joita et käytä (ääni, leikepöytä, IME), vapauttaaksesi CPU:ta.

Tiedostot eivät siirry

• Varmista, että Enable file transfer on päällä. Vain luku -listaukset toimivat ilman Enable file mutations.
• Jos lataukset epäonnistuvat, ota käyttöön myös Enable file mutations. Muuten file API vastaa vain lukupyyntöihin.

Yksityisyys

• Kaikki istunnot kulkevat suoraan asiakkaan ja Macisi välillä. Ei pilvivälitintä, ei telemetriaa, ei analytiikkaa.
• VNC-salasana, QREX Bearer -tunnus, paritus-PIN ja vakaa Server ID tallennetaan vain sovelluksen paikallisiin asetuksiin.
• Tiedostomuutokset ovat oletuksena pois päältä. Etäasiakkaat voivat lukea vain, kunnes nimenomaisesti myönnät kirjoitusoikeuden.
• Poista käytöstä mikä tahansa laajennus (ääni, leikepöytä, tiedostonsiirto, IME, etäsyöte) milloin tahansa kumotaksesi kyseisen ominaisuuden välittömästi.
• Jos haluat pitää palvelimen paikallisena Macillasi, aseta bind host arvoon 127.0.0.1.