Hoe Localtonet werkt
Op deze pagina 10 secties
De Localtonet-client op je apparaat opent een uitgaande, versleutelde tunnel naar een Localtonet-server. De server geeft je service een openbaar adres en stuurt het verkeer door die tunnel naar het lokale IP-adres en de poort die je hebt gekozen.
Het pad van een verzoek #
- Een bezoeker maakt verbinding met het openbare adres van je tunnel. Dat adres hoort bij een Localtonet-server in de regio die je hebt gekozen.
- De Localtonet-server stuurt het verkeer de tunnel in die de client op je apparaat al heeft geopend.
- De Localtonet-client ontvangt het verkeer en maakt verbinding met het lokale IP-adres en de poort die op de tunnel zijn ingesteld, bijvoorbeeld
127.0.0.1:3000. - Je service antwoordt en het antwoord reist op dezelfde manier terug.
Geen port forwarding, geen openbaar IP #
Je apparaat start de verbinding, dus er hoeft geen inkomende poort te worden geopend. Je hebt geen openbaar IP-adres nodig en hoeft niets aan je router te wijzigen. Dit werkt ook achter NAT en CGNAT, op thuis- en mobiele verbindingen waar port forwarding niet mogelijk is.
Je netwerk moet de uitgaande verbinding wel toestaan. Een firewall of een endpointbeveiligingsproduct kan die blokkeren.
Voor HTTP- en TCP-tunnels kun je de client ook overslaan: de instellingen van de tunnel tonen een SSH-opdracht waarmee je de tunnel vanaf elke machine met een SSH-client opent. Zie SSH zonder installatie.
Apparaten en AuthTokens #
Een AuthToken koppelt één apparaat aan je account. Je start de client ermee en vanaf dan kun je dat apparaat kiezen wanneer je een tunnel aanmaakt.
- Eén token per apparaat. Maak voor elk apparaat een token aan onder Mijn tokens en geef het een naam die je herkent, zoals
Office-PC. De naam is slechts een label. Localtonet genereert het token zelf. - Eén verbinding per token. Een nieuwe verbinding met hetzelfde token vervangt de vorige, start dus niet twee apparaten met hetzelfde token.
- Online en Offline. Mijn tokens toont elk apparaat als Online zolang de Localtonet-app verbonden is en als Offline wanneer de verbinding is verbroken, ook als de tunnels nog zijn geconfigureerd.
- Houd het privé. Iedereen met het token kan ermee als dat apparaat inloggen in de app.
Een AuthToken beschermt een tunnel niet. Het identificeert je apparaat, niet je bezoekers. Een nieuwe tunnel is bereikbaar voor iedereen die het adres heeft. Zie Toegangsbeheer om bezoekers te beperken.
Meer over tokens: AuthTokens.
Tunnels #
Een tunnel is een opgeslagen set instellingen die een openbaar adres koppelt aan een service op één apparaat. Elke tunnel slaat op:
| Instelling | Wat het bepaalt |
|---|---|
| Tunneltype | Het protocol: HTTP, TCP, UDP, TLS, Bestandsserver, Proxyserver en andere. Zie Tunneltypen. |
| Apparaattoken | Het apparaat dat het verkeer ontvangt. Het is het token waarmee de client op dat apparaat is gestart. |
| Serverregio | De locatie van de Localtonet-server die het openbare adres host. |
| URL-type | Hoe het openbare adres wordt gekozen. |
| Lokaal IP-adres en Lokale poort | Waarheen de client het verkeer stuurt. Gebruik 127.0.0.1 voor een service op hetzelfde apparaat als de client. |
Eén apparaat kan meerdere tunnels bedienen. Mijn tokens toont het aantal actieve en het totale aantal tunnels dat aan elk token is gekoppeld. Om een tunnel naar een ander apparaat te verplaatsen, kies je in de tunnellijst de tokennaam en kies je een ander token onder AuthToken wijzigen. Een draaiende tunnel stopt en start opnieuw met het gekozen token. Tunnels van het type Roterende proxy vormen de uitzondering: zij gebruiken tokengroepen in plaats van één token.
Van aangemaakt tot live #
- Aanmaken. Tunnel aanmaken slaat alleen de instellingen op. Er is nog niets online.
- Starten. Kies Starten. Als de client van het token van de tunnel verbonden is, gaat de tunnel live.
- Starten terwijl het apparaat offline is. Het dashboard meldt dat het token offline is en wacht tot de app verbinding maakt. Toch starten zet de tunnel nu aan. Hij telt als actief en gaat live zodra de app verbinding maakt.
- Stoppen. Het openbare adres antwoordt niet meer. De tunnel en zijn instellingen blijven bewaard voor later.
- Verwijderen. Het endpoint en de instellingen van de tunnel worden verwijderd.
Als je een token verwijdert, worden ook de bijbehorende tunnels verwijderd. Tunnels met dat token worden gestopt en verwijderd.
Serverregio's #
Het veld Serverregio bepaalt waar het openbare adres van een tunnel wordt gehost. De hint in het dashboard luidt: kies een regio dicht bij je apparaat voor een lagere latentie.
De lijst wordt voor je account samengesteld. Hij bevat:
- Localtonet-regio's, één per land. De netwerkkaart op de homepage toont de locaties.
- Je eigen servers, als je er met Serverbeheer hebt toegevoegd. Alleen jouw account ziet ze en de lijst selecteert standaard jouw server.
- Lokaal als server, bij de tunneltypen die dit ondersteunen. Zie hieronder.
Je kunt een bestaande tunnel verplaatsen: kies in de tunnellijst de server van de tunnel om Server wijzigen te openen. Hiervoor is saldo nodig en wanneer de server wordt gewijzigd, kunnen DNS-updates tot 3 uur duren.
Openbare adressen en URL-typen #
Wanneer je een tunnel aanmaakt, bepaalt URL-type hoe het openbare adres wordt gekozen.
| URL-type | Wat je krijgt | Abonnement |
|---|---|---|
| Willekeurig subdomein | Localtonet genereert een subdomein voor je. Je hebt meteen een adres. | Gratis-abonnement |
| Eigen subdomein | Je voert zelf het Subdomein in en kiest het Domein waartoe het behoort. | Saldo vereist |
| Eigen domein | Je gebruikt een eigen domein dat je hebt toegevoegd in DNS-beheer. Zie Eigen domeinen. | Saldo vereist |
Niet elk tunneltype biedt elk URL-type:
| Tunneltype | Willekeurig subdomein | Eigen subdomein | Eigen domein |
|---|---|---|---|
| HTTP | Ja | Ja | Ja |
| Bestandsserver | Ja | Ja | Ja |
| MCP-gateway | Ja | Ja | Ja |
| TLS | Ja | Ja | Nee |
| TCP, UDP, UDP / TCP gemengd | Ja | Ja | Nee |
| Proxyserver | Ja | Ja | Nee |
| Roterende proxy | Ja | Ja | Nee |
TCP-, UDP- en proxytunnels worden bereikt via een hostnaam plus een Serverpoort.
Blijft het adres hetzelfde? #
- Een HTTP-tunnel behoudt zijn subdomein totdat je de tunnel verwijdert.
- Bij TCP-, UDP- en proxytunnels start een tunnel die is aangemaakt op een account met saldo met Gereserveerd? aan, waardoor dezelfde poort na herstarts behouden blijft. Je kunt dit per tunnel omschakelen; zie Poorten.
- Met het Gratis-abonnement wordt de poort vrijgegeven wanneer de tunnel stopt, dus het adres kan veranderen.
End-to-end-versleuteling #
De tunnel tussen je apparaat en de Localtonet-servers is versleuteld. Dat is niet hetzelfde als end-to-end-versleuteling tussen een bezoeker en je service:
- Bezoekers bereiken een HTTP-tunnel via HTTPS, met certificaten die Localtonet voor je beheert. Die HTTPS eindigt bij de Localtonet-server, niet bij je service. Vanaf daar reist het verkeer door de versleutelde tunnel naar je apparaat.
- Gebruik voor end-to-end-versleuteling een TLS-tunnel in pass-through-modus, waarbij je service zijn eigen certificaat toont, of een protocol dat al versleuteld is, zoals SSH.
Wanneer de client de verbinding verbreekt #
Een tunnel werkt alleen terwijl drie dingen draaien: je apparaat, de Localtonet-client en je lokale service. Als de client zijn verbinding verliest of je hem sluit:
- Bezoekers kunnen de service niet meer bereiken via het openbare adres.
- Het apparaat toont Offline in Mijn tokens. De tunnel zelf blijft gestart.
- De client blijft zelf proberen opnieuw te verbinden. Een gestarte tunnel gaat weer live zodra de app verbinding maakt.
- Een gestarte tunnel wordt gefactureerd zolang hij gestart is, ook als het apparaat offline is. Stop de tunnel om de kosten te beëindigen. Zie Abonnementen en saldo.
Om de client na uitloggen of een herstart te laten doorlopen, installeer je hem als service: Uitvoeren als service. Om een melding te krijgen wanneer een tunnel of token de verbinding verbreekt, stel je Webhooks in.
Lokaal als server #
Lokaal als server is een item in de lijst Serverregio. Hiermee host geen enkele Localtonet-server het openbare adres. De Localtonet-client op je apparaat opent zelf de listener en bezoekers maken rechtstreeks verbinding met je apparaat. Het dashboard noemt deze tunnels ook Client Relay.
- Het wordt aangeboden wanneer je HTTP-, TCP-, UDP-, TLS-, Proxyserver- en MCP-gateway-tunnels aanmaakt. Bestandsserver en Roterende proxy bieden het niet aan.
- Als je het selecteert, vraagt het formulier om een IP van relayserver: het IP-adres van je apparaat waarmee bezoekers verbinding maken.
- Het apparaat dat de listener host, moet verbonden blijven.
- Client Relay-tunnels hebben hun eigen, lagere prijs. Zie Abonnementen en saldo.
| Melding | Wat je moet doen |
|---|---|
| Voer het lokale server-IP in. | Vul IP van relayserver in. |
| Het lokale server-IP moet van buitenaf bereikbaar zijn. | Je hebt een loopback-adres of een ander alleen lokaal adres ingevoerd, zoals 127.0.0.1. Voer een adres in dat je bezoekers kunnen bereiken. |