DeskVNCServer - Ghid

Primii pași

1. Setați o parolă

Deschideți Setări (pictograma roată dințată din bara de instrumente de jos) și completați Parola VNC. Clienții VNC standard folosesc mecanismul RFB DES, care ia în considerare doar primii 8 octeți compatibili ASCII — alegeți o parolă de cel mult 8 caractere.

2. Porniți serverul

1. În fereastra principală, faceți clic pe Pornire. Indicatorul de stare devine În funcțiune.
2. Sunt pornite simultan patru servicii de ascultare: VNC 5900, control QREX 5911, media QREX 4010și API-ul pentru fișiere 8766.
3. Faceți clic pe Copiați informațiile pentru a copia în clipboard un rezumat pe un singur rând cu gazda, porturile și PIN-ul curent.

3. Conectați un client

Pentru un vizualizator VNC standard (Partajare ecran macOS, RealVNC, TightVNC, aplicații VNC mobile):

1. Deschideți vizualizatorul și introduceți vnc://<your-mac-ip>:5900 ca adresă
2. Introduceți parola VNC setată la pasul 1
3. Controlați imediat Mac-ul — tastatură, mouse și copiere/lipire prin RFB

Pentru aplicația QuickRemote:

1. Deschideți QuickRemote pe telefon sau tabletă și selectați Adăugați un Mac
2. Introduceți PIN-ul de asociere din 6 cifre afișat de DeskVNCServer (sau scanați codul QR dacă versiunea QuickRemote acceptă această funcție)
3. QuickRemote păstrează tokenul Bearer primit și deblochează funcțiile extinse — metodă de introducere, sunet, sincronizarea clipboardului și transferul de fișiere

Prezentarea interfeței

Rândul de stare

Butoane de acțiune

• Pornire — Porniți toate cele patru servicii de ascultare.
• Oprire — Închideți toate serviciile de ascultare și deconectați sesiunile active.
• Copiați informațiile — Copiați în clipboard un scurt rezumat al conexiunii (gazdă, port VNC, port de control, PIN), pentru a-l partaja ușor cu un client.

Panoul Conexiune

Afișează gazda de asociere, porturile, Server ID curent și PIN-ul de asociere activ. Textul se actualizează automat când se modifică setările.

Panoul API QuickRemote

Referință rapidă pentru protocoalele serverului. Enumeră versiunile RFB acceptate, structura punctelor finale QREX și setul de comenzi pentru metoda de introducere, astfel încât QuickRemote (sau propriul client) să știe ce este disponibil.

Protocoale și porturi

Autentificare

• Clienți VNC — Parolă RFB DES (primii 8 octeți compatibili ASCII ai parolei configurate).
• Clienți QREX — Schimbul inițial al PIN-ului din 6 cifre la POST /qr/v1/pair restituie un token Bearer. Fiecare apel HTTP QREX și fiecare cadru WebSocket ulterior trebuie să includă Authorization: Bearer <token>.
• Dacă parola VNC este goală, serverul anunță modul RFB standard fără autentificare. Folosiți-l numai în segmente LAN de încredere.

Referință rapidă pentru punctele finale QREX

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

Setări

Exemple pentru clienți

Partajare ecran macOS

1. Finder → Accesare → Conectare la server
2. Introduceți vnc://<your-mac-ip>:5900
3. Introduceți parola VNC

cURL — descoperirea capacităților

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

cURL — asociere și apelarea punții pentru metoda de introducere

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

Sfaturi

• Reduceți frecvența cadrelor și dimensiunile maxime ale acestora când folosiți o conexiune Wi-Fi lentă sau rutați conexiunea printr-un VPN.
• Asociați fiecare dispozitiv o singură dată. După schimbul inițial prin PIN, tokenul Bearer rămâne valabil după reporniri, astfel încât QuickRemote se reconectează fără intervenție.
• Folosiți Copiați informațiile ca modalitate rapidă de a trimite detaliile conexiunii prin chat sau e-mail — include tot ce îi trebuie unui client.
• Păstrați Activați modificarea fișierelor dezactivată dacă nu aveți cu adevărat nevoie de încărcări. Modul doar pentru citire este suficient pentru a răsfoi capturi de ecran, notițe sau descărcări.
• Dezactivați API-ul audio când nu îl folosiți. Codecurile inactive consumă totuși o cantitate mică de resurse ale procesorului pe calea de codare.

Depanare

Serverul nu pornește

• Este posibil ca un alt server VNC (de exemplu, Partajare ecran macOS) să folosească deja portul 5900. Opriți-l din Setări sistem → General → Partajare sau schimbați portul în setările DeskVNCServer.
• Porturile 5911 / 4010 / 8766 trebuie să fie toate libere. Verificați cu lsof -i :5911 și comenzi similare.

Clienții VNC nu se pot autentifica

• Asigurați-vă că parola are cel mult 8 octeți compatibili ASCII. Caracterele multioctet sau șirurile mai lungi sunt trunchiate fără avertisment de autentificarea RFB DES.
• Dacă doriți intenționat să nu folosiți o parolă, lăsați câmpul gol și conectați-vă cu un vizualizator care acceptă VNC fără autentificare.

QuickRemote nu se poate asocia

• Confirmați că telefonul sau tableta este conectată la aceeași rețea Wi-Fi ca Mac-ul.
• Deschideți panoul Conexiune și verificați din nou PIN-ul. PIN-ul poate fi regenerat din Setări.
• Verificați setările firewallului macOS — conexiunile primite pe porturile QREX trebuie permise.

Controlul la distanță răspunde lent

• Reduceți frecvența cadrelor și dimensiunile maxime ale acestora în Setări.
• Dezactivați funcțiile pe care nu le folosiți (audio, clipboard, metodă de introducere) pentru a elibera resursele procesorului.

Fișierele nu se transferă

• Confirmați că Activați transferul de fișiere este activată. Listările doar pentru citire funcționează fără Activați modificarea fișierelor.
• Dacă încărcările eșuează, activați și Activați modificarea fișierelor. În caz contrar, API-ul pentru fișiere răspunde numai solicitărilor de citire.

Confidențialitate

• Toate sesiunile se desfășoară direct între client și Mac. Nu există releu cloud, telemetrie sau analiză.
• Parola VNC, tokenul Bearer QREX, PIN-ul de asociere și Server ID stabil sunt stocate numai în setările locale ale aplicației.
• Modificarea fișierelor este dezactivată implicit. Clienții la distanță pot doar să citească până când le acordați explicit acces la scriere.
• Dezactivați oricând orice extensie (audio, clipboard, transfer de fișiere, metodă de introducere, control la distanță) pentru a revoca imediat funcția respectivă.
• Dacă doriți ca serverul să rămână local pe Mac, setați gazda de asociere la 127.0.0.1.