Naar de inhoud
Localtonet Localtonet Dashboard

Een HTTP-tunnel aanmaken

Hulp bij deze pagina
Op deze pagina 10 secties
  1. Voordat je begint
  2. Stappen
  3. Open de HTTP-pagina
  4. Kies het URL-type
  5. Kies het apparaat en de regio
  6. Vul het lokale adres in
  7. Start de tunnel
  8. Je openbare adres
  9. HTTPS en certificaten
  10. De Host-header
  11. Instellingen van een HTTP-tunnel
  12. Voorbeelden
  13. Een webapp delen
  14. Webhooks ontvangen
  15. De waarschuwingspagina in het Gratis-abonnement
  16. Probleemoplossing
  17. Gerelateerde pagina's

Een HTTP-tunnel geeft een webapp, een API of een webhook-ontvanger op je apparaat een openbaar HTTPS-adres. Localtonet levert het certificaat, dus je lokale service kan gewoon op HTTP blijven draaien.

Voordat je begint #

  • De Localtonet-client is op het apparaat geïnstalleerd en verbonden met een AuthToken. Is dat nog niet zo, volg dan de Snelstart.
  • Je webservice draait en je kent de poort, bijvoorbeeld 3000.
  • Voor Eigen subdomein of Eigen domein: saldo op je account. Voor Eigen domein ook een domein dat je hebt toegevoegd in DNS-beheer. Zie Eigen domeinen.

Stappen #

  1. Open de HTTP-pagina #

    Open Mijn tunnels › HTTP en kies HTTP-tunnel aanmaken om het formulier te openen.

  2. Kies het URL-type #

    URL-typeAdres dat je krijgtVereist
    Willekeurig subdomeinEen gegenereerde naam op het gekozen domein, bijvoorbeeld https://<RANDOM_NAME>.localto.net.Niets extra's
    Eigen subdomeinDe naam die je invult bij Subdomein, bijvoorbeeld https://myapp.localto.net. Letters, cijfers en koppeltekens zijn toegestaan.Saldo
    Eigen domeinEen eigen domein, gekozen bij Domein.Saldo en een domein in DNS-beheer
  3. Kies het apparaat en de regio #

    Kies bij Apparaattoken de token die de Localtonet-app op je apparaat gebruikt. Kies bij Serverregio een regio dicht bij je apparaat voor een lagere latentie.

  4. Vul het lokale adres in #

    VeldWat je invult
    Domeinlocalto.net, of een van je eigen domeinen. Bij Eigen domein bevat de lijst alleen je eigen domeinen.
    SubdomeinAlleen voor Eigen subdomein: de naam vóór het domein.
    Lokaal IP-adresAdres van de service op je apparaat. Gebruik 127.0.0.1 voor dit apparaat. Het formulier accepteert een IPv4- of IPv6-adres of localhost.
    Lokale poortDe poort waarop je lokale service luistert, van 1 tot 65535.

    Kies Tunnel aanmaken. De tunnel verschijnt onder Je tunnels als Tunnel # gevolgd door het ID.

  5. Start de tunnel #

    Kies de startknop in de kolom Acties. Zodra de tunnel draait, wordt het adres in de kolom URL een link. Open die in een browser. Verzoeken naar dat adres bereiken nu de service op je apparaat.

    Als de Localtonet-app van die token offline is, meldt een dialoogvenster dat. Start de app, of kies Toch starten, dan gaat de tunnel live zodra de app verbinding maakt.

Je openbare adres #

  • Het adres is https:// gevolgd door de hostnaam in de kolom URL.
  • Een HTTP-tunnel behoudt zijn subdomein totdat je de tunnel verwijdert. Stoppen en starten verandert het niet.
  • Het adres heeft geen poortnummer. Bezoekers openen het zoals elke andere website.
  • WebSocket-verbindingen lopen door een HTTP-tunnel.

HTTPS en certificaten #

Bezoekers bereiken een HTTP-tunnel via HTTPS met een certificaat dat Localtonet levert en vernieuwt. TLS wordt beëindigd op de Localtonet-server. Vandaar loopt het verzoek via de tunnel naar je apparaat en geeft de Localtonet-app het door aan je service.

InstellingWat het doetWanneer je het gebruikt
Alleen HTTPS?Levert de openbare URL alleen via HTTPS. Een verzoek naar http:// wordt doorgestuurd naar hetzelfde adres op https://. Zolang de instelling uit staat, antwoordt het adres op beide.Zet dit aan voor alles wat logins of privégegevens bevat.
HTTP/3 actief?Laat clients de openbare URL via HTTP/3 bereiken. Een nieuwe tunnel heeft dit aanstaan.Zet dit alleen uit als een client problemen heeft met HTTP/3.
SslStream?Laat de Localtonet-app met TLS verbinding maken met je lokale service. De app accepteert het certificaat van de lokale service zoals het is, dus een zelfondertekend certificaat werkt.Zet dit aan als je lokale service zelf HTTPS gebruikt, bijvoorbeeld een dev-server op https://localhost:5001.
Verouderde verbinding?Verbindt de tunnel met de verouderde methode in plaats van de normale.Probeer dit als de tunnel niet kan verbinden met de normale methode.

Je vindt deze schakelaars onder Instellingen in het paneel Tunnelinstellingen. Als je SslStream? of Verouderde verbinding? wijzigt op een draaiende tunnel, wordt die opnieuw gestart, dus de Localtonet-app moet verbonden zijn.

Versleuteling nodig tot aan je eigen service? Bij een HTTP-tunnel ontsleutelt Localtonet het verkeer op zijn server. Gebruik een TLS-tunnel als je service zijn eigen certificaat moet tonen.

De Host-header #

Je service ontvangt de hostnaam die de bezoeker heeft gebruikt, dus het tunneladres. Sommige lokale webservers kiezen de site op basis van de hostnaam en antwoorden met de verkeerde site of een foutmelding. Open in dat geval Headers in de tunnelinstellingen en voeg een requestheader met de naam Host toe met de naam die je server verwacht. Je service ontvangt dan deze hostnaam in plaats van het tunneladres. Zie Headers en herschrijvingen en Virtual hosts.

Instellingen van een HTTP-tunnel #

Kies de instellingenknop in de kolom Acties om het paneel Tunnelinstellingen te openen. Onder Tunneldetails kun je de tunnel hernoemen en het lokale IP-adres en de lokale poort wijzigen. De tabel toont wat een HTTP-tunnel verder biedt en waar dat wordt uitgelegd.

InstellingWat het doetMeer lezen
Load balancingVerdeel verkeer over apparaten of gebruik een back-updoel.Load balancing
SSH-opdracht tonenStart deze tunnel met gewone SSH, zonder de Localtonet-app te installeren.SSH zonder installatie
Alleen HTTPS?, HTTP/3 actief?, SslStream?, Verouderde verbinding?Hoe bezoekers en je service verbinding maken.Deze pagina, hierboven
Pad herschrijven?Wijzig het requestpad voordat het je lokale service bereikt.Headers en herschrijvingen
HeadersBeheer aangepaste HTTP-request- en responseheaders voor deze tunnel.Headers en herschrijvingen
HTTP-time-outStel in hoe lang de server wacht op een antwoord van je lokale applicatie, van 1 tot 600 seconden.Headers en herschrijvingen
Basisauthenticatie?Vraag bezoekers om een gebruikersnaam en wachtwoord.Toegangsbeheer
IP-beperkingBepaal welke client-IP-adressen toegang hebben tot deze tunnel.Toegangsbeheer
SSO-providersBezoekers melden zich aan bij een van je identiteitsproviders voordat ze de tunnel kunnen openen. De knop SSO bovenaan de pagina beheert de providers.Single sign-on
WAF-knop in de kolom ActiesOpent WAF-instelling. De knop toont of de Web Application Firewall niet is geconfigureerd, actief of inactief is.Web Application Firewall
Vervaldatum, Snelheidslimieten, Bandbreedtelimiet, Bandbreedteverbruik, BandbreedteverkeerStop de tunnel op een datum, beperk de snelheid, beperk de data, reset de datateller en bekijk het verkeer in de loop van de tijd.Limieten en vervaldatum
Verzoeklogboek, Activiteitenlogboek, TunnelgezondheidInspecteer verzoeken, bekijk starts, stops en instellingswijzigingen, en zie de gezondheidscontroles.Logboeken en inspectie
ArgumentenStuur deze tunnel via een specifiek netwerk op je apparaat.Netwerkselectie
Uitgaande poortGebruik vaste uitgaande poorten voor de serververbinding van de Localtonet-app, voor strikte firewalls.Poorten
TunnelnotitieSla een privénotitie op om deze tunnel te herkennen.Instellingenreferentie

SSO-providers wordt niet getoond voor een tunnel die bij een team hoort.

Voorbeelden #

Een webapp delen #

Je app draait op dezelfde computer als de Localtonet-client en luistert op poort 3000.

VeldWaarde
URL-typeWillekeurig subdomein
Domeinlocalto.net
Lokaal IP-adres127.0.0.1
Lokale poort3000

Maak de tunnel aan, start hem en stuur het adres uit de kolom URL naar de mensen die de app moeten zien. Wil je eerst om een wachtwoord vragen, zet dan Basisauthenticatie? aan.

Draait de app op een andere machine in je netwerk, vul dan het adres van die machine in bij Lokaal IP-adres, bijvoorbeeld 192.168.1.20. Het apparaat met de Localtonet-client moet die machine kunnen bereiken.

Webhooks ontvangen #

Een webhookprovider heeft een openbaar HTTPS-adres nodig om gebeurtenissen naartoe te sturen. Maak een HTTP-tunnel naar de poort van je ontvanger, start die en vul bij de provider het tunneladres plus het pad van je endpoint in:

Webhook-URL
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Test het vanaf elke computer:

Terminal
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
  -H "Content-Type: application/json" \
  -d '{"event":"test"}'

Om te zien wat er is binnengekomen, kies je het pictogram in de kolom Webhooks van de tunnel (Verzoek- & responslogboeken bekijken). De tunnel moet dan eerst gestart zijn. Zie Logboeken en inspectie.

Voeg in het Gratis-abonnement saldo toe voordat je op webhooks vertrouwt. Verzoeken naar een HTTP-tunnel van een gratis account krijgen eerst een waarschuwingspagina te zien, en een webhookprovider kan daar niet doorheen klikken. Zie de volgende sectie.

De waarschuwingspagina in het Gratis-abonnement #

Als een account geen saldo heeft, ziet een nieuwe bezoeker van de HTTP-tunnel een Localtonet-pagina met de titel "You are about to navigate to:" met de knoppen Cancel en Visit Site. De pagina is er om misbruik te ontmoedigen. Visit Site slaat een cookie op in de browser van de bezoeker en opent je site. Zolang de browser die cookie bewaart, wordt er niet opnieuw gevraagd.

De pagina zelf noemt de twee manieren om hem te verwijderen:

  • Stuur een requestheader met de naam localtonet-skip-warning met een willekeurige waarde. Dit past bij je eigen scripts en API-clients.
  • Voeg saldo toe aan je account. Zie Abonnementen en saldo.
Terminal
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/

Probleemoplossing #

Het dialoogvenster zegt dat de token offline is, of ik krijg "De Localtonet-app voor AuthToken … is niet verbonden."

De Localtonet-client die de token van deze tunnel gebruikt, draait niet of kan Localtonet niet bereiken. Start de client op het apparaat met dezelfde token. Het dialoogvenster start de tunnel automatisch zodra de app verbinding maakt. Met Toch starten wordt de tunnel aangezet en gaat hij later live.

"Start of update de Localtonet-app."

De tunnel kon niet op het apparaat worden gestart. Controleer of de client draait en installeer de huidige versie van de pagina Downloads als die oud is.

De browser toont "Tunnel Recently Started or Stopped"

Het verzoek heeft Localtonet bereikt, maar de tunnel accepteert geen verbindingen. De tunnel is net gestart of is gestopt. Controleer of hij gestart is en of de kolom Verbinding AAN toont, en laad de pagina daarna opnieuw.

De browser toont een Localtonet-foutpagina met mijn lokale adres

De pagina meldt dat het verkeer naar de Localtonet-agent is getunneld, maar dat de agent geen verbinding kon maken met de upstream-service op je lokale IP en poort. De kop is de fout, bijvoorbeeld ConnectionRefused. Er luistert niets op dat adres. Start je service en controleer daarna het lokale IP-adres en de lokale poort onder Tunneldetails. Je kunt de service op het apparaat zelf testen door het lokale adres in een browser te openen.

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

Eigen subdomein en Eigen domein hebben saldo nodig. Gebruik Willekeurig subdomein, of voeg saldo toe onder Saldo.

"You need a total balance of … to create another tunnel of this type."

Je saldo is niet genoeg voor nog een tunnel. In het Gratis-abonnement kun je in totaal maar één tunnel aanmaken, ongeacht het type. Verwijder je bestaande tunnel voordat je een nieuwe aanmaakt, of voeg saldo toe.

"… bestaat al." of "… is niet toegestaan."

Een andere tunnel gebruikt dat subdomein, of de naam is gereserveerd door Localtonet. Kies een ander subdomein.

"WAARSCHUWING! Je hebt geen domein!"

Je hebt Eigen domein gekozen, maar nog geen domein toegevoegd. Voeg het eerst toe in DNS-beheer. Zie je "… wordt al door een andere tunnel gebruikt.", dan hoort dat domein al bij een van je tunnels. Een eigen domein kan één tunnel bedienen.

"Pas de bandbreedtelimiet aan of wis het bandbreedtegebruik." of "Werk de vervaldatum bij."

De tunnel heeft zijn eigen bandbreedtelimiet of vervaldatum bereikt en kan niet starten. Wijzig de limiet of de datum in de tunnelinstellingen, of reset de teller met Bandbreedteverbruik. Zie Limieten en vervaldatum.

"Controleer de verbinding van het apparaat."

Je hebt een instelling gewijzigd waarvoor een draaiende tunnel opnieuw moet starten, terwijl de Localtonet-app offline was. Verbind de app en sla de instelling opnieuw op, of stop eerst de tunnel.

Mijn app antwoordt met de verkeerde site, of bouwt http://-links en doorverwijzingen

Je app beslist op basis van de hostnaam of het schema dat hij ontvangt. Voeg onder Headers een requestheader Host toe als de app een vaste hostnaam verwacht. Voeg een requestheader X-Forwarded-Proto met de waarde https toe om de app te laten weten dat bezoekers HTTPS gebruiken, zodat hij https://-links en doorverwijzingen bouwt.

Support