Localtonet installeren op Windows
Op deze pagina 9 secties
- Voordat je begint
- Een build kiezen
- De app gebruiken
- De app installeren en openen
- Inloggen met je token
- Een tunnel starten
- De consoleclient gebruiken
- Downloaden en uitpakken
- Starten met je token
- De sessie controleren
- Uitvoeren als Windows-service
- De service installeren
- Controleren of de service draait
- Servicecommando's
- Bijwerken
- Verwijderen
- Probleemoplossing
- Gerelateerde pagina's
Op Windows kun je de Localtonet-app uit de Microsoft Store gebruiken, een draagbare build van dezelfde app, of de consoleclient. De consoleclient kan zichzelf ook installeren als Windows-service die bij elke start van de computer wordt gestart.
Voordat je begint #
- Een Localtonet-account. Maak er gratis een aan als je er nog geen hebt.
- Je AuthToken. Selecteer Kopiëren op de kaart AuthToken van het Dashboard, of kopieer een token uit Mijn tokens.
- Voor de Windows-service: een Opdrachtprompt- of PowerShell-venster dat als administrator wordt uitgevoerd.
Een build kiezen #
| Build | Downloaden | Opmerkingen |
|---|---|---|
| Microsoft Store-app | Localtonet in de Microsoft Store | Een appvenster met een inlogscherm. Vereist Windows 10 versie 1809 (build 17763) of nieuwer. |
| Desktop-app, draagbare ZIP | x64, x86, ARM64 | Dezelfde app zonder de Store. Pak de ZIP uit en start de app vanuit de uitgepakte map. |
| Consoleclient | 64-bits, 32-bits, ARM64 | Een ZIP met één bestand, localtonet.exe. Dit is de build met de servicecommando's. |
De pagina Downloads biedt de Microsoft Store-app en de drie consolebuilds onder Binaries.
De app gebruiken #
-
De app installeren en openen #
Installeer Localtonet vanuit de Microsoft Store, of pak de draagbare ZIP uit en start de app. De app opent op het scherm Sign in to Localtonet.
-
Inloggen met je token #
Plak je AuthToken in het veld Authtoken or PIN en selecteer Connect. Staat het token op het klembord wanneer het scherm opent, dan vult de app het voor je in. In plaats van het token kun je de pincode van 6 cijfers typen die Mijn tokens voor een token toont. Een pincode is één minuut geldig.
Antwoordt de app met
Pin or authtoken is not valid., kopieer het token dan opnieuw en controleer of alle 33 tekens aanwezig zijn. -
Een tunnel starten #
Nadat je bent ingelogd, toont de app de tunnels die op dit apparaat draaien. Zolang de lijst No active tunnels meldt, maak je in het dashboard een tunnel aan en start je die, zie Snelstart. Met Sign Out verwijder je het token uit de app, met Quit Localtonet sluit je de app.
De consoleclient gebruiken #
-
Downloaden en uitpakken #
Download de ZIP voor je CPU en pak hem uit in een map die op zijn plaats blijft, bijvoorbeeld
C:\Localtonet. Een service die je later installeert, startlocaltonet.exevanuit deze map. -
Starten met je token #
Open Opdrachtprompt of PowerShell in die map en voer uit:
Opdrachtpromptlocaltonet --authtoken <YOUR_TOKEN>PowerShell voert een programma alleen uit de huidige map uit als je het pad opgeeft, dus daar is het commando:
PowerShell.\localtonet --authtoken <YOUR_TOKEN>De client slaat het token lokaal op. De volgende keer kun je hem starten met alleen
localtonet. Start je hem zonder opgeslagen token, dan vraagt hijPlease Enter AuthToken or PIN. -
De sessie controleren #
Het venster toont
Session Status: Connectedboven een tabel met een rij per draaiende tunnel:IP/Url,Protocol,Client IP,Client Port,PingenStatus. De tabel is leeg totdat je in het dashboard een tunnel start. De naam van je token staat onder de tabel.Druk op Ctrl + C om de client te stoppen. Druk op F12 om het opgeslagen token te verwijderen en af te sluiten.
Uitvoeren als Windows-service #
Een service start Localtonet bij elke start van de computer, houdt het draaiend nadat je bent uitgelogd en heeft geen geopende terminal nodig. Voer deze commando's uit met de consoleclient, in een Opdrachtprompt of PowerShell die als administrator wordt uitgevoerd.
-
De service installeren #
Opdrachtprompt (administrator)localtonet --install-service --authtoken <YOUR_TOKEN>Het commando registreert een Windows-service voor dit token, stelt het opstarttype in op automatisch en start de service meteen. Het antwoordt met de naam van de service:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>zijn de eerste 9 tekens van je token. Elk token krijgt een eigen service, dus de andere servicecommando's hebben hetzelfde--authtokennodig om de service te vinden. -
Controleren of de service draait #
Opdrachtprompt (administrator)localtonet --status-service --authtoken <YOUR_TOKEN>Een draaiende service antwoordt
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. De service is ook zichtbaar inservices.msconder dezelfde naam, met de beschrijvingLocaltonet Service. In het dashboard toont het token Online onder Mijn tokens.
Servicecommando's #
Voeg --authtoken <YOUR_TOKEN> toe aan elk commando.
| Commando | Wat het doet | Administrator vereist |
|---|---|---|
--install-service | Maakt de service aan met automatisch opstarten en start hem. Windows start de service een minuut na een fout opnieuw. | Ja |
--start-service | Start de geïnstalleerde service, bijvoorbeeld nadat je hem hebt gestopt. | Ja |
--stop-service | Stopt de service. Hij start weer bij de volgende keer opstarten. | Ja |
--status-service | Toont de status: Running, Stopped, Installing terwijl de service start, Paused, NotFound als er voor dit token geen service bestaat, Error of Unknown. | Nee |
--remove-service | Stopt de service en verwijdert hem. | Ja |
De service wordt geïnstalleerd met de opties die je samen met --install-service meegeeft, dus voeg clientopties zoals --net en --ip toe aan dat commando. De opties staan in de CLI-referentie.
De service voert localtonet.exe uit vanuit de map waarin het bestand stond toen je de service installeerde, met het token als onderdeel van het startcommando. Verplaats of verwijder het bestand niet zolang de service is geïnstalleerd.
Bijwerken #
- Microsoft Store-app: de Microsoft Store werkt de app bij.
- Consoleclient en draagbare app: download de actuele ZIP van de pagina Downloads en vervang de oude bestanden. Windows laat je
localtonet.exeniet vervangen terwijl het draait, dus sluit eerst de client. Draait hij als service, voer dan--stop-serviceuit, vervang het bestand en voer daarna--start-serviceuit.
localtonet --version toont de geïnstalleerde versie. Onder Mijn tokens toont de kolom Client de versie die het apparaat het laatst heeft gemeld en een badge Update nodig wanneer er een nieuwere beschikbaar is.
Verwijderen #
- Als je de service hebt geïnstalleerd, verwijder die dan:
localtonet --remove-service --authtoken <YOUR_TOKEN>als administrator. - Om het opgeslagen token te verwijderen, start je de consoleclient en druk je op F12.
- Verwijder de map met
localtonet.exe, of verwijder de Store-app via Windows-instellingen.
Probleemoplossing #
'localtonet' wordt niet herkend
De terminal staat niet in de map die localtonet.exe bevat, of je zit in PowerShell. Ga eerst naar de map. Start de client in PowerShell als .\localtonet.
Install failed: 'Windows service installation' requires elevated (admin/root) privileges.
De terminal wordt niet als administrator uitgevoerd. Open Opdrachtprompt of PowerShell met Als administrator uitvoeren en herhaal het commando. --start-service, --stop-service en --remove-service antwoorden met hetzelfde soort melding.
Install failed: Service 'Localtonet_…' already exists.
Er is voor dit token al een service geïnstalleerd. Controleer die met --status-service. Om hem opnieuw te installeren, bijvoorbeeld met andere opties of vanuit een andere map, voer je eerst --remove-service uit.
Start failed: Service could not be started
De melding bevat het antwoord van het Windows-hulpprogramma sc. Fout 1056 betekent dat de service al draait. Dat is normaal als je --start-service direct na --install-service uitvoert, omdat het installatiecommando de service al start. Fout 1060 betekent dat er voor dit token geen service bestaat.
De status is NotFound, maar ik heb de service geïnstalleerd
De servicenaam wordt uit het token opgebouwd. Geef je een ander token op dan waarmee je de service hebt geïnstalleerd, dan zoekt de client naar een andere service. Gebruik hetzelfde token, of zoek in services.msc naar een service die met Localtonet_ begint.
Service installation cannot persist proxy passwords.
Je hebt --install-service gecombineerd met --proxy-user of met een proxy-URL die een wachtwoord bevat. Een service wordt niet met proxywachtwoorden geïnstalleerd. Gebruik --proxy env en geef de inloggegevens op in de omgeving van de service. Zie de CLI-referentie.
Wrong Token!
De client verwacht het AuthToken van 33 tekens uit Mijn tokens, of een pincode van 6 cijfers die nog niet is verlopen. Kopieer het token opnieuw en voer het in bij de prompt.
This token is used in another localtonet application!
Een ander Localtonet-venster op deze computer draait al met hetzelfde token. Sluit het, of start dit venster met een ander token. Gebruik één draaiende client per token.
Het token blijft Offline in het dashboard
Offline betekent dat het apparaat is losgekoppeld. Controleer of het clientvenster nog open is of de servicestatus Running is, en of de client is gestart met het token waar je naar kijkt.