DeskVNCServer - Οδηγός

Ξεκινήστε

1. Ορίστε έναν κωδικό πρόσβασης

Ανοίξτε τις Ρυθμίσεις (εικονίδιο γραναζιού, κάτω γραμμή εργαλείων) και συμπληρώστε το Κωδικός πρόσβασης VNC. Οι τυπικοί πελάτες VNC χρησιμοποιούν την πρόκληση RFB DES, η οποία αναγνωρίζει μόνο τα πρώτα 8 byte συμβατά με ASCII — επιλέξτε κωδικό πρόσβασης έως 8 χαρακτήρες.

2. Εκκινήστε τον διακομιστή

1. Στο κύριο παράθυρο, κάντε κλικ στο Έναρξη. Η ένδειξη κατάστασης αλλάζει σε Σε λειτουργία.
2. Τέσσερις ακροατές ξεκινούν ταυτόχρονα: VNC 5900, έλεγχος QREX 5911, πολυμέσα QREX 4010και το API αρχείων 8766.
3. Κάντε κλικ στο Αντιγραφή πληροφοριών για να αντιγράψετε στο πρόχειρό σας μία γραμμή με τον κεντρικό υπολογιστή, τις θύρες και το τρέχον PIN.

3. Συνδέστε έναν πελάτη

Για ένα τυπικό πρόγραμμα προβολής VNC (Κοινή χρήση οθόνης macOS, RealVNC, TightVNC, εφαρμογές VNC για κινητά):

1. Ανοίξτε το πρόγραμμα προβολής και εισαγάγετε vnc://<your-mac-ip>:5900 ως διεύθυνση
2. Πληκτρολογήστε τον κωδικό πρόσβασης VNC που ορίσατε στο βήμα 1
3. Ελέγξτε αμέσως το Mac σας — πληκτρολόγιο, ποντίκι, αντιγραφή/επικόλληση μέσω RFB

Για την εφαρμογή QuickRemote:

1. Ανοίξτε το QuickRemote στο τηλέφωνο ή το tablet, επιλέξτε Προσθήκη Mac
2. Εισαγάγετε το 6ψήφιο PIN σύζευξης που εμφανίζεται από το DeskVNCServer (ή σαρώστε τον κωδικό QR, εάν η έκδοση QuickRemote που διαθέτετε το υποστηρίζει)
3. Το QuickRemote αποθηκεύει το επιστρεφόμενο διακριτικό Bearer και ξεκλειδώνει τις εκτεταμένες δυνατότητες — IME, ήχο, συγχρονισμό προχείρου και μεταφορά αρχείων

Επισκόπηση διεπαφής

Γραμμή κατάστασης

Κουμπιά ενεργειών

• Έναρξη — Εκκινήστε και τους τέσσερις ακροατές.
• Διακοπή — Κλείστε κάθε ακροατή και αποσυνδέστε τις ενεργές συνεδρίες.
• Αντιγραφή πληροφοριών — Αντιγράψτε στο πρόχειρο μια σύντομη σύνοψη σύνδεσης (κεντρικός υπολογιστής, θύρα VNC, θύρα ελέγχου, PIN) για εύκολη κοινή χρήση με έναν πελάτη.

Πίνακας σύνδεσης

Εμφανίζει τον κεντρικό υπολογιστή δέσμευσης, τις θύρες, το τρέχον ID διακομιστή και το ενεργό PIN σύζευξης. Το κείμενο ανανεώνεται αυτόματα όταν αλλάζουν οι ρυθμίσεις.

Πίνακας API QuickRemote

Σύντομη αναφορά για τα πρωτόκολλα που χρησιμοποιεί ο διακομιστής. Παραθέτει τις υποστηριζόμενες εκδόσεις RFB, τις μορφές τελικών σημείων QREX και το σύνολο εντολών IME, ώστε το QuickRemote (ή ο δικός σας πελάτης) να γνωρίζει τι είναι διαθέσιμο.

Πρωτόκολλα και θύρες

Έλεγχος ταυτότητας

• Πελάτες VNC — Κωδικός RFB DES (τα πρώτα 8 byte συμβατά με ASCII του διαμορφωμένου κωδικού).
• Πελάτες QREX — Αρχική ανταλλαγή PIN 6 ψηφίων στο POST /qr/v1/pair επιστρέφει ένα Bearer token. Κάθε επόμενη κλήση HTTP QREX και πλαίσιο WebSocket πρέπει να περιλαμβάνει Authorization: Bearer <token>.
• Αν ο κωδικός VNC είναι κενός, ο διακομιστής ανακοινώνει την τυπική λειτουργία RFB χωρίς έλεγχο ταυτότητας. Χρήσιμο μόνο για έμπιστα τμήματα LAN.

Σύντομη αναφορά τελικών σημείων QREX

GET  /qr/v1/capabilities    # δημόσιο, επιστρέφει υποστηριζόμενες δυνατότητες
POST /qr/v1/pair            # δημόσιο, ανταλλαγή PIN για Bearer token
GET  /qr/v1/ws              # WebSocket, απαιτείται έλεγχος ταυτότητας
POST /qr/v1/ime/get         # απαιτείται έλεγχος ταυτότητας, ερώτημα ενεργού IME
POST /qr/v1/ime/list        # απαιτείται έλεγχος ταυτότητας, λίστα διαθέσιμων IME
POST /qr/v1/ime/set         # απαιτείται έλεγχος ταυτότητας, εναλλαγή IME
POST /qr/v1/ime/toggle      # απαιτείται έλεγχος ταυτότητας, ενεργοποίηση/απενεργοποίηση IME
POST /qr/v1/ime/commit      # απαιτείται έλεγχος ταυτότητας, υποβολή συμβολοσειράς κειμένου

Ρυθμίσεις

Παραδείγματα πελάτη

Κοινή χρήση οθόνης macOS

1. Finder → Μετάβαση → Σύνδεση σε διακομιστή
2. Πληκτρολογήστε vnc://<your-mac-ip>:5900
3. Εισαγάγετε τον κωδικό VNC

cURL — ανακάλυψη δυνατοτήτων

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

cURL — σύζευξη και κλήση της γέφυρας IME

# 1. Ανταλλάξτε το PIN για ένα 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. Υποβάλετε κείμενο μέσω της γέφυρας IME
curl http://<your-mac-ip>:5911/qr/v1/ime/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from remote"}'

Συμβουλές

• Μειώστε τον ρυθμό καρέ και τις μέγιστες διαστάσεις καρέ όταν βρίσκεστε σε αργή σύνδεση Wi-Fi ή δρομολογείτε τη σύνδεση μέσω VPN.
• Κάντε σύζευξη κάθε συσκευής μία φορά. Μετά την αρχική ανταλλαγή PIN, το Bearer token διατηρείται μετά από επανεκκινήσεις, ώστε το QuickRemote να επανασυνδέεται αθόρυβα.
• Χρησιμοποιήστε Αντιγραφή πληροφοριών ως γρήγορο τρόπο αποστολής στοιχείων σύνδεσης μέσω συνομιλίας ή email — περιλαμβάνει όσα χρειάζεται ένας πελάτης.
• Διατηρήστε το Ενεργοποίηση τροποποιήσεων αρχείων απενεργοποιημένο, εκτός αν χρειάζεστε πραγματικά αποστολές. Η λειτουργία μόνο για ανάγνωση αρκεί για περιήγηση σε στιγμιότυπα οθόνης, σημειώσεις ή λήψεις.
• Απενεργοποιήστε το API ήχου όταν δεν το χρησιμοποιείτε. Οι αδρανείς κωδικοποιητές εξακολουθούν να καταναλώνουν μικρή ποσότητα CPU στη διαδρομή κωδικοποίησης.

Αντιμετώπιση προβλημάτων

Ο διακομιστής δεν ξεκινά

• Κάποιος άλλος διακομιστής VNC (π.χ. η Κοινή χρήση οθόνης macOS) ίσως χρησιμοποιεί ήδη τη θύρα 5900. Σταματήστε τον από Ρυθμίσεις συστήματος → Γενικά → Κοινή χρήση ή αλλάξτε τη θύρα στις ρυθμίσεις του DeskVNCServer.
• Οι θύρες 5911 / 4010 / 8766 πρέπει όλες να είναι ελεύθερες. Ελέγξτε με lsof -i :5911 και παρόμοιες εντολές.

Η επαλήθευση ταυτότητας αποτυγχάνει στους πελάτες VNC

• Βεβαιωθείτε ότι ο κωδικός έχει το πολύ 8 byte συμβατά με ASCII. Οι χαρακτήρες πολλών byte ή οι μεγαλύτερες συμβολοσειρές περικόπτονται σιωπηρά από τον έλεγχο ταυτότητας RFB DES.
• Αν θέλετε σκόπιμα να μη χρησιμοποιείτε κωδικό, αφήστε το πεδίο κενό και συνδεθείτε με πρόγραμμα προβολής που υποστηρίζει VNC χωρίς έλεγχο ταυτότητας.

Το QuickRemote δεν μπορεί να κάνει σύζευξη

• Επιβεβαιώστε ότι το τηλέφωνο ή το tablet βρίσκεται στο ίδιο Wi-Fi με το Mac.
• Ανοίξτε τον πίνακα Σύνδεση και διαβάστε ξανά το PIN. Το PIN μπορεί να δημιουργηθεί ξανά από τις Ρυθμίσεις.
• Ελέγξτε τις ρυθμίσεις τείχους προστασίας του macOS — πρέπει να επιτρέπονται εισερχόμενες συνδέσεις στις θύρες QREX.

Ο απομακρυσμένος έλεγχος έχει καθυστέρηση

• Μειώστε τον ρυθμό καρέ και τις μέγιστες διαστάσεις καρέ στις Ρυθμίσεις.
• Απενεργοποιήστε δυνατότητες που δεν χρησιμοποιείτε (ήχος, πρόχειρο, IME) για να ελευθερώσετε CPU.

Τα αρχεία δεν μεταφέρονται

• Επιβεβαιώστε ότι Ενεργοποίηση μεταφοράς αρχείων είναι ενεργοποιημένο. Οι λίστες μόνο για ανάγνωση λειτουργούν χωρίς Ενεργοποίηση τροποποιήσεων αρχείων.
• Αν αποτυγχάνουν οι αποστολές, ενεργοποιήστε επίσης το Ενεργοποίηση τροποποιήσεων αρχείων. Διαφορετικά, το API αρχείων απαντά μόνο σε αιτήματα ανάγνωσης.

Απόρρητο

• Όλες οι συνεδρίες εκτελούνται απευθείας μεταξύ του πελάτη και του Mac σας. Δεν υπάρχει διαμεσολάβηση cloud, τηλεμετρία ή ανάλυση δεδομένων.
• Ο κωδικός VNC, το Bearer token QREX, το PIN σύζευξης και το σταθερό ID διακομιστή αποθηκεύονται μόνο στις τοπικές ρυθμίσεις της εφαρμογής.
• Οι τροποποιήσεις αρχείων είναι απενεργοποιημένες από προεπιλογή. Οι απομακρυσμένοι πελάτες μπορούν μόνο να διαβάζουν μέχρι να παραχωρήσετε ρητά πρόσβαση εγγραφής.
• Απενεργοποιήστε οποιαδήποτε επέκταση (ήχος, πρόχειρο, μεταφορά αρχείων, IME, απομακρυσμένη είσοδος) ανά πάσα στιγμή για να ανακαλέσετε αμέσως αυτή τη δυνατότητα.
• Αν θέλετε να διατηρήσετε τον διακομιστή τοπικό στο Mac σας, ορίστε τη διεύθυνση δέσμευσης σε 127.0.0.1.