Naar de inhoud
Localtonet Localtonet Dashboard

Referentie voor tunnelinstellingen

Hulp bij deze pagina
Op deze pagina 15 secties
  1. De instellingen van een tunnel openen
  2. Open de pagina van het tunneltype
  3. Kies Instellingen in de tunnelrij
  4. Een instelling wijzigen
  5. Hoe wijzigingen worden toegepast
  6. Welk tunneltype heeft welke instelling
  7. Wat elke instelling doet
  8. Tunneldetails
  9. Tunnelnotitie
  10. SslStream?
  11. PROXY-protocol?
  12. Verouderde verbinding?
  13. Lokaal server-IP
  14. Tunnel-IP
  15. Instellingen in de tunnellijst
  16. De server wijzigen
  17. De AuthToken wijzigen
  18. Web Application Firewall
  19. Dezelfde instellingen via de API
  20. Probleemoplossing
  21. Gerelateerde pagina's

Elke tunnel heeft een instellingenpaneel in het dashboard. Deze pagina laat zien waar je het opent, noemt elke instelling, geeft aan welke tunneltypen de instelling hebben en verwijst naar de pagina die de instelling uitgebreid uitlegt.

De instellingen van een tunnel openen #

  1. Open de pagina van het tunneltype #

    Open in het dashboardmenu Mijn tunnels en kies het type: Mijn tunnels › HTTP, TCP - UDP, TLS, Bestandsserver, Proxyserver, Roterende proxy of MCP-gateway.

  2. Kies Instellingen in de tunnelrij #

    Zoek de tunnel onder Je tunnels en kies Instellingen in de kolom Acties. Het paneel Tunnelinstellingen opent aan de zijkant van de pagina.

  3. Een instelling wijzigen #

    Het paneel bestaat uit de volgende delen:

    • Tunneldetails: gegevens zoals het adres van de tunnel, de aanmaakdatum en de naam van de AuthToken, plus de waarden die je kunt bewerken door ze te selecteren: de titel bij elk tunneltype, en bij HTTP-, TCP - UDP- en TLS-tunnels ook het lokale adres en de lokale poort.
    • De load balancing-doelen van de tunnel, bij de tunneltypen die dit ondersteunen. Zie Load balancing.
    • SSH-opdracht tonen, bij de tunneltypen die met gewone SSH kunnen worden gestart. Zie SSH zonder installatie.
    • Instellingen: één rij per instelling. Een rij heeft een schakelaar Ja / Nee of een knop (Beheren, Wijzigen, Tonen of Wissen) die een dialoogvenster opent. Het informatiepictogram naast een label legt de instelling in één zin uit.

    Bij de meeste schakelaars moet je bevestigen voordat er iets verandert, bijvoorbeeld Alleen HTTPS inschakelen? met de knoppen Inschakelen en Annuleren. Als je Basisauthenticatie? of Pad herschrijven? inschakelt, opent in plaats daarvan een dialoogvenster, en als je Gereserveerd? inschakelt op een draaiende tunnel, wordt de poort zonder vraag gereserveerd.

Hoe wijzigingen worden toegepast #

Sommige instellingen worden op een draaiende tunnel toegepast zonder onderbreking. Andere stoppen de tunnel en starten hem opnieuw met de nieuwe waarde. Dat kost even tijd en verbreekt de openstaande verbindingen.

Toegepast zonder herstartHerstart een draaiende tunnel
Alleen HTTPS?, Pad herschrijven?, HTTP/3 actief?, Gereserveerd?, Headers, HTTP-time-out, Tunnelnotitie, IP-beperking, Vervaldatum, Uitgaande poort, Bandbreedtelimiet, Bandbreedteverbruik, de WAF-schakelaar De titel, het lokale adres en de lokale poort in Tunneldetails, Basisauthenticatie?, SslStream?, PROXY-protocol?, Verouderde verbinding?, Serverpoort, Argumenten, Lokaal server-IP, Snelheidslimieten, de server wijzigen, de AuthToken wijzigen

Een instelling die de tunnel herstart, kun je bij een draaiende tunnel alleen opslaan terwijl de Localtonet-app van het bijbehorende apparaat verbonden is. Anders antwoordt het dashboard met "Controleer de verbinding van het apparaat." en blijft de oude waarde staan. Bij een gestopte tunnel wordt de waarde opgeslagen en bij de volgende start gebruikt.

Welk tunneltype heeft welke instelling #

De labels zijn die van het onderdeel Instellingen. "Ja" betekent dat het tunneltype de rij heeft.

InstellingHTTPTCP - UDPTLSBestandsserverProxyserverRoterende proxyMCP-gateway
Alleen HTTPS?Ja–––––Ja
Pad herschrijven?Ja––––––
Basisauthenticatie?Ja––Ja, type Default––Ja
SslStream?JaJa, niet voor UDPJa––––
HTTP/3 actief?Ja–––––Ja
Gereserveerd?–Ja––JaJa–
PROXY-protocol?–Ja, niet voor UDP–––––
Verouderde verbinding?JaJaJaJaJa–Ja
SSL-modus––Ja––––
SSO-providersJa, niet bij teamtunnels––––––
Gatewaytoken––––––Ja
HeadersJa––––––
HTTP-time-outJa–––––Ja
Serverpoort–Ja––Ja, niet voor VLESSJa–
TunnelnotitieJaJaJaJaJaJaJa
Lokaal server-IPAlleen lokale serverAlleen lokale serverAlleen lokale server–Alleen lokale server–Alleen lokale server
ArgumentenJaJaJa–Ja––
IP-beperkingJaJaJaJaJaJaJa
VervaldatumJaJaJaJaJa–Ja
SnelheidslimietenJaJaJaJaJa–Ja
Uitgaande poortJaJaJaJaJaJaJa
BandbreedtelimietJaJaJaJaJa–Ja
BandbreedteverkeerJaJaJaJaJaJaJa
BandbreedteverbruikJaJaJaJaJa–Ja
Tunnel-IP–JaJa–JaJa–
VerzoeklogboekJaJaJaJaJa–Ja
ActiviteitenlogboekJaJaJaJaJaJaJa
TunnelgezondheidJaJaJa–JaJaJa

De pagina's Proxyserver en Roterende proxy hebben eigen extra rijen, zoals Proxy-authenticatie, Toegangsbeheer, Upstream-instelling, VPN-toegang, Snelheidstest, Tunneltoken en Alleen via IPv4 verbinden?. Ze worden beschreven in Proxyserver en Roterende proxy. Een tunnel die de server Lokaal gebruikt, heeft geen rij Uitgaande poort. "Alleen lokale server" geldt ook voor een tunnel waarvan de kolom Server VPN toont.

Wat elke instelling doet #

InstellingWat het doetDetails
Alleen HTTPS?Biedt de publieke URL alleen via HTTPS aan.Headers en herschrijvingen
Pad herschrijven?Voegt een pad toe vóór elk verzoek voordat het je lokale service bereikt.Headers en herschrijvingen
Basisauthenticatie?Vraagt bezoekers om een gebruikersnaam en wachtwoord.Toegangsbeheer
SslStream?Geeft aan de tunnel door dat je lokale service zelf HTTPS of TLS gebruikt.Deze pagina
HTTP/3 actief?Laat clients de publieke URL via HTTP/3 bereiken.Headers en herschrijvingen
Gereserveerd?Behoudt dezelfde serverpoort wanneer de tunnel opnieuw start.Poorten
PROXY-protocol?Geeft het oorspronkelijke clientadres in een PROXY-protocolheader door aan je service.Deze pagina
Verouderde verbinding?Een alternatieve verbindingsmethode die je kunt proberen wanneer de tunnel met de normale methode geen verbinding kan maken.Deze pagina
SSL-modusBepaalt of Localtonet HTTPS voor een TLS-tunnel afhandelt of het versleutelde verkeer ongewijzigd doorgeeft aan je service.TLS
SSO-providersLaat bezoekers inloggen bij een van je identiteitsproviders voordat ze de tunnel kunnen openen.Single sign-on
GatewaytokenToont de token die je MCP-clients meesturen om verbinding te maken met de gateway.MCP-gateway
HeadersVoegt vaste verzoek- en antwoordheaders toe.Headers en herschrijvingen
HTTP-time-outStelt in hoe lang de tunnel wacht tot je service een verzoek beantwoordt.Headers en herschrijvingen
ServerpoortWijzigt de poort waarmee mensen verbinding maken op de Localtonet-server.Poorten
TunnelnotitieEen privé-geheugensteuntje over waarvoor de tunnel dient.Deze pagina
Lokaal server-IPDe adressen waarop je lokale server bereikbaar is.Deze pagina
ArgumentenStuurt de tunnel via een bepaald netwerk van het apparaat.Netwerkselectie
IP-beperkingBepaalt welke IP-adressen verbinding met de tunnel mogen maken.Toegangsbeheer
VervaldatumStopt de tunnel op een ingestelde datum.Limieten en vervaldatum
SnelheidslimietenBegrenst de upload- en downloadsnelheid.Limieten en vervaldatum
Uitgaande poortHoudt de poorten waarmee de Localtonet-app naar buiten verbindt vast, voor strikte firewalls.Poorten
BandbreedtelimietStopt de tunnel nadat er een ingestelde hoeveelheid data doorheen is gegaan.Limieten en vervaldatum
BandbreedteverkeerToont in een grafiek de data die door de tunnel is gegaan.Limieten en vervaldatum
BandbreedteverbruikZet de datateller van de tunnel terug op nul.Limieten en vervaldatum
Tunnel-IPToont de IP-adressen van de server waarop de tunnel draait.Deze pagina
VerzoeklogboekToont de verzoeken of verbindingen die voor de tunnel zijn vastgelegd.Logboeken en inspectie
ActiviteitenlogboekToont starts, stops en instellingswijzigingen.Logboeken en inspectie
TunnelgezondheidToont de resultaten van de regelmatige gezondheidscontroles.Logboeken en inspectie

Tunneldetails #

Selecteer een waarde in Tunneldetails om die te bewerken. Als je een van de drie opslaat, wordt een draaiende tunnel herstart. Het lokale adres en de lokale poort kun je hier bewerken bij HTTP-, TCP - UDP- en TLS-tunnels; de andere tunneltypen tonen alleen de titel.

DialoogvensterWat je invultRegels
Tunnel hernoemenEen naam die je herkent in je tunnellijst, bijvoorbeeld "Office NAS".Verplicht. Maximaal 30 tekens: het dialoogvenster telt tot 100, maar een titel langer dan 30 tekens wordt geweigerd met "De titel mag niet langer zijn dan 30 tekens."
Lokaal adresWaar de Localtonet-app je service vindt. Gebruik 127.0.0.1 wanneer de service draait op hetzelfde apparaat als de app. Om een ander apparaat in je netwerk te bereiken, voer je het adres ervan in, bijvoorbeeld 192.168.1.20.Een IPv4-adres, een IPv6-adres of een hostnaam. Geen http://, geen pad, geen poort.
Lokale poortDe poort waarop je service luistert, op het apparaat waarop die draait.Een getal van 1 tot en met 65535.

Tunnelnotitie #

Tunnelnotitie › Beheren opent het dialoogvenster Notitie. Een notitie is een geheugensteuntje over waarvoor de tunnel dient, en alleen jouw account ziet hem.

  • Een notitie mag maximaal 499 tekens bevatten. Het dialoogvenster telt ze mee terwijl je typt.
  • Met de keuzes onder Label zet je een label vóór de notitie: Productie, Staging, Test, Demo of Tijdelijk. De notitie begint dan bijvoorbeeld met Staging - . Als je een ander label kiest, vervangt dat het huidige label.

SslStream? #

Zet SslStream? aan wanneer je lokale service zelf HTTPS of TLS gebruikt, bijvoorbeeld een ontwikkelserver die alleen luistert op https://localhost. Laat de schakelaar uit voor een service die gewone HTTP of gewone TCP spreekt. HTTP-, TCP- en TLS-tunnels hebben de schakelaar; een UDP-tunnel niet.

PROXY-protocol? #

Als PROXY-protocol? aan staat, geeft de tunnel het oorspronkelijke clientadres in een PROXY-protocolheader door aan je service. Zet het alleen aan als je service is ingesteld om die header te lezen, want een service die dat niet verwacht, ziet aan het begin van elke verbinding onbekende bytes. TCP-tunnels hebben de schakelaar; een UDP-tunnel niet.

Verouderde verbinding? #

Verouderde verbinding? schakelt de tunnel over op een alternatieve verbindingsmethode. Probeer dit als de tunnel met de normale methode geen verbinding kan maken, en zet het weer uit als het niet helpt.

Lokaal server-IP #

Deze rij verschijnt alleen bij tunnels waarvan de kolom Server Lokaal of VPN toont. Het dialoogvenster Lokaal server-IP bevat de adressen waarop je lokale server bereikbaar is: een IPv4-adres en, optioneel, een IPv6-adres. Laat IPv6 leeg als je het niet gebruikt. Minstens één adres is verplicht. Een adres dat alleen op het apparaat zelf werkt, zoals 127.0.0.1, 0.0.0.0 of ::1, wordt geweigerd met "Het IP van de lokale server moet van buitenaf bereikbaar zijn."

Tunnel-IP #

Tunnel-IP › Tonen opent het dialoogvenster Server-IP met het IPv4-adres en, als de server er een heeft, het IPv6-adres van de server waarop de tunnel draait. Clients kunnen met dit adres verbinding maken met de tunnel in plaats van met de domeinnaam.

Server-IP-adressen kunnen veranderen. Gebruik waar mogelijk de domeinnaam in apps en scripts.

Instellingen in de tunnellijst #

Twee instellingen wijzig je vanuit de tunnellijst, niet vanuit het paneel.

De server wijzigen #

Selecteer de servercode in de kolom Server, kies een andere server in het dialoogvenster Server wijzigen en kies Verzenden. Een draaiende tunnel wordt op de nieuwe server herstart.

  • Voor het wijzigen van de server heb je saldo nodig. Zonder saldo antwoordt het dashboard met "Je moet saldo kopen om deze functie te gebruiken."
  • Als de serverpoort van de tunnel op de nieuwe server al bezet is, krijg je "De poort van je tunnel (PORT) is niet beschikbaar op de geselecteerde server. Wijzig eerst de poort." Wijzig de poort zoals beschreven in Poorten en probeer het daarna opnieuw.
  • Tunnels waarvan de kolom Server Lokaal of VPN toont, kunnen niet worden verplaatst.

Na een serverwijziging kunnen DNS-updates tot 3 uur duren.

De AuthToken wijzigen #

Selecteer de tokennaam in de kolom AuthToken om AuthToken wijzigen te openen, kies een andere AuthToken en kies Verzenden. Hiermee verplaats je de tunnel naar het apparaat waarop de Localtonet-app met die token draait.

  • Een draaiende tunnel stopt, wacht 2 seconden en start dan opnieuw met de gekozen AuthToken. Een gestopte tunnel blijft gestopt.
  • Als de app met de nieuwe token niet verbonden is, wordt de token toch gewijzigd en krijg je "De AuthToken is bijgewerkt, maar de tunnel kon niet opnieuw worden gestart. Verbind de Localtonet-app met de geselecteerde token en start de tunnel."
  • Tunnels voor Roterende proxy gebruiken AuthToken-groepen. Wijzig in plaats daarvan de groepen.

AuthTokens worden uitgelegd in AuthTokens.

Web Application Firewall #

HTTP- en MCP-gateway-tunnels hebben ook een schildknop in de kolom Acties. Die opent de firewall van de tunnel. Zie Web Application Firewall.

Dezelfde instellingen via de API #

De meeste instellingen kun je ook lezen en wijzigen met de API, onder het pad van de tunnel. Authenticatie en de volledige referentie vind je in API.

InstellingPad na /api/v2/tunnels/<TUNNEL_ID>/
IP-beperkingip-restrictions
Headersheaders, host-header
Basisauthenticatieauthentication
Vervaldatumexpiration
Serverpoortserver-port
HTTP-time-outhttp-timeout
Snelheidslimietenrate-limit
Bandbreedtelimiet en -verbruikbandwidth-limit, bandwidth-usage, bandwidth-usage/reset
Argumentenarguments
Alleen HTTPS?, HTTP/3 actief?, Pad herschrijven?https-only, http3, path-rewrite
SslStream?, PROXY-protocol?, SSL-modusssl-stream, proxy-protocol, pass-through
Tunnelnotitienote
Serverserver

Probleemoplossing #

"Controleer de verbinding van het apparaat."

De instelling herstart de tunnel en de Localtonet-app van het apparaat van de tunnel is niet verbonden. Start de app op het apparaat, wacht tot de kolom Verbinding AAN toont en sla daarna opnieuw op. Je kunt de tunnel ook eerst stoppen: bij een gestopte tunnel wordt de waarde opgeslagen zonder herstart.

"Je moet saldo kopen om deze functie te gebruiken."

De instelling vereist saldo op het account. Dit geldt voor gereserveerde poorten, een eigen serverpoort, vaste uitgaande poorten, IP-beperkingen en het wijzigen van de server. Zie Abonnementen en saldo.

"Je hebt geen toestemming om deze tunnel bij te werken."

Je werkt in een team en je rol omvat niet het wijzigen van tunnels. Vraag de teameigenaar om je die toestemming te geven. Zie Teambeheer.

Een rij uit de tabel ontbreekt in mijn paneel

Het paneel toont alleen de rijen van het type van de tunnel, en een paar rijen hangen af van de tunnel zelf: Lokaal server-IP vereist de server Lokaal of VPN, SSO-providers wordt niet getoond bij teamtunnels, en een UDP-tunnel heeft geen SslStream? en PROXY-protocol?.

Support