On-premises

Zo werkt het

HopToDesk gebruikt twee soorten servers. De signaalserver helpt apparaten elkaar te vinden en een sessie op te zetten. De TURN-relay draagt het sessieverkeer alleen als een directe verbinding tussen de twee apparaten niet mogelijk is.

Sessies zijn end-to-end versleuteld, dus geen van beide servers kan uw scherm, bestanden of chat lezen. De signaalserver ziet alleen apparaat-ID's en verbindingsverzoeken.

Het installatieprogramma op deze pagina zet de signaalserver op. Relayverkeer loopt standaard via de HopToDesk-relay, of via uw eigen TURN-server als u er een opgeeft.

Apparaten op een zelfgehost netwerk kunnen nog steeds aan het dashboard worden gekoppeld voor beheer, en het dashboard kan de netwerkinstellingen naar ze sturen.

Wilt u het dashboard ook op uw eigen servers? Praat met ons

Voordat u begint

• Een 64-bit Linux-server met systemd, zoals Ubuntu of Debian, of een Windows-server.
• Root- of sudo-toegang op die server.
• Een IP-adres of hostnaam die al uw apparaten kunnen bereiken. Voor een netwerk dat uw LAN nooit verlaat, is een privéadres genoeg.
• TCP-poort 80 open op de firewall van de server voor uw apparaten.
• Als u een eigen relay wilt: de host, poort, gebruikersnaam en het wachtwoord van uw TURN-server.

Stap 1: De signaalserver installeren op Linux

1. Meld u op de server aan als root, of als gebruiker met sudo-rechten.
2. Kies bovenaan deze pagina LAN + Default Relay of Custom TURN Server. Het installatiecommando verandert met uw keuze.
3. Klik op Copy, plak het commando in de terminal en druk op Enter.
4. Wacht tot het script klaar is. Dit duurt minder dan een minuut.
5. Aan het einde toont het script HopSignal Setup Complete, gevolgd door uw serveradres en een kant-en-klaar blok met netwerkinstellingen. Bewaar die uitvoer, u hebt hem nodig in stap 3.

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

Met uw eigen TURN-server voegt u de vier waarden in deze volgorde toe aan het einde van het commando: host, poort, gebruikersnaam, wachtwoord.

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

Wat het script doet

• Downloadt de signaalserver voor uw processor, Intel, AMD of ARM, naar de map /home/hopsignal.
• Controleert de download aan de hand van de gepubliceerde SHA256SUMS-lijst en stopt zonder wijzigingen als die niet overeenkomt.
• Maakt een systemd-service met de naam hopsignal aan en start die bij elke opstart.
• Start de server met de aanbevolen verbindingslimieten en een willekeurig federatiewachtwoord, opgeslagen in /home/hopsignal/hopsignal.env en alleen leesbaar voor root.
• Voegt een cron-watchdog toe die de service herstart als hij niet meer reageert, en het logbestand roteert zodra het groter wordt dan 100 MB.
• Opent TCP-poort 80 in ufw wanneer ufw actief is.

Stap 1 op Windows: De signaalserver starten

1. Zet de OS-schakelaar bovenaan deze pagina op Windows en klik op Download. U krijgt één bestand met de naam hopsignal.exe.
2. Maak een map zoals C:\hopsignal en verplaats hopsignal.exe daarnaartoe.
3. Maak in dezelfde map een leeg tekstbestand met de naam fedlist.txt.
4. Open een opdrachtprompt als administrator en start de server.

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

De tweede regel slaat een willekeurig federatiewachtwoord op als Windows-systeeminstelling, zodat het nooit in de opdrachtregel van de server staat.

Sta de poort toe in Windows Firewall:

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

Om de server na een herstart te laten doordraaien, registreert u hem als geplande taak die bij het opstarten start onder het SYSTEM-account:

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

Stap 1 met Docker: De signaalserver in een container starten

De image hoptodesk/hopsignal draait dezelfde signaalserver op Intel-, AMD- en ARM-hosts. Start die met de aanbevolen limieten:

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

Elke HS_-waarde zet één limiet aan: berichtgrootte in KB, wachtende berichten per verbinding, open verbindingen, nieuwe verbindingen en opzoekingen per adres per seconde, seconden inactiviteit en seconden voor de handshake. Laat je een waarde weg, dan blijft die limiet uit.

Om de container automatisch aan uw dashboardaccount te koppelen, gebruikt u de Docker-opdracht uit Set up a private network in het dashboard. Die voegt HS_SETUP_TOKEN en HS_DASHBOARD_URL toe, en de server meldt zijn adres één keer, bij de eerste start.

Stap 2: Controleren of de server draait

Controleer op Linux de service en het logbestand:

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

Controleer op Windows of de poort luistert:

netstat -an | find ":80 "

Controleer met Docker de container en het logbestand:

docker ps --filter name=hopsignal
docker logs hopsignal

Test vanaf een willekeurige computer de WebSocket-poort. Vervang SERVER_IP door uw serveradres. Een gezonde server antwoordt met 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/

Stap 3: Uw apparaten naar de server verwijzen

Elk apparaat leest zijn netwerkinstellingen uit een klein JSON-document. Dit is het blok dat het installatieprogramma aan het einde van stap 1 toonde. Vervang SERVER_IP door uw serveradres en vul het TURN-blok in als u een eigen relay draait.

{
  "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"
}

Het blok rendezvous is uw signaalserver. Gebruik de sleutel rendezvousssl in plaats van rendezvous wanneer de server via TLS wordt bereikt, bijvoorbeeld een Cloudflare Worker. De lijst turnservers bevat een of meer relays. Zet het protocol op turn voor een gewone verbinding of op turn-tls voor een TLS-verbinding. Laat de versiesleutels zoals ze zijn.

Zet elk poortnummer tussen aanhalingstekens, zoals in het voorbeeld hierboven. De app negeert een poort die als gewoon getal is geschreven.

Er zijn drie manieren om dit document bij uw apparaten te krijgen. Kies de manier die bij uw situatie past.

Optie A: Zet een api.json-bestand op elk apparaat

Sla het document op als een bestand met de naam api.json in de configuratiemap van HopToDesk en herstart HopToDesk. De app leest het bestand bij het opstarten en neemt geen contact meer op met de HopToDesk-API.

Zet op Linux een tweede kopie in /root/.config/hoptodesk. De app gebruikt die kopie op het aanmeldscherm, voordat een gebruiker zich aanmeldt.

Optie B: Host het bestand op een URL en selecteer die in de app

1. Upload api.json naar een webserver die uw apparaten kunnen bereiken. HTTPS wordt aanbevolen.
2. Klik in HopToDesk op het tandwielpictogram om de instellingen te openen.
3. Klik onder Network op Choose Network.
4. Selecteer Custom Network Settings, plak de URL van uw bestand en bevestig.
5. HopToDesk downloadt het bestand, controleert of het een geldige rendezvous-vermelding en een turnservers-lijst bevat, en maakt daarna opnieuw verbinding via uw server.

Om terug te keren naar het openbare netwerk, opent u Choose Network opnieuw en selecteert u HopToDesk Network (Default).

Open op Android en iOS de Instellingen, zet Use HopToDesk Network uit in het onderdeel Netwerk en voer daarna de URL van uw bestand in. Telefoons die via een EMM worden beheerd, kunnen dezelfde URL ontvangen via de beheerde instelling custom_api_url.

Optie C: Stuur de instellingen vanuit het dashboard

Als uw apparaten aan het HopToDesk-dashboard zijn gekoppeld, kunt u het netwerk één keer voor het hele account instellen. Een aangepaste client die vanuit het dashboard is gebouwd, heeft deze instellingen al ingebouwd.

Nieuwe server: open in het dashboard Instellingen, Network Settings, Set up a private network. Kies In my AWS account of On my own server. De server meldt zijn adres bij het starten en elk gekoppeld apparaat krijgt de instellingen. Niets te typen.

Een server die u al draait: voer de instellingen met de hand in.

1. Meld u aan bij het dashboard als eigenaar of beheerder en open de instellingen.
2. Selecteer onder Network Settings de optie Custom Network.
3. Voer de host van de signaalserver in, de poort en WS als protocol. Voeg een TURN-server toe als u een eigen relay draait, of laat het leeg om de HopToDesk-relay te behouden.
4. Klik op Save Network Settings. Elk gekoppeld apparaat ontvangt de nieuwe instellingen en past ze toe zonder herinstallatie.

Uw eigen TURN-relay draaien (optioneel)

Sessies die geen directe verbinding kunnen maken, lopen standaard via de HopToDesk-relay. Om al het verkeer op uw eigen infrastructuur te houden, draait u een TURN-server. Elke standaard TURN-server werkt, en coturn is een gangbare keuze op Linux.

1. Installeer coturn op de relayserver.

sudo apt install coturn

2. Bewerk /etc/turnserver.conf en stel minimaal de onderstaande waarden in. Vervang de realm, de inloggegevens en het publieke IP door uw eigen gegevens.

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

3. Als /etc/default/coturn een regel TURNSERVER_ENABLED bevat, haal dan het commentaarteken weg. Schakel daarna de service in en start hem.

sudo systemctl enable --now coturn
sudo systemctl restart coturn

4. Open op de firewall van de relay de luisterpoort voor TCP en UDP, plus het UDP-relaybereik 49152 tot 65535.
5. Geef de relay door aan uw apparaten: voer het installatieprogramma opnieuw uit met de vier TURN-waarden, of bewerk het blok turnservers in uw netwerkinstellingen. Gebruik turn-tls als protocol als uw relay TLS afhandelt.

De server beheren op Linux

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

Om de server bij te werken, stopt u de service en voert u het installatiecommando opnieuw uit. Het downloadt het actuele binaire bestand en schrijft de service opnieuw.

Om de server samen met de service en de cron-regels te verwijderen:

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

Problemen oplossen

• Het ID blijft op Generating staan, of de app blijft verbinding met het netwerk zoeken: het apparaat kan de signaalserver niet bereiken. Controleer of de service draait, of poort 80 open is en of het adres in uw netwerkinstellingen klopt.
• Apparaten verbinden wel op het LAN maar niet van buitenaf: de relay is niet bereikbaar. Met de standaardrelay hebben apparaten uitgaande toegang nodig tot turn.hoptodesk.com op poort 443. Met uw eigen relay controleert u de firewallregels en de inloggegevens.
• De app negeert api.json: controleer of het bestand geldige JSON is zonder afsluitende komma's, of het in de juiste map staat en of u HopToDesk hebt herstart. Het app-logbestand bevat de regel Loaded local api.json wanneer het bestand is ingelezen.
• Poort 82 is de federatiepoort om meerdere eigen signaalservers te koppelen. Houd hem gesloten voor internet.
• De signaalserver slaat geen sessiegegevens op. Als iets vast lijkt te zitten, herstart dan de service. Apparaten maken binnen ongeveer een minuut vanzelf opnieuw verbinding.