On-Premises

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

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

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

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

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

Χρειάζεστε και τον πίνακα ελέγχου στους δικούς σας διακομιστές; Μιλήστε μαζί μας

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

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

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

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

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

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

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

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

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

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

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

cd C:\hopsignal
for /f %i in ('powershell -NoProfile -Command "[guid]::NewGuid().ToString('N')"') do @(setx /M FEDPWD %i >nul & set FEDPWD=%i)
hopsignal.exe --ADDR 0.0.0.0:80 --FEDLIST fedlist.txt --FEDADDR 127.0.0.1:82 --LOGFILE hs.log

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

Επιτρέψτε τη θύρα στο Τείχος προστασίας των 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 --FEDLIST C:\hopsignal\fedlist.txt --FEDADDR 127.0.0.1:82 --LOGFILE C:\hopsignal\hs.log"
schtasks /Run /TN HopSignal

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

Η εικόνα hoptodesk/hopsignal εκτελεί τον ίδιο διακομιστή σηματοδότησης σε hosts Intel, AMD και ARM. Ξεκινήστε την με τα συνιστώμενα όρια:

docker run -d --name hopsignal --restart unless-stopped -p 80:80 \
  -e HS_MAX_MESSAGE_KB=64 -e HS_QUEUE_LIMIT=256 -e HS_MAX_CONNS=20000 \
  -e HS_CONNS_PER_IP=100 -e HS_LOOKUPS_PER_IP=20 \
  -e HS_IDLE_TIMEOUT=300 -e HS_UPGRADE_TIMEOUT=10 \
  hoptodesk/hopsignal

Κάθε τιμή HS_ ενεργοποιεί ένα όριο: μέγεθος μηνύματος σε KB, μηνύματα σε αναμονή ανά σύνδεση, ανοικτές συνδέσεις, νέες συνδέσεις και αναζητήσεις ανά διεύθυνση το δευτερόλεπτο, δευτερόλεπτα αδράνειας και δευτερόλεπτα χειραψίας. Αν παραλείψετε μια τιμή, το όριο αυτό μένει ανενεργό.

Για να συνδέσετε αυτόματα το container με τον λογαριασμό σας στον πίνακα ελέγχου, χρησιμοποιήστε την εντολή Docker από το Set up a private network στον πίνακα ελέγχου. Προσθέτει HS_SETUP_TOKEN και HS_DASHBOARD_URL, και ο διακομιστής αναφέρει τη διεύθυνσή του μία φορά, στην πρώτη εκκίνηση.

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

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

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

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

netstat -an | find ":80 "

Με Docker, ελέγξτε το container και το αρχείο καταγραφής του:

docker ps --filter name=hopsignal
docker logs hopsignal

Από οποιονδήποτε υπολογιστή, δοκιμάστε τη θύρα 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. Η λίστα turnservers περιέχει έναν ή περισσότερους αναμεταδότες. Ορίστε το πρωτόκολλο σε turn για απλή σύνδεση ή σε turn-tls για σύνδεση TLS. Αφήστε τα κλειδιά έκδοσης όπως είναι.

Γράψτε κάθε αριθμό θύρας μέσα σε εισαγωγικά, όπως στο παραπάνω παράδειγμα. Η εφαρμογή αγνοεί μια θύρα γραμμένη ως απλό αριθμό.

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

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

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

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

Επιλογή 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 (Default).

Σε Android και iOS, ανοίξτε τις Ρυθμίσεις, απενεργοποιήστε το Use HopToDesk Network στην ενότητα Δίκτυο και μετά εισαγάγετε το URL του αρχείου σας. Τα τηλέφωνα που διαχειρίζονται μέσω EMM μπορούν να λάβουν το ίδιο URL μέσω της διαχειριζόμενης ρύθμισης custom_api_url.

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

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

Νέος διακομιστής: στον πίνακα ελέγχου, ανοίξτε Ρυθμίσεις, Network Settings, Set up a private network. Επιλέξτε In my AWS account ή On my own server. Ο διακομιστής αναφέρει τη διεύθυνσή του όταν ξεκινά, και κάθε συνδεδεμένη συσκευή λαμβάνει τις ρυθμίσεις. Τίποτα για πληκτρολόγηση.

Διακομιστής που ήδη λειτουργείτε: εισαγάγετε τις ρυθμίσεις του με το χέρι.

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:

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

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

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