Naar de inhoud
Localtonet Localtonet Dashboard

Localtonet installeren op Linux

Hulp bij deze pagina
Op deze pagina 9 secties
  1. Voordat je begint
  2. Installeren met het script
  3. Het installatiescript uitvoeren
  4. De installatie controleren
  5. Handmatig installeren
  6. Downloaden en uitpakken
  7. Optioneel: naar je PATH verplaatsen
  8. De client starten
  9. Starten met je token
  10. De sessie controleren
  11. Uitvoeren als systemd-service
  12. De service installeren
  13. Controleren of de service draait
  14. Servicecommando's
  15. De unit en zijn logboeken
  16. Upgraden
  17. De client vervangen
  18. De service herstarten
  19. Verwijderen
  20. Probleemoplossing
  21. 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.
  • curl of wget, en unzip.
  • 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 #

  1. Het installatiescript uitvoeren #

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh

    Het 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/localtonet aan, zodat sudo localtonet werkt op distributies waar sudo niet in /usr/local/bin zoekt.

    Het script gebruikt sudo als je gebruiker niet naar de installatiemap kan schrijven, en daarom kan het om je wachtwoord vragen. Ontbreekt unzip, dan probeert het die te installeren met de pakketbeheerder van je distributie.

  2. De installatie controleren #

    Het script eindigt met het tonen van de geïnstalleerde versie. Je kunt die op elk moment opnieuw tonen:

    Terminal
    localtonet --version

Handmatig installeren #

Wil je liever rechtstreeks downloaden, pak dan het archief voor jouw systeem. Elke ZIP bevat één bestand, localtonet.

uname -m toont je CPU-type: x86_64 is x64, aarch64 is ARM64 en armv7l is ARM.

  1. Downloaden en uitpakken #

    Het voorbeeld gebruikt de x64 glibc-build. Vervang de bestandsnaam door het archief voor jouw systeem.

    Terminal
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Optioneel: naar je PATH verplaatsen #

    Zonder deze stap start je de client via zijn pad, ~/localtonet/localtonet. Daarna kun je localtonet in elke map typen.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

De client starten #

  1. Starten met je token #

    Terminal
    localtonet --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 hij Please Enter AuthToken or PIN.

  2. De sessie controleren #

    De terminal toont Session Status: Connected boven een tabel met een rij per draaiende tunnel: IP/Url, Protocol, Client IP, Client Port, Ping en Status. 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.

  1. De service installeren #

    Terminal
    sudo 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 --authtoken nodig om de unit te vinden.

  2. Controleren of de service draait #

    Terminal
    sudo 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.

CommandoWat het doet
--install-serviceSchrijft het unitbestand, schakelt de unit in en start hem.
--start-serviceStart de unit, bijvoorbeeld nadat je hem hebt gestopt.
--stop-serviceStopt de unit. Hij blijft ingeschakeld en start na een herstart weer.
--status-serviceToont de status, bijvoorbeeld Running, Stopped of Error als de unit is mislukt.
--remove-serviceStopt 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:

Terminal
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

De 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 #

  1. 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.

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh
  2. De service herstarten #

    Een draaiende service blijft de oude versie gebruiken totdat hij opnieuw start.

    Terminal
    sudo 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 #

  1. Als je de service hebt geïnstalleerd, verwijder die dan: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Om het opgeslagen token te verwijderen, start je de client en druk je op F12.
  3. Verwijder de client: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet na 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.

Support