On-Premises

Πώς λειτουργεί

Το HopToDesk χρησιμοποιεί δύο είδη διακομιστών. Ο διακομιστής σηματοδότησης βοηθά τις συσκευές να βρουν η μία την άλλη και να ξεκινήσουν μια συνεδρία. Ο αναμεταδότης TURN μεταφέρει την κίνηση της συνεδρίας μόνο όταν δεν είναι δυνατή απευθείας σύνδεση μεταξύ των δύο συσκευών.

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

Ο εγκαταστάτης αυτής της σελίδας ρυθμίζει τον διακομιστή σηματοδότησης. Η κίνηση αναμετάδοσης περνά από προεπιλογή μέσω του αναμεταδότη της HopToDesk, ή μέσω του δικού σας διακομιστή TURN αν δώσετε έναν.

Ο πίνακας ελέγχου παραμένει φιλοξενούμενη υπηρεσία. Οι συσκευές σε αυτο-φιλοξενούμενο δίκτυο μπορούν ακόμη να συνδεθούν με αυτόν για διαχείριση, και ο πίνακας ελέγχου μπορεί να τους στείλει τις ρυθμίσεις δικτύου.

Πριν ξεκινήσετε

• Ένας διακομιστής με Ubuntu 18.04 έως 24.04, ή ένας διακομιστής Windows.
• Πρόσβαση root ή sudo σε αυτόν τον διακομιστή.
• Μια διεύθυνση IP ή ένα όνομα κεντρικού υπολογιστή που μπορούν να προσεγγίσουν όλες οι συσκευές σας. Για ένα δίκτυο που δεν βγαίνει ποτέ από το LAN σας, αρκεί μια ιδιωτική διεύθυνση.
• Θύρα TCP 80 ανοιχτή στο τείχος προστασίας του διακομιστή για τις συσκευές σας.
• Αν θέλετε δικό σας αναμεταδότη: τον κεντρικό υπολογιστή, τη θύρα, το όνομα χρήστη και τον κωδικό του διακομιστή TURN σας.

Βήμα 1: Εγκαταστήστε τον διακομιστή σηματοδότησης σε Linux

1. Συνδεθείτε στον διακομιστή ως root, ή ως χρήστης με δικαιώματα sudo.
2. Στην κορυφή αυτής της σελίδας επιλέξτε LAN + Default Relay ή Custom TURN Server. Η εντολή εγκατάστασης αλλάζει ανάλογα με την επιλογή σας.
3. Κάντε κλικ στο Copy, επικολλήστε την εντολή στο τερματικό και πατήστε Enter.
4. Περιμένετε μέχρι να ολοκληρωθεί το σενάριο. Σε έναν νέο διακομιστή, η εγκατάσταση των πακέτων μπορεί να πάρει λίγα λεπτά.
5. Στο τέλος το σενάριο εμφανίζει HopSignal Setup Complete, ακολουθούμενο από τη διεύθυνση του διακομιστή σας και ένα έτοιμο μπλοκ ρυθμίσεων δικτύου. Κρατήστε αυτή την έξοδο, θα τη χρειαστείτε στο βήμα 3.

cd /home && curl -o hsinstall.sh -sL https://www.hoptodesk.com/hs/hsinstall && sh hsinstall.sh

Με δικό σας διακομιστή TURN, προσθέστε τις τέσσερις τιμές του στο τέλος της εντολής με αυτή τη σειρά: κεντρικός υπολογιστής, θύρα, όνομα χρήστη, κωδικός.

sh hsinstall.sh turn.example.com 443 myuser mypassword

Τι κάνει το σενάριο

• Εγκαθιστά με apt τα εργαλεία μεταγλώττισης και τις βιβλιοθήκες OpenSSL που χρειάζεται.
• Κατεβάζει το εκτελέσιμο του διακομιστή σηματοδότησης στον φάκελο /home/hopsignal.
• Δημιουργεί μια υπηρεσία systemd με όνομα hopsignal και την ξεκινά σε κάθε εκκίνηση.
• Προσθέτει έναν επόπτη cron που επανεκκινεί την υπηρεσία αν σταματήσει να αποκρίνεται, και περιστρέφει το αρχείο καταγραφής όταν ξεπεράσει τα 100 MB.
• Ανοίγει τη θύρα TCP 80 στο ufw όταν το ufw είναι ενεργό.

Βήμα 1 σε Windows: Εκτελέστε τον διακομιστή σηματοδότησης

1. Γυρίστε τον διακόπτη OS στην κορυφή αυτής της σελίδας σε Windows και κάντε κλικ στο Download. Λαμβάνετε ένα μόνο αρχείο με όνομα hopsignal.exe.
2. Δημιουργήστε έναν φάκελο όπως C:\hopsignal και μετακινήστε το hopsignal.exe μέσα του.
3. Στον ίδιο φάκελο, δημιουργήστε ένα κενό αρχείο κειμένου με όνομα fedlist.txt.
4. Η έκδοση για Windows αναμένει επίσης ένα πιστοποιητικό TLS και το ιδιωτικό του κλειδί σε μορφή PEM. Οποιοδήποτε ζεύγος λειτουργεί, ακόμη και αυτο-υπογεγραμμένο. Αποθηκεύστε τα ως cert.pem και key.pem στον ίδιο φάκελο.
5. Ανοίξτε μια Γραμμή εντολών ως διαχειριστής και ξεκινήστε τον διακομιστή.

cd C:\hopsignal
hopsignal.exe --ADDR 0.0.0.0:80 --WSS_ADDR 0.0.0.0:443 --CERT cert.pem --KEY key.pem --FEDLIST fedlist.txt --FEDADDR 127.0.0.1:82 --FEDPWD 123456789 --LOGFILE hs.log

Αν έχετε OpenSSL, αυτή η εντολή δημιουργεί ένα αυτο-υπογεγραμμένο ζεύγος πιστοποιητικού:

openssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 3650 -subj "/CN=hopsignal"

Επιτρέψτε τη θύρα στο Τείχος προστασίας των Windows:

netsh advfirewall firewall add rule name="HopSignal" dir=in action=allow protocol=TCP localport=80

Για να συνεχίσει ο διακομιστής να εκτελείται μετά από επανεκκίνηση, καταχωρίστε τον ως προγραμματισμένη εργασία που ξεκινά κατά την εκκίνηση με τον λογαριασμό SYSTEM:

schtasks /Create /TN HopSignal /SC ONSTART /RU SYSTEM /TR "C:\hopsignal\hopsignal.exe --ADDR 0.0.0.0:80 --WSS_ADDR 0.0.0.0:443 --CERT C:\hopsignal\cert.pem --KEY C:\hopsignal\key.pem --FEDLIST C:\hopsignal\fedlist.txt --FEDADDR 127.0.0.1:82 --FEDPWD 123456789 --LOGFILE C:\hopsignal\hs.log"
schtasks /Run /TN HopSignal

Βήμα 2: Ελέγξτε ότι ο διακομιστής εκτελείται

Σε Linux, ελέγξτε την υπηρεσία και το αρχείο καταγραφής:

sudo systemctl status hopsignal
tail /home/hopsignal/hs.log

Σε Windows, επιβεβαιώστε ότι η θύρα ακούει:

netstat -an | find ":80 "

Από οποιονδήποτε υπολογιστή, δοκιμάστε τη θύρα WebSocket. Αντικαταστήστε το SERVER_IP με τη διεύθυνση του διακομιστή σας. Ένας υγιής διακομιστής απαντά HTTP/1.1 101 Switching Protocols.

curl -i -N -m 5 -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" http://SERVER_IP:80/

Βήμα 3: Κατευθύνετε τις συσκευές σας στον διακομιστή

Κάθε συσκευή διαβάζει τις ρυθμίσεις δικτύου της από ένα μικρό έγγραφο JSON. Είναι το μπλοκ που εμφάνισε ο εγκαταστάτης στο τέλος του βήματος 1. Αντικαταστήστε το SERVER_IP με τη διεύθυνση του διακομιστή σας και συμπληρώστε το μπλοκ TURN αν λειτουργείτε δικό σας αναμεταδότη.

{
  "turnservers": [
    {
      "protocol": "turn",
      "host": "turn.hoptodesk.com",
      "port": "443",
      "username": "hoptodesk",
      "password": "hoptodesk1234"
    }
  ],
  "rendezvous": {
    "host": "SERVER_IP",
    "port": "80"
  },
  "winversion": "1.0.0",
  "macversion": "1.0.0",
  "linuxversion": "1.0.0",
  "none": "none"
}

Το μπλοκ rendezvous είναι ο διακομιστής σηματοδότησής σας. Χρησιμοποιήστε το κλειδί rendezvousssl αντί για rendezvous όταν ο διακομιστής προσεγγίζεται μέσω TLS, για παράδειγμα ένας Cloudflare Worker ή μια ανάπτυξη σε AWS. Η λίστα turnservers περιέχει έναν ή περισσότερους αναμεταδότες. Ορίστε το πρωτόκολλο σε turn για απλή σύνδεση ή σε turn-tls για σύνδεση TLS. Αφήστε τα κλειδιά έκδοσης όπως είναι.

Υπάρχουν τρεις τρόποι να δώσετε αυτό το έγγραφο στις συσκευές σας. Διαλέξτε αυτόν που ταιριάζει στη δική σας εγκατάσταση.

Επιλογή A: Τοποθετήστε ένα αρχείο api.json σε κάθε συσκευή

Αποθηκεύστε το έγγραφο ως αρχείο με όνομα api.json στον φάκελο ρυθμίσεων του HopToDesk και έπειτα επανεκκινήστε το HopToDesk. Η εφαρμογή διαβάζει το αρχείο κατά την εκκίνηση και δεν επικοινωνεί πια με το API του HopToDesk.

Σε Linux η υπηρεσία παρασκηνίου εκτελείται ως root και διαβάζει το αρχείο κάτω από το /root, ενώ η εφαρμογή που ανοίγετε διαβάζει το αρχείο στον δικό σας προσωπικό φάκελο. Βάλτε ένα αντίγραφο και στα δύο σημεία.

Επιλογή B: Φιλοξενήστε το αρχείο σε ένα URL και επιλέξτε το στην εφαρμογή

1. Ανεβάστε το api.json σε οποιονδήποτε διακομιστή web μπορούν να προσεγγίσουν οι συσκευές σας. Συνιστάται HTTPS.
2. Στο HopToDesk, κάντε κλικ στο εικονίδιο του γραναζιού για να ανοίξετε τις ρυθμίσεις.
3. Στο Network, κάντε κλικ στο Choose Network.
4. Επιλέξτε Custom Network Settings, επικολλήστε το URL του αρχείου σας και επιβεβαιώστε.
5. Το HopToDesk κατεβάζει το αρχείο, ελέγχει ότι περιέχει έγκυρη καταχώριση rendezvous και λίστα turnservers, και έπειτα επανασυνδέεται μέσω του διακομιστή σας.

Για να επιστρέψετε στο δημόσιο δίκτυο, ανοίξτε ξανά το Choose Network και επιλέξτε HopToDesk Network.

Επιλογή C: Στείλτε τις ρυθμίσεις από τον πίνακα ελέγχου

Αν οι συσκευές σας είναι συνδεδεμένες με τον πίνακα ελέγχου του HopToDesk, μπορείτε να ορίσετε το δίκτυο μία φορά για ολόκληρο τον λογαριασμό. Ένας προσαρμοσμένος πελάτης που δημιουργήθηκε από τον πίνακα ελέγχου περιλαμβάνει ήδη αυτές τις ρυθμίσεις.

1. Συνδεθείτε στον πίνακα ελέγχου ως κάτοχος ή διαχειριστής και ανοίξτε τις ρυθμίσεις.
2. Στο Network Settings, επιλέξτε Custom Network.
3. Εισαγάγετε τον κεντρικό υπολογιστή του διακομιστή σηματοδότησης, τη θύρα του και WS ως πρωτόκολλο. Προσθέστε έναν διακομιστή TURN αν λειτουργείτε δικό σας αναμεταδότη, ή αφήστε το κενό για να διατηρήσετε τον αναμεταδότη της HopToDesk.
4. Κάντε κλικ στο Save Network Settings. Κάθε συνδεδεμένη συσκευή λαμβάνει τις νέες ρυθμίσεις και τις εφαρμόζει χωρίς επανεγκατάσταση.

Λειτουργήστε δικό σας αναμεταδότη TURN (προαιρετικό)

Οι συνεδρίες που δεν μπορούν να συνδεθούν απευθείας περνούν από προεπιλογή μέσω του αναμεταδότη της HopToDesk. Για να κρατήσετε όλη την κίνηση στη δική σας υποδομή, λειτουργήστε έναν διακομιστή TURN. Οποιοσδήποτε τυπικός διακομιστής TURN λειτουργεί, και το coturn είναι συνηθισμένη επιλογή σε Linux.

1. Εγκαταστήστε το coturn στον διακομιστή αναμετάδοσης.

sudo apt install coturn

2. Επεξεργαστείτε το /etc/turnserver.conf και ορίστε τουλάχιστον τις παρακάτω τιμές. Αντικαταστήστε το realm, τα διαπιστευτήρια και τη δημόσια IP με τα δικά σας.

listening-port=443
fingerprint
lt-cred-mech
user=myuser:mypassword
realm=example.com
external-ip=PUBLIC_IP

3. Αν το /etc/default/coturn περιέχει γραμμή TURNSERVER_ENABLED, αφαιρέστε το σχόλιο. Έπειτα ενεργοποιήστε και ξεκινήστε την υπηρεσία.

sudo systemctl enable --now coturn
sudo systemctl restart coturn

4. Ανοίξτε στο τείχος προστασίας του αναμεταδότη τη θύρα ακρόασης για TCP και UDP, καθώς και το εύρος αναμετάδοσης UDP 49152 έως 65535.
5. Δώστε τον αναμεταδότη στις συσκευές σας: εκτελέστε ξανά τον εγκαταστάτη με τις τέσσερις τιμές TURN, ή επεξεργαστείτε το μπλοκ turnservers στις ρυθμίσεις δικτύου σας. Χρησιμοποιήστε turn-tls ως πρωτόκολλο αν ο αναμεταδότης σας τερματίζει TLS.

Διαχείριση του διακομιστή σε Linux

sudo systemctl status hopsignal
sudo systemctl restart hopsignal
sudo systemctl stop hopsignal
tail -f /home/hopsignal/hs.log

Για να ενημερώσετε τον διακομιστή, σταματήστε την υπηρεσία και εκτελέστε ξανά την εντολή εγκατάστασης. Κατεβάζει το τρέχον εκτελέσιμο και ξαναγράφει την υπηρεσία.

Για να αφαιρέσετε τον διακομιστή μαζί με την υπηρεσία και τις καταχωρίσεις cron:

cd /home && curl -o hsinstall.sh -sL https://www.hoptodesk.com/hs/hsinstall && sh hsinstall.sh remove

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

• Το ID μένει στο Generating, ή η εφαρμογή προσπαθεί συνεχώς να συνδεθεί στο δίκτυο: η συσκευή δεν μπορεί να προσεγγίσει τον διακομιστή σηματοδότησης. Ελέγξτε ότι η υπηρεσία εκτελείται, ότι η θύρα 80 είναι ανοιχτή και ότι η διεύθυνση στις ρυθμίσεις δικτύου σας είναι σωστή.
• Οι συσκευές συνδέονται στο LAN αλλά όχι από έξω: ο αναμεταδότης δεν είναι προσβάσιμος. Με τον προεπιλεγμένο αναμεταδότη, οι συσκευές χρειάζονται εξερχόμενη πρόσβαση στο turn.hoptodesk.com στη θύρα 443. Με δικό σας αναμεταδότη, ελέγξτε τους κανόνες του τείχους προστασίας και τα διαπιστευτήρια.
• Η εφαρμογή αγνοεί το api.json: βεβαιωθείτε ότι το αρχείο είναι έγκυρο JSON χωρίς κόμματα στο τέλος, ότι βρίσκεται στον σωστό φάκελο και ότι επανεκκινήσατε το HopToDesk. Το αρχείο καταγραφής της εφαρμογής περιέχει τη γραμμή Loaded local api.json όταν το αρχείο έχει φορτωθεί.
• Η θύρα 82 είναι η θύρα ομοσπονδίας για τη σύνδεση πολλών δικών σας διακομιστών σηματοδότησης. Κρατήστε την κλειστή προς το διαδίκτυο.
• Ο διακομιστής σηματοδότησης δεν αποθηκεύει δεδομένα συνεδρίας. Αν κάτι φαίνεται κολλημένο, επανεκκινήστε την υπηρεσία. Οι συσκευές επανασυνδέονται μόνες τους μέσα σε περίπου ένα λεπτό.