On-premises

Så fungerar det

HopToDesk använder två slags servrar. Signalservern hjälper enheter att hitta varandra och sätta upp en session. TURN-reläet bär sessionstrafiken bara när en direkt anslutning mellan de två enheterna inte är möjlig.

Sessioner är krypterade från ände till ände, så ingen av servrarna kan läsa din skärm, dina filer eller din chatt. Signalservern ser bara enhets-ID:n och anslutningsförfrågningar.

Installationsprogrammet på den här sidan sätter upp signalservern. Relätrafik går som standard via HopToDesks relä, eller via din egen TURN-server om du anger en.

Enheter i ett självhostat nätverk kan fortfarande länkas till panelen för hantering, och panelen kan skicka nätverksinställningarna till dem.

Behöver du panelen på dina egna servrar också? Prata med oss

Innan du börjar

• En 64-bitars Linux-server med systemd, till exempel Ubuntu eller Debian, eller en Windows-server.
• Root- eller sudo-åtkomst på den servern.
• En IP-adress eller ett värdnamn som alla dina enheter kan nå. För ett nätverk som aldrig lämnar ditt LAN räcker en privat adress.
• TCP-port 80 öppen i serverns brandvägg för dina enheter.
• Om du vill ha ett eget relä: värd, port, användarnamn och lösenord för din TURN-server.

Steg 1: Installera signalservern på Linux

1. Logga in på servern som root, eller som en användare med sudo-rättigheter.
2. Välj LAN + Default Relay eller Custom TURN Server högst upp på den här sidan. Installationskommandot ändras med ditt val.
3. Klicka på Copy, klistra in kommandot i terminalen och tryck på Enter.
4. Vänta tills skriptet är klart. Det tar mindre än en minut.
5. I slutet skriver skriptet ut HopSignal Setup Complete, följt av din serveradress och ett färdigt block med nätverksinställningar. Spara den utskriften, du behöver den i steg 3.

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

Med en egen TURN-server lägger du till dess fyra värden i slutet av kommandot i den här ordningen: värd, port, användarnamn, lösenord.

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

Vad skriptet gör

• Laddar ned signalservern för din processor, Intel, AMD eller ARM, till mappen /home/hopsignal.
• Kontrollerar nedladdningen mot den publicerade SHA256SUMS-listan och stannar utan ändringar om den inte stämmer.
• Skapar en systemd-tjänst med namnet hopsignal och startar den vid varje uppstart.
• Startar servern med de rekommenderade anslutningsgränserna och ett slumpmässigt federationslösenord, sparat i /home/hopsignal/hopsignal.env med åtkomst endast för root.
• Lägger till en cron-vakthund som startar om tjänsten om den slutar svara, och roterar loggen när den växer förbi 100 MB.
• Öppnar TCP-port 80 i ufw när ufw är aktivt.

Steg 1 på Windows: Kör signalservern

1. Ställ OS-reglaget högst upp på den här sidan på Windows och klicka på Download. Du får en enda fil med namnet hopsignal.exe.
2. Skapa en mapp som C:\hopsignal och flytta hopsignal.exe dit.
3. Skapa en tom textfil med namnet fedlist.txt i samma mapp.
4. Öppna en kommandotolk som administratör och starta servern.

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

Den andra raden sparar ett slumpmässigt federationslösenord som en systeminställning i Windows, så det syns aldrig på serverns kommandorad.

Tillåt porten i Windows-brandväggen:

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

För att servern ska fortsätta köras efter en omstart registrerar du den som en schemalagd uppgift som startar vid uppstart under SYSTEM-kontot:

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

Steg 1 med Docker: Kör signalservern i en container

Imagen hoptodesk/hopsignal kör samma signalserver på Intel-, AMD- och ARM-värdar. Starta den med de rekommenderade gränserna:

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

Varje HS_-värde slår på en gräns: meddelandestorlek i KB, köade meddelanden per anslutning, öppna anslutningar, nya anslutningar och uppslagningar per adress och sekund, sekunder utan aktivitet och sekunder för handskakning. Utelämnar du ett värde förblir den gränsen av.

För att koppla containern till ditt panelkonto automatiskt använder du Docker-kommandot från Set up a private network i panelen. Det lägger till HS_SETUP_TOKEN och HS_DASHBOARD_URL, och servern anmäler sin adress en gång, vid första starten.

Steg 2: Kontrollera att servern körs

På Linux, kontrollera tjänsten och loggen:

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

På Windows, bekräfta att porten lyssnar:

netstat -an | find ":80 "

Med Docker kontrollerar du containern och dess logg:

docker ps --filter name=hopsignal
docker logs hopsignal

Testa WebSocket-porten från valfri dator. Ersätt SERVER_IP med din serveradress. En frisk server svarar 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/

Steg 3: Peka dina enheter mot servern

Varje enhet läser sina nätverksinställningar från ett litet JSON-dokument. Det är blocket som installationsprogrammet skrev ut i slutet av steg 1. Ersätt SERVER_IP med din serveradress och fyll i TURN-blocket om du kör ett eget relä.

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

Blocket rendezvous är din signalserver. Använd nyckeln rendezvousssl i stället för rendezvous när servern nås via TLS, till exempel en Cloudflare Worker. Listan turnservers innehåller ett eller flera reläer. Sätt protokollet till turn för en vanlig anslutning eller till turn-tls för en TLS-anslutning. Lämna versionsnycklarna som de är.

Skriv varje portnummer inom citattecken, som i exemplet ovan. Appen ignorerar en port som skrivs som ett vanligt tal.

Det finns tre sätt att ge det här dokumentet till dina enheter. Välj det som passar din uppsättning.

Alternativ A: Lägg en api.json-fil på varje enhet

Spara dokumentet som en fil med namnet api.json i HopToDesks konfigurationsmapp och starta sedan om HopToDesk. Appen läser filen vid start och kontaktar inte längre HopToDesks API.

På Linux lägger du en andra kopia i /root/.config/hoptodesk. Appen använder den kopian på inloggningsskärmen, innan en användare loggar in.

Alternativ B: Publicera filen på en URL och välj den i appen

1. Ladda upp api.json till valfri webbserver som dina enheter kan nå. HTTPS rekommenderas.
2. Klicka på kugghjulsikonen i HopToDesk för att öppna inställningarna.
3. Under Network klickar du på Choose Network.
4. Välj Custom Network Settings, klistra in URL:en till din fil och bekräfta.
5. HopToDesk laddar ner filen, kontrollerar att den innehåller en giltig rendezvous-post och en turnservers-lista, och återansluter sedan via din server.

För att gå tillbaka till det publika nätverket öppnar du Choose Network igen och väljer HopToDesk Network (Default).

På Android och iOS öppnar du Inställningar, stänger av Use HopToDesk Network under Nätverk och anger sedan URL:en till din fil. Telefoner som hanteras via en EMM kan få samma URL genom den hanterade inställningen custom_api_url.

Alternativ C: Skicka inställningarna från panelen

Om dina enheter är länkade till HopToDesk-panelen kan du ställa in nätverket en gång för hela kontot. En anpassad klient som byggts från panelen levereras med de här inställningarna inbyggda.

Ny server: öppna Inställningar, Network Settings, Set up a private network i panelen. Välj In my AWS account eller On my own server. Servern anmäler sin adress när den startar, och varje länkad enhet får inställningarna. Inget att skriva.

En server du redan kör: ange dess inställningar för hand.

1. Logga in i panelen som ägare eller administratör och öppna inställningarna.
2. Under Network Settings väljer du Custom Network.
3. Ange signalserverns värd, dess port och WS som protokoll. Lägg till en TURN-server om du kör ett eget relä, eller lämna tomt för att behålla HopToDesks relä.
4. Klicka på Save Network Settings. Varje länkad enhet får de nya inställningarna och tillämpar dem utan ominstallation.

Kör ett eget TURN-relä (valfritt)

Sessioner som inte kan ansluta direkt går som standard via HopToDesks relä. För att hålla all trafik i din egen infrastruktur kör du en TURN-server. Vilken standard-TURN-server som helst fungerar, och coturn är ett vanligt val på Linux.

1. Installera coturn på reläservern.

sudo apt install coturn

2. Redigera /etc/turnserver.conf och ange minst värdena nedan. Ersätt realm, inloggningsuppgifter och publik IP med dina egna.

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

3. Om /etc/default/coturn innehåller en rad TURNSERVER_ENABLED, avkommentera den. Aktivera sedan tjänsten och starta den.

sudo systemctl enable --now coturn
sudo systemctl restart coturn

4. Öppna lyssningsporten för TCP och UDP, plus UDP-reläintervallet 49152 till 65535, i reläets brandvägg.
5. Ge reläet till dina enheter: kör installationsprogrammet igen med de fyra TURN-värdena, eller redigera blocket turnservers i dina nätverksinställningar. Använd turn-tls som protokoll om ditt relä terminerar TLS.

Hantera servern på Linux

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

För att uppdatera servern stoppar du tjänsten och kör installationskommandot igen. Det laddar ner den aktuella binärfilen och skriver om tjänsten.

För att ta bort servern tillsammans med dess tjänst och cron-poster:

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

Felsökning

• ID:t står kvar på Generating, eller appen försöker hela tiden ansluta till nätverket: enheten når inte signalservern. Kontrollera att tjänsten körs, att port 80 är öppen och att adressen i dina nätverksinställningar stämmer.
• Enheterna ansluter på LAN men inte utifrån: reläet går inte att nå. Med standardreläet behöver enheterna utgående åtkomst till turn.hoptodesk.com på port 443. Med ett eget relä kontrollerar du dess brandväggsregler och inloggningsuppgifter.
• Appen ignorerar api.json: se till att filen är giltig JSON utan avslutande kommatecken, att den ligger i rätt mapp och att du har startat om HopToDesk. Appens logg innehåller raden Loaded local api.json när filen har lästs in.
• Port 82 är federationsporten för att länka flera egna signalservrar. Håll den stängd mot internet.
• Signalservern lagrar inga sessionsdata. Om något verkar ha fastnat, starta om tjänsten. Enheterna återansluter själva inom ungefär en minut.