On-premises

Slik fungerer det

HopToDesk bruker to typer servere. Signalserveren hjelper enheter med å finne hverandre og sette opp en økt. TURN-reléet bærer økttrafikken bare når en direkte forbindelse mellom de to enhetene ikke er mulig.

Økter er ende-til-ende-kryptert, så ingen av serverne kan lese skjermen, filene eller chatten din. Signalserveren ser bare enhets-ID-er og tilkoblingsforespørsler.

Installasjonsprogrammet på denne siden setter opp signalserveren. Relétrafikk går som standard via HopToDesk-reléet, eller via din egen TURN-server hvis du oppgir en.

Dashbordet forblir en driftet tjeneste. Enheter i et selvdriftet nettverk kan fortsatt kobles til det for administrasjon, og dashbordet kan sende nettverksinnstillingene til dem.

Før du begynner

• En server som kjører Ubuntu 18.04 til 24.04, eller en Windows-server.
• Root- eller sudo-tilgang på den serveren.
• En IP-adresse eller et vertsnavn som alle enhetene dine kan nå. For et nettverk som aldri forlater LAN-et ditt, holder det med en privat adresse.
• TCP-port 80 åpen i serverens brannmur for enhetene dine.
• Hvis du vil ha ditt eget relé: vert, port, brukernavn og passord for TURN-serveren din.

Trinn 1: Installer signalserveren på Linux

1. Logg inn på serveren som root, eller som en bruker med sudo-rettigheter.
2. Øverst på denne siden velger du LAN + Default Relay eller Custom TURN Server. Installasjonskommandoen endres etter valget ditt.
3. Klikk på Copy, lim inn kommandoen i terminalen og trykk Enter.
4. Vent til skriptet er ferdig. På en ny server kan installasjonen av pakkene ta noen minutter.
5. Til slutt skriver skriptet ut HopSignal Setup Complete, etterfulgt av serveradressen din og en ferdig blokk med nettverksinnstillinger. Ta vare på den utskriften, du trenger den i trinn 3.

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

Med din egen TURN-server legger du til de fire verdiene på slutten av kommandoen i denne rekkefølgen: vert, port, brukernavn, passord.

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

Hva skriptet gjør

• Installerer byggverktøyene og OpenSSL-bibliotekene den trenger med apt.
• Laster ned signalserverens binærfil til mappen /home/hopsignal.
• Oppretter en systemd-tjeneste med navnet hopsignal og starter den ved hver oppstart.
• Legger til en cron-vakthund som starter tjenesten på nytt hvis den slutter å svare, og roterer loggen når den passerer 100 MB.
• Åpner TCP-port 80 i ufw når ufw er aktiv.

Trinn 1 på Windows: Kjør signalserveren

1. Sett OS-bryteren øverst på denne siden til Windows og klikk på Download. Du får én fil med navnet hopsignal.exe.
2. Opprett en mappe som C:\hopsignal og flytt hopsignal.exe dit.
3. Opprett en tom tekstfil med navnet fedlist.txt i samme mappe.
4. Windows-versjonen forventer også et TLS-sertifikat og den private nøkkelen i PEM-format. Ethvert par fungerer, også et selvsignert. Lagre dem som cert.pem og key.pem i samme mappe.
5. Åpne en ledetekst som administrator og start serveren.

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

Hvis du har OpenSSL, lager denne kommandoen et selvsignert sertifikatpar:

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

Tillat porten i Windows-brannmuren:

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

For at serveren skal fortsette å kjøre etter en omstart, registrerer du den som en planlagt oppgave som starter ved oppstart under SYSTEM-kontoen:

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

Trinn 2: Sjekk at serveren kjører

På Linux sjekker du tjenesten og loggen:

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

På Windows bekrefter du at porten lytter:

netstat -an | find ":80 "

Test WebSocket-porten fra hvilken som helst datamaskin. Bytt ut SERVER_IP med serveradressen din. En frisk server svarer 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/

Trinn 3: Pek enhetene dine mot serveren

Hver enhet leser nettverksinnstillingene sine fra et lite JSON-dokument. Dette er blokken installasjonsprogrammet skrev ut på slutten av trinn 1. Bytt ut SERVER_IP med serveradressen din, og fyll inn TURN-blokken hvis du kjører ditt 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"
}

Blokken rendezvous er signalserveren din. Bruk nøkkelen rendezvousssl i stedet for rendezvous når serveren nås via TLS, for eksempel en Cloudflare Worker eller en AWS-utrulling. Listen turnservers inneholder ett eller flere reléer. Sett protokollen til turn for en vanlig tilkobling eller til turn-tls for en TLS-tilkobling. La versjonsnøklene stå som de er.

Det finnes tre måter å gi dette dokumentet til enhetene dine på. Velg den som passer oppsettet ditt.

Alternativ A: Legg en api.json-fil på hver enhet

Lagre dokumentet som en fil med navnet api.json i HopToDesks konfigurasjonsmappe, og start deretter HopToDesk på nytt. Appen leser filen ved oppstart og kontakter ikke lenger HopToDesk-API-et.

På Linux kjører bakgrunnstjenesten som root og leser filen under /root, mens appen du åpner leser filen i din egen hjemmemappe. Legg en kopi begge steder.

Alternativ B: Legg filen på en URL og velg den i appen

1. Last opp api.json til en hvilken som helst webserver enhetene dine kan nå. HTTPS anbefales.
2. Klikk på tannhjulikonet i HopToDesk for å åpne innstillingene.
3. Under Network klikker du på Choose Network.
4. Velg Custom Network Settings, lim inn URL-en til filen din og bekreft.
5. HopToDesk laster ned filen, sjekker at den inneholder en gyldig rendezvous-oppføring og en turnservers-liste, og kobler deretter til på nytt via serveren din.

For å gå tilbake til det offentlige nettverket åpner du Choose Network igjen og velger HopToDesk Network.

Alternativ C: Send innstillingene fra dashbordet

Hvis enhetene dine er koblet til HopToDesk-dashbordet, kan du sette nettverket én gang for hele kontoen. En tilpasset klient bygget fra dashbordet leveres med disse innstillingene innebygd.

1. Logg inn på dashbordet som eier eller administrator og åpne innstillingene.
2. Under Network Settings velger du Custom Network.
3. Skriv inn signalserverens vert, porten og WS som protokoll. Legg til en TURN-server hvis du kjører ditt eget relé, eller la det stå tomt for å beholde HopToDesk-reléet.
4. Klikk på Save Network Settings. Hver tilkoblede enhet mottar de nye innstillingene og tar dem i bruk uten reinstallasjon.

Kjør ditt eget TURN-relé (valgfritt)

Økter som ikke kan koble til direkte, går som standard via HopToDesk-reléet. For å holde all trafikk på din egen infrastruktur kjører du en TURN-server. Enhver standard TURN-server fungerer, og coturn er et vanlig valg på Linux.

1. Installer coturn på reléserveren.

sudo apt install coturn

2. Rediger /etc/turnserver.conf og sett minst verdiene nedenfor. Bytt ut realm, påloggingsopplysningene og den offentlige IP-en med dine egne.

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

3. Hvis /etc/default/coturn inneholder en linje TURNSERVER_ENABLED, fjern kommentartegnet. Aktiver deretter tjenesten og start den.

sudo systemctl enable --now coturn
sudo systemctl restart coturn

4. Åpne lytteporten for TCP og UDP, pluss UDP-reléområdet 49152 til 65535, i reléets brannmur.
5. Gi reléet til enhetene dine: kjør installasjonsprogrammet på nytt med de fire TURN-verdiene, eller rediger blokken turnservers i nettverksinnstillingene. Bruk turn-tls som protokoll hvis reléet ditt terminerer TLS.

Administrere serveren på Linux

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

For å oppdatere serveren stopper du tjenesten og kjører installasjonskommandoen på nytt. Den laster ned den gjeldende binærfilen og skriver tjenesten på nytt.

For å fjerne serveren sammen med tjenesten og cron-oppføringene:

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

Feilsøking

• ID-en blir stående på Generating, eller appen prøver hele tiden å koble til nettverket: enheten når ikke signalserveren. Sjekk at tjenesten kjører, at port 80 er åpen og at adressen i nettverksinnstillingene er riktig.
• Enhetene kobler til på LAN, men ikke utenfra: reléet kan ikke nås. Med standardreléet trenger enhetene utgående tilgang til turn.hoptodesk.com på port 443. Med ditt eget relé sjekker du brannmurreglene og påloggingsopplysningene.
• Appen ignorerer api.json: sørg for at filen er gyldig JSON uten avsluttende komma, at den ligger i riktig mappe, og at du har startet HopToDesk på nytt. Appens logg inneholder linjen Loaded local api.json når filen ble lest inn.
• Port 82 er føderasjonsporten for å koble sammen flere av dine egne signalservere. Hold den stengt mot internett.
• Signalserveren lagrer ingen øktdata. Hvis noe ser ut til å henge, start tjenesten på nytt. Enhetene kobler seg til igjen av seg selv innen omtrent et minutt.