DeskVNCServer - Opas

Näin pääset alkuun

1. Aseta salasana

Avaa Asetukset (rataskuvake alatyökalurivillä) ja täytä kenttä VNC-salasana. Tavalliset VNC-asiakkaat käyttävät RFB:n DES-haastetta, joka huomioi vain ensimmäiset 8 ASCII-yhteensopivaa tavua — valitse enintään 8 merkin salasana.

2. Käynnistä palvelin

1. Napsauta pääikkunassa Käynnistä. Tilailmaisin vaihtuu muotoon Käynnissä.
2. Neljä kuuntelijaa käynnistyy kerralla: VNC 5900, QREX-ohjaus 5911, QREX-media 4010sekä tiedosto-API 8766.
3. Napsauta Kopioi tiedot kopioidaksesi leikepöydälle yhden rivin, jossa ovat isäntä, portit ja nykyinen PIN.

3. Yhdistä asiakas

Tavallisella VNC-katselimella (macOS Screen Sharing, RealVNC, TightVNC, mobiilien VNC-sovellukset):

1. Avaa katselin ja kirjoita vnc://<your-mac-ip>:5900 osoitteeksi
2. Kirjoita vaiheessa 1 asettamasi VNC-salasana
3. Hallitse Maciasi heti — näppäimistö, hiiri ja kopioi/liitä RFB:n kautta

QuickRemote-sovellukselle:

1. Avaa QuickRemote puhelimessa tai tabletissa ja valitse Lisää Mac
2. Anna DeskVNCServer-palvelimessa näkyvä 6-numeroinen pariliitos-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

• Käynnistä — käynnistä kaikki neljä kuuntelijaa.
• Pysäytä — sulje kaikki kuuntelijat ja katkaise aktiiviset istunnot.
• Kopioi tiedot — kopioi lyhyt yhteenveto yhteydestä (isäntä, VNC-portti, ohjausportti, PIN) leikepöydälle asiakkaalle jakamista varten.

Yhteyspaneeli

Näyttää sidotun isännän, portit, nykyisen Server ID:n ja aktiivisen pariliitos-PINin. Teksti päivittyy automaattisesti asetusten muuttuessa.

QuickRemote API -paneeli

Pikaviite palvelimen käyttämille protokollille. Luettelee tuetut RFB-versiot, QREX-päätepisteiden muodot ja IME-komentojoukon, jotta QuickRemote (tai oma asiakkaasi) tietää, mitä on käytettävissä.

Protokollat ja portit

Todennus

• VNC-asiakkaat — RFB DES -salasana (määritetyn salasanan ensimmäiset 8 ASCII-yhteensopivaa tavua).
• QREX-asiakkaat — ensimmäinen 6-numeroinen PIN-vaihto osoitteessa POST /qr/v1/pair palauttaa Bearer-tunnuksen. Jokaisessa myöhemmässä QREX HTTP -kutsussa ja WebSocket-kehyksessä on oltava Authorization: Bearer <token>.
• Jos VNC-salasana on tyhjä, palvelin ilmoittaa tavallisen RFB:n ilman todennusta -tilan. Käytä vain luotetuissa LAN-segmenteissä.

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

Asiakasesimerkit

macOS Screen Sharing

1. Finder → Siirry → Yhdistä palvelimeen
2. Kirjoita vnc://<your-mac-ip>:5900
3. Anna VNC-salasana

cURL — selvitä ominaisuudet

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

cURL — muodosta pariliitos 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"}'

Vinkit

• Pienennä kuvataajuutta ja kehyksen enimmäismittoja, kun käytät hidasta Wi-Fi-yhteyttä tai reitität yhteyden VPN:n kautta.
• Muodosta pariliitos jokaisen laitteen kanssa kerran. Ensimmäisen PIN-vaihdon jälkeen Bearer-tunnus säilyy uudelleenkäynnistyksissä, joten QuickRemote yhdistää hiljaisesti uudelleen.
• Käytä Kopioi tiedot nopeana tapana lähettää yhteystiedot chatissa tai sähköpostissa — se sisältää kaiken, mitä asiakas tarvitsee.
• Pidä Ota tiedostomuutokset käyttöön pois käytöstä, 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ä. Joutokäynnillä olevat koodekitkin kuluttavat hieman suoritinta koodauspolulla.

Vianmääritys

Palvelin ei käynnisty

• Toinen VNC-palvelin (esim. macOS Screen Sharing) saattaa jo käyttää porttia 5900. Pysäytä se kohdassa System Settings → General → Sharing tai vaihda portti DeskVNCServer-palvelimen asetuksissa.
• Porttien 5911 / 4010 / 8766 on kaikkien oltava vapaita. Tarkista komennolla lsof -i :5911 ja vastaavilla.

VNC-asiakkaiden todennus epäonnistuu

• Varmista, että salasana on enintään 8 ASCII-yhteensopivaa tavua. RFB DES -todennus katkaisee monen tavun merkit tai pidemmät merkkijonot hiljaisesti.
• Jos haluat tarkoituksella olla käyttämättä salasanaa, jätä kenttä tyhjäksi ja yhdistä katselimella, joka tukee VNC:n ei-todennusta.

QuickRemote ei voi muodostaa pariliitosta

• Varmista, että puhelin tai tabletti on samassa Wi-Fi-verkossa kuin Mac.
• Avaa Yhteys-paneeli ja tarkista PIN uudelleen. PIN voidaan luoda uudelleen asetuksista.
• Tarkista macOS-palomuurin asetukset — QREX-porttien saapuvat yhteydet on sallittava.

Etähallinta tuntuu viiveiseltä

• Pienennä kuvataajuutta ja kehyksen enimmäismittoja asetuksissa.
• Poista käyttämättömät ominaisuudet käytöstä (ääni, leikepöytä, IME) suorittimen vapauttamiseksi.

Tiedostot eivät siirry

• Varmista, että Ota tiedostonsiirto käyttöön on käytössä. Vain luku -luettelot toimivat ilman sitä Ota tiedostomuutokset käyttöön.
• Jos lataukset epäonnistuvat, ota käyttöön myös Ota tiedostomuutokset käyttöön. Muussa tapauksessa tiedosto-API vastaa vain lukupyyntöihin.

Tietosuoja

• Kaikki istunnot toimivat suoraan asiakkaan ja Macisi välillä. Pilvivälitystä, telemetriaa tai analytiikkaa ei ole.
• VNC-salasana, QREX Bearer-tunnus, pariliitos-PIN ja pysyvä Server ID tallennetaan vain paikallisiin sovellusasetuksiin.
• Tiedostomuutokset ovat oletuksena pois käytöstä. Etäasiakkaat voivat vain lukea, kunnes annat nimenomaisesti kirjoitusoikeuden.
• Voit poistaa minkä tahansa laajennuksen (ääni, leikepöytä, tiedostonsiirto, IME, etäsyöte) käytöstä milloin tahansa peruuttaaksesi oikeuden välittömästi.
• Jos haluat pitää palvelimen paikallisena Macissasi, aseta sidottu isäntä arvoon 127.0.0.1.