Localtonet installeren op Linux
Op deze pagina 9 secties
- Voordat je begint
- Installeren met het script
- Het installatiescript uitvoeren
- De installatie controleren
- Handmatig installeren
- Downloaden en uitpakken
- Optioneel: naar je PATH verplaatsen
- De client starten
- Starten met je token
- De sessie controleren
- Uitvoeren als systemd-service
- De service installeren
- Controleren of de service draait
- Servicecommando's
- De unit en zijn logboeken
- Upgraden
- De client vervangen
- De service herstarten
- Verwijderen
- Probleemoplossing
- Gerelateerde pagina's
Op Linux is de Localtonet-client één consoleprogramma. Installeer het met het installatiescript of vanuit een ZIP-archief, start het met je AuthToken en installeer het als systemd-service als het na elke herstart moet starten.
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.
curlofwget, enunzip.- Voor de systemd-service: rootrechten en een distributie die systemd gebruikt.
Andere manieren om Localtonet op Linux te draaien. Op Debian, Ubuntu, Fedora en RHEL kun je een DEB- of RPM-pakket installeren dat zijn eigen services meebrengt. Er zijn aparte handleidingen voor Docker, OpenWrt-routers en Termux op Android.
Installeren met het script #
-
Het installatiescript uitvoeren #
Terminalcurl -fsSL https://localtonet.com/install.sh | shHet script detecteert je CPU (x64, ARM64 of ARM) en of het systeem glibc of musl gebruikt, downloadt de bijbehorende build en installeert die in
/usr/local/bin/localtonet. Het maakt ook de link/usr/bin/localtonetaan, zodatsudo localtonetwerkt op distributies waarsudoniet in/usr/local/binzoekt.Het script gebruikt
sudoals je gebruiker niet naar de installatiemap kan schrijven, en daarom kan het om je wachtwoord vragen. Ontbreektunzip, dan probeert het die te installeren met de pakketbeheerder van je distributie. -
De installatie controleren #
Het script eindigt met het tonen van de geïnstalleerde versie. Je kunt die op elk moment opnieuw tonen:
Terminallocaltonet --version
Handmatig installeren #
Wil je liever rechtstreeks downloaden, pak dan het archief voor jouw systeem. Elke ZIP bevat één bestand, localtonet.
| CPU | glibc (Debian, Ubuntu, Fedora, RHEL en de meeste andere) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32-bits) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m toont je CPU-type: x86_64 is x64, aarch64 is ARM64 en armv7l is ARM.
-
Downloaden en uitpakken #
Het voorbeeld gebruikt de x64 glibc-build. Vervang de bestandsnaam door het archief voor jouw systeem.
Terminalwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Optioneel: naar je PATH verplaatsen #
Zonder deze stap start je de client via zijn pad,
~/localtonet/localtonet. Daarna kun jelocaltonetin elke map typen.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
De client starten #
-
Starten met je token #
Terminallocaltonet --authtoken <YOUR_TOKEN>De client slaat het token lokaal op voor je gebruiker. 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 #
De terminal 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, zie Snelstart.Druk op Ctrl + C om de client te stoppen. Druk op F12 om het opgeslagen token te verwijderen en af te sluiten.
Is de uitvoer geen terminal, bijvoorbeeld wanneer je hem naar een bestand omleidt, dan schrijft de client per wijziging één gewone regel in plaats van de tabel.
VPN heeft root nodig. Is het apparaat onderdeel van een netwerk in VPN-beheer en draait de client zonder root, dan toont de VPN-rij van de tabel Admin rights required. Start de client in dat geval met sudo of als service.
Uitvoeren als systemd-service #
Een service start Localtonet na elke herstart, houdt het draaiend nadat je bent uitgelogd en heeft geen geopende terminal nodig. De servicecommando's hebben root nodig.
-
De service installeren #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>Het commando schrijft een systemd-unit voor dit token, schakelt die in en start hem meteen. Het antwoordt met de naam van de unit:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>zijn de eerste 9 tekens van je token. Elk token krijgt een eigen unit, dus de andere servicecommando's hebben hetzelfde--authtokennodig om de unit te vinden. -
Controleren of de service draait #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Een draaiende service antwoordt
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. In het dashboard toont het token Online onder Mijn tokens.
Servicecommando's #
Voer elk commando uit met sudo en voeg --authtoken <YOUR_TOKEN> toe.
| Commando | Wat het doet |
|---|---|
--install-service | Schrijft het unitbestand, schakelt de unit in en start hem. |
--start-service | Start de unit, bijvoorbeeld nadat je hem hebt gestopt. |
--stop-service | Stopt de unit. Hij blijft ingeschakeld en start na een herstart weer. |
--status-service | Toont de status, bijvoorbeeld Running, Stopped of Error als de unit is mislukt. |
--remove-service | Stopt en schakelt de unit uit en verwijdert het unitbestand. |
De service wordt geïnstalleerd met de opties die je samen met --install-service meegeeft. De opties staan in de CLI-referentie.
De unit en zijn logboeken #
Het unitbestand is /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd start de client vijf seconden na een fout opnieuw. Omdat het een gewone systemd-unit is, kun je hem ook beheren met systemctl en de uitvoer lezen met journalctl:
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fDe unit start het bestand localtonet vanaf het pad dat het had toen je de service installeerde. Eén uitzondering: staat dat pad onder /root/, dan kopieert het installatiecommando het bestand naar /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ en draait de service de kopie.
Upgraden #
-
De client vervangen #
Voer het installatiescript opnieuw uit. Dat kan veilig opnieuw en overschrijft de geïnstalleerde client met de actuele versie. Download na een handmatige installatie het actuele archief en vervang het bestand
localtonet.Terminalcurl -fsSL https://localtonet.com/install.sh | sh -
De service herstarten #
Een draaiende service blijft de oude versie gebruiken totdat hij opnieuw start.
Terminalsudo systemctl restart Localtonet_<TOKEN_PREFIX>Draait de service een kopie onder
/usr/local/lib/, verwijder dan de service en installeer hem opnieuw met de nieuwe client.
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:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Om het opgeslagen token te verwijderen, start je de client en druk je op F12.
- Verwijder de client:
sudo rm /usr/local/bin/localtonet /usr/bin/localtonetna de scriptinstallatie, of de map waarin je het archief hebt uitgepakt.
Probleemoplossing #
Installatiescript: Unsupported architecture
Het script heeft builds voor x64 (x86_64), ARM64 (aarch64) en 32-bits ARM (armv7l). Andere CPU-typen worden niet ondersteund door de Linux-builds.
Installatiescript: Neither curl nor wget found
Installeer curl of wget met je pakketbeheerder en voer het script opnieuw uit.
Installatiescript: Failed to install 'unzip'
Het script kon unzip niet zelf installeren. Installeer het met je pakketbeheerder en voer het script opnieuw uit.
Installed but not found in PATH
Open een nieuwe shell, of start de client via het volledige pad, /usr/local/bin/localtonet.
sudo: localtonet: command not found
Na een handmatige installatie staat de client niet in het zoekpad van sudo. Gebruik het volledige pad, bijvoorbeeld sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, of verplaats het bestand eerst naar /usr/local/bin.
Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.
Het commando is zonder root uitgevoerd. Herhaal het met sudo. Hetzelfde geldt voor --start-service, --stop-service en --remove-service.
Install failed: Systemd unit already exists for 'Localtonet_…'
Er is voor dit token al een service geïnstalleerd. Controleer die met --status-service. Om hem opnieuw te installeren, voer je eerst --remove-service uit.
De servicecommando's mislukken op een systeem zonder systemd
De servicemodus gebruikt systemd. Start de client op systemen zonder systemd op een andere manier, bijvoorbeeld in een Docker-container. De consoleclient heeft hiervoor een headless-modus: --headless draait zonder prompts en leest het token uit een bestand dat je opgeeft met --authtoken-file. 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 andere Localtonet-client op deze machine draait al met hetzelfde token. Sluit hem, of start deze met een ander token. Gebruik één draaiende client per token.