Start een tunnel met je SSH-client
Gratis-abonnement HTTP- en TCP-tunnels
Op deze pagina 11 secties
- Wanneer gebruik je het
- Voordat je begint
- Stappen
- Maak een HTTP- of TCP-tunnel aan
- Open de SSH-opdracht
- Kies of hij automatisch opnieuw moet verbinden
- Voer de opdracht uit
- Houd het venster open
- Vanuit de Tunnel-installatiewizard
- De opdracht uitgelegd
- Automatisch opnieuw verbinden
- Hoe lang een opdracht geldig blijft
- Limieten
- Wat je in het dashboard ziet
- Probleemoplossing
- Berichten in het dashboard
- Berichten in de terminal
- Gerelateerde pagina's
Zet een lokale service online zonder Localtonet te installeren. Het dashboard geeft je een kant-en-klare ssh-opdracht; zolang die opdracht draait, is je HTTP- of TCP-tunnel actief.
Wanneer gebruik je het #
Gebruik SSH zonder installatie op een computer waarop je de Localtonet-client niet kunt of wilt installeren, bijvoorbeeld een server die je maar even gebruikt, een streng beveiligde werkcomputer of een snelle demo. Je hebt alleen de ssh-client nodig die bij Windows, macOS en Linux wordt meegeleverd.
De SSH-opdracht vervangt de Localtonet-client voor één tunnel. Al het andere blijft in het dashboard: het adres van de tunnel, de instellingen, de logboeken en de bandbreedte.
| Tunneltype | SSH-opdracht |
|---|---|
| HTTP / HTTPS | Beschikbaar |
| TCP | Beschikbaar |
| UDP, UDP / TCP gemengd, TLS, Bestandsserver, Proxyserver en de andere typen | Niet beschikbaar. Hiervoor is de Localtonet-client nodig. |
Op deze pagina gaat het niet om verbinden met een SSH-server. Wil je je eigen SSH-server via een tunnel publiceren, zie dan Localtonet gebruiken met SSH. Wil je vanuit het dashboard een shell openen op een van je apparaten, zie dan Apparaatterminal.
Voordat je begint #
- Een Localtonet-account en een service die al draait, bijvoorbeeld een webapp op poort 3000.
- Een
ssh-client op de computer die de service kan bereiken. Controleer dit metssh -V. - Uitgaande TCP-verbindingen naar poort
223moeten zijn toegestaan op het netwerk van die computer. - Een AuthToken die door geen enkele actieve Localtonet-client wordt gebruikt. Een tunnel hoort altijd bij een token, maar bij SSH meldt geen enkele client zich ermee aan. Is er een client verbonden met het token van de tunnel, dan geeft het dashboard de opdracht niet uit.
Stappen #
-
Maak een HTTP- of TCP-tunnel aan #
Open Mijn tunnels › HTTP of Mijn tunnels › TCP - UDP (protocol TCP) en maak de tunnel zoals gewoonlijk aan. Lokaal IP-adres en Lokale poort geven aan waarheen de SSH-client het verkeer stuurt:
127.0.0.1en de poort van je service als je de opdracht uitvoert op dezelfde computer als de service. Laat de tunnel gestopt. -
Open de SSH-opdracht #
Selecteer in de tunnellijst Instellingen voor de tunnel en daarna SSH-opdracht tonen. Het dialoogvenster SSH-opdracht opent met de opdracht voor deze tunnel. Een melding vertelt je hoeveel seconden je hebt om de opdracht uit te voeren; een ongebruikte opdracht verloopt, en dan vraag je op dezelfde manier een nieuwe aan.
-
Kies of hij automatisch opnieuw moet verbinden #
Laat Automatisch opnieuw verbinden uit voor de gewone
ssh-opdracht. Zet het aan om de opdracht in een lus te verpakken die hem opnieuw start als de verbinding wegvalt. Kies daarna onder Waar je hem uitvoert voor welke shell de lus wordt geschreven: PowerShell, Opdrachtprompt of macOS of Linux. -
Voer de opdracht uit #
Kopieer de tekst onder Opdracht. Open een terminal op de computer waarop je service draait, plak de opdracht en druk op Enter. Er wordt geen wachtwoord gevraagd. Zodra de verbinding actief is, toont de terminal de eindpunten van de tunnel:
Terminal+--------------------------------------------------------------+ | Welcome to Localtonet! | +--------------------------------------------------------------+ | Localtonet Tunnel Endpoints | +--------------------------------------------------------------+ | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000 | | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000 | +--------------------------------------------------------------+ | Server Time: ... | +--------------------------------------------------------------+ You can view your requests and configure your tunnel settings from the Localtonet Dashboard.Een TCP-tunnel toont in plaats daarvan één regel:
TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>. -
Houd het venster open #
De tunnel start vanzelf zodra de opdracht verbinding maakt; je selecteert dus niet Starten. Hij is online zolang de opdracht draait. Als je het venster sluit, wordt de verbinding verbroken en reageert het openbare adres niet meer. Om de opdracht zelf te beëindigen typ je
exiten druk je op Enter, of druk je op Ctrl + C.Als je de opdracht beëindigt, stopt de tunnel in het dashboard niet. De tunnel blijft gestart, met de verbinding als uit weergegeven, zodat dezelfde opdracht opnieuw kan verbinden. Selecteer in het dashboard Stoppen voor de tunnel als je er klaar mee bent. Het dashboard geeft alleen een nieuwe SSH-opdracht uit voor een gestopte tunnel.
Vanuit de Tunnel-installatiewizard #
De Tunnel-installatiewizard op het Dashboard biedt dezelfde opdracht aan. Selecteer in de laatste stap, waar je je platform kiest, SSH en daarna SSH-opdracht ophalen. De keuze SSH verschijnt alleen voor HTTP- en TCP-tunnels. De wizard toont Wachten op SSH totdat je opdracht verbinding maakt en daarna Verbonden via SSH. Automatisch opnieuw verbinden voegt dezelfde herverbindingslus toe en Nieuwe opdracht ophalen vervangt een opdracht die is verlopen.
De opdracht uitgelegd #
De opdracht heeft altijd deze vorm. Het dashboard vult de waarden voor jouw tunnel in:
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>| Onderdeel | Wat het doet |
|---|---|
-p 223 | Verbindt met poort 223, waar Localtonet deze SSH-verbindingen accepteert. |
-l <COMMAND_KEY> | De inlognaam. Dit is een sleutel die het dashboard voor deze tunnel genereert, niet je AuthToken en niet het wachtwoord van je account. Hij vertelt Localtonet welke tunnel moet worden gestart, en daarom wordt er geen wachtwoord gevraagd. |
<TUNNEL_ADDRESS> | Het adres van je tunnel. De SSH-verbinding gaat naar de server die de tunnel host. |
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT> | De remote forward: verbindingen die op de server voor de tunnel binnenkomen, worden via de SSH-verbinding doorgestuurd naar <LOCAL_IP>:<LOCAL_PORT>. De laatste twee waarden zijn het Lokale IP-adres en de Lokale poort van de tunnel. De serverpoort wordt door Localtonet toegewezen en mag niet worden gewijzigd. |
-o ExitOnForwardFailure=yes | Zorgt dat ssh stopt als de forward niet kan worden ingesteld, in plaats van verbonden te blijven zonder werkende tunnel. |
-o ServerAliveInterval=15 -o ServerAliveCountMax=3 | Stuurt elke 15 seconden een keep-alive en verbreekt de verbinding na drie onbeantwoorde berichten, zodat een dode verbinding binnen ongeveer 45 seconden wordt opgemerkt. |
-o ConnectTimeout=15 | Geeft het op na 15 seconden als de server niet bereikt kan worden. |
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null | Slaat de vraag over de hostsleutel over en schrijft de server niet naar je known_hosts-bestand. |
-o LogLevel=ERROR | Verbergt informatieve berichten van ssh. Fouten worden nog steeds getoond. |
Omdat <LOCAL_IP> wordt omgezet op de computer waarop je ssh uitvoert, hoeft de service niet op die computer te staan. Met een lokaal adres zoals 192.168.1.20 stuurt de opdracht het verkeer door naar een ander apparaat op hetzelfde netwerk.
Deel de opdracht niet. Wie hem uitvoert zolang hij geldig is, beantwoordt het verkeer van je tunnel.
Automatisch opnieuw verbinden #
Met Automatisch opnieuw verbinden aan verpakt het dashboard dezelfde ssh-opdracht in een klein script voor de shell die je hebt gekozen. Voor Opdrachtprompt wordt het script geleverd als één regel powershell -NoProfile -EncodedCommand …. Het script werkt in elke shell hetzelfde:
- Als
ssheindigt, wacht het script even en start het opnieuw. De wachttijd begint bij ongeveer 10 seconden en verdubbelt na elke mislukte poging, tot ongeveer 2 minuten. - Een verbinding die minstens 60 seconden heeft geduurd, telt als geslaagd en zet de wachttijd terug.
- Na 8 pogingen achter elkaar die elk binnen 60 seconden eindigden, stopt het script en toont het
SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.
Opnieuw verbinden gebruikt dezelfde opdracht. Dat werkt na een netwerkonderbreking, maar niet nadat de tunnel in het dashboard is gestopt of een limiet heeft bereikt; in dat geval geeft het script het op en heb je een nieuwe opdracht nodig.
Hoe lang een opdracht geldig blijft #
- Vóór het eerste gebruik: de opdracht moet worden uitgevoerd binnen de tijd die het dashboard toont op het moment dat het hem uitgeeft. Daarna verloopt het poortaanbod.
- Tijdens gebruik: één SSH-sessie per tunnel. Een tweede kopie van de opdracht wordt geweigerd zolang de eerste verbonden is.
- Nadat de verbinding is beëindigd: dezelfde opdracht kan opnieuw verbinden, zolang de tunnel niet in het dashboard is gestopt en er geen limiet is bereikt.
- Na een stop: als de tunnel in het dashboard of door een limiet is gestopt, is de opdracht uitgediend. Open SSH-opdracht tonen opnieuw voor een nieuwe.
Het dashboard geeft alleen een opdracht uit terwijl de tunnel gestopt is. Een nieuwe opdracht kan met een andere serverpoort komen; in het Gratis-abonnement krijgt elke nieuwe opdracht een nieuwe poort. Bij een TCP-tunnel maakt die poort deel uit van het openbare adres, dus controleer het adres in de terminaluitvoer of in de tunnellijst nadat je een nieuwe opdracht hebt aangevraagd. Het activiteitenlogboek van de tunnel registreert de wijziging als Server port changed to "…" for SSH.
Limieten #
- Sessielimiet in het Gratis-abonnement. Een tunnel die via SSH is gestart, volgt dezelfde regel als een tunnel die met de client is gestart: in het Gratis-abonnement stoppen TCP-tunnels na 30 minuten en kunnen ze opnieuw worden gestart, en HTTP-tunnels hebben geen tijdslimiet. De 30 minuten tellen vanaf de eerste keer dat een opdracht verbinding maakt; opnieuw verbinden met dezelfde opdracht start ze niet opnieuw. Als een TCP-sessie de limiet bereikt, sluit de server de SSH-verbinding met het bericht
Session time limit reached. Get a new SSH command from the panel.Zie Abonnementen en saldo. - Bandbreedte. Het verkeer telt mee voor je bandbreedte, net als ander tunnelverkeer. Zonder resterende bandbreedte wordt er geen opdracht uitgegeven en sluit de server een lopende sessie met het bericht
Bandwidth limit reached. Get a new command after bandwidth is available. - Alleen reverse forwarding. Het SSH-eindpunt accepteert alleen de ene forward uit de opdracht. Je krijgt er geen shell op een Localtonet-server en geen andere vorm van forwarding mee.
- Eén tunnel per opdracht. Wil je meerdere tunnels draaien, vraag dan voor elke tunnel een opdracht aan en voer elke opdracht uit in een eigen terminal.
Wat je in het dashboard ziet #
Zolang de opdracht verbonden is, wordt de tunnel als gestart weergegeven en verschijnen verzoeken zoals gewoonlijk in de logboeken. Het Activiteitenlogboek van de tunnel registreert Tunnel started over SSH. wanneer een opdracht verbinding maakt. Zie Logboeken en inspectie.
Probleemoplossing #
Berichten in het dashboard #
| Bericht | Wat je moet doen |
|---|---|
| Stop de tunnel voordat je een SSH-opdracht aanvraagt. | De tunnel draait met de Localtonet-client. Stop hem en selecteer daarna opnieuw SSH-opdracht tonen. |
| Stop de huidige SSH-tunnel voordat je een nieuwe opdracht aanvraagt. | De tunnel is nog via SSH gestart, of er was zojuist nog een SSH-sessie van actief. Beëindig de lopende ssh-opdracht, selecteer Stoppen voor de tunnel en probeer het opnieuw. |
| Er is een client met deze tunnel verbonden via de AuthToken die je hebt aangemaakt. Maak een nieuwe AuthToken aan. | Een Localtonet-client is aangemeld met het token van de tunnel. Stop die client, of maak in Mijn tokens een ander token aan en gebruik dat voor deze tunnel. |
| Je hebt niet genoeg resterende bandbreedte om de tunnel te starten. | Je bandbreedte is op. Zie Abonnementen en saldo. |
| Deze functie is niet beschikbaar voor dit protocoltype. | De tunnel is geen HTTP- of TCP-tunnel. |
| Deze functie is niet beschikbaar op deze server. Verplaats je tunnel naar een andere server. | De server van deze tunnel biedt geen SSH-opdrachten aan. Maak de tunnel aan op een andere server. |
| Er wordt een tunnelbewerking uitgevoerd. Probeer het zo meteen opnieuw. | Wacht een paar seconden en probeer het opnieuw. |
| Er kon geen nieuwe serverpoort worden toegewezen. | Probeer het opnieuw. Blijft het mislukken, maak de tunnel dan aan op een andere server. |
| De SSH-poort kon niet worden opgeslagen. Probeer het opnieuw. | Probeer het opnieuw. |
Berichten in de terminal #
Wanneer de server een sessie sluit, stuurt hij een van onderstaande berichten als reden. Hoe de reden wordt getoond, hangt af van je ssh-client.
| Bericht of symptoom | Oorzaak en oplossing |
|---|---|
ssh eindigt meteen met een verificatiefout, meestal Permission denied | Localtonet heeft de opdracht niet geaccepteerd. Hij is niet op tijd uitgevoerd, de tunnel is sinds het uitgeven gestopt of heeft een limiet bereikt, er is al een andere sessie van dezelfde opdracht verbonden, of de tekst is tijdens het kopiëren gewijzigd. Haal een nieuwe opdracht op uit het dashboard en plak hem ongewijzigd. |
Port mismatch. Get a new SSH command from the panel. | De serverpoort na -R is niet de poort die Localtonet heeft toegewezen. Gebruik de opdracht precies zoals hij is uitgegeven. |
Session time limit reached. Get a new SSH command from the panel. | De sessie van 30 minuten van een TCP-tunnel in het Gratis-abonnement is afgelopen. Vraag een nieuwe opdracht aan om opnieuw te starten. |
Bandwidth limit reached. Get a new command after bandwidth is available. | Je bandbreedte is op. |
Session stopped. Get a new SSH command from the panel. | De tunnel is gestopt, bijvoorbeeld vanuit het dashboard. |
Een time-out voor de verbinding, of Connection refused | De computer kan de server niet bereiken op poort 223. Sta uitgaande TCP-verbindingen naar poort 223 toe in de firewall of probeer het vanaf een ander netwerk. |
| De tunnel is actief, maar bezoekers krijgen een foutmelding | ssh is verbonden, maar kan je service niet bereiken. Controleer of de service draait en of het Lokale IP-adres en de Lokale poort van de tunnel kloppen. Vraag na het wijzigen een nieuwe opdracht aan, want de oude bevat nog de oude waarden. |