Naar de inhoud
Localtonet Localtonet Dashboard

Localtonet installeren vanuit een DEB- of RPM-pakket

Hulp bij deze pagina
Op deze pagina 9 secties
  1. Voordat je begint
  2. Wat het pakket installeert
  3. Stappen
  4. Het pakket downloaden en installeren
  5. Je AuthToken instellen
  6. De configuratie controleren
  7. Een service inschakelen
  8. Een tunnel starten
  9. Tunnelservice of VPN-service
  10. Hoe de services draaien
  11. Het logboek lezen
  12. Upgraden
  13. Verwijderen
  14. Probleemoplossing
  15. Gerelateerde pagina's

De DEB- en RPM-pakketten installeren de Localtonet-client samen met twee systemd-services, één voor tunnels en één voor tunnels plus VPN. De services lezen je AuthToken uit een bestand en draaien zonder terminal, zodat de client bij elke opstart start.

Voordat je begint #

  • Een 64-bits Linuxsysteem: de pakketten bestaan voor x64 en ARM64.
  • systemd 247 of nieuwer en OpenSSL 3, zoals Debian 12, Ubuntu 22.04+ of RHEL 9.
  • Rootrechten (sudo).
  • Je AuthToken. Kies Kopiëren op de kaart AuthToken van het Dashboard, of kopieer een token uit Mijn tokens.

Gebruik op andere distributies, op 32-bits ARM, of als je geen systeempakket wilt, het installatiescript of de archieven die beschreven staan op Linux.

Wat het pakket installeert #

PadWat het is
/usr/bin/localtonetDe opdracht localtonet.
/usr/lib/localtonet/De client zelf.
/usr/lib/systemd/system/localtonet.serviceDe tunnelservice.
/usr/lib/systemd/system/localtonet-vpn.serviceDe VPN- en tunnelservice.
/etc/localtonet/auth-tokenHet tokenbestand. Alleen root kan het lezen. Het wordt geïnstalleerd met de tijdelijke waarde DUMMY_AUTH_TOKEN.

Het pakket heet localtonet. De afhankelijkheden ervan, waaronder OpenSSL 3, iproute2 (iproute in de RPM), iptables en kmod, worden door je pakketbeheerder geïnstalleerd. Het installeren van het pakket schakelt geen service in en start er geen: je stelt eerst het token in en schakelt daarna de service in die je nodig hebt.

Stappen #

  1. Het pakket downloaden en installeren #

    Kies het pakket voor je distributie en cpu in de lijst aan het einde van deze pagina en installeer het gedownloade bestand daarna met apt (DEB) of dnf (RPM). Installatie-instructies onder elk pakket toont de exacte opdrachten voor dat bestand.

  2. Je AuthToken instellen #

    Bewerk /etc/localtonet/auth-token als root met een teksteditor en vervang DUMMY_AUTH_TOKEN door je token op één regel. Zorg er daarna voor dat alleen root het bestand kan lezen:

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. De configuratie controleren #

    Terminal
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    De controle leest het tokenbestand zonder verbinding te maken. Ze antwoordt Localtonet headless configuration OK. wanneer het bestand een token van 33 tekens zonder spaties bevat. Ze vraagt de Localtonet-servers niet of het token geldig is voor je account.

  4. Een service inschakelen #

    Schakel voor tunnels de tunnelservice in en lees het logboek ervan:

    Terminal
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Als dit apparaat ook deelneemt aan een VPN-netwerk, schakel dan in plaats daarvan de VPN-service in. Zie Tunnelservice of VPN-service.

  5. Een tunnel starten #

    Het token staat nu als Online onder Mijn tokens. Maak er in het dashboard een tunnel voor aan en start die, zie Snelstart.

Tunnelservice of VPN-service #

Beide services draaien dezelfde client en beide bedienen je tunnels. Ze verschillen in de rechten waarmee ze draaien. Schakel er één in: de twee services botsen en het starten van de ene stopt de andere.

localtonet.servicelocaltonet-vpn.service
Gebruik het voorTunnelsVPN en tunnels
Draait alsEen gebruiker zonder bijzondere rechten die systemd voor de service aanmaaktroot, beperkt tot de netwerkmogelijkheden CAP_NET_ADMIN en CAP_NET_RAW
TUN-moduleNiet gebruiktGeladen met modprobe tun voordat de client start
Werkmap/var/lib/localtonet/var/lib/localtonet-vpn

Zo schakel je een apparaat over van de tunnelservice naar de VPN-service:

Terminal
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

Om terug te schakelen, schakel je localtonet-vpn.service uit en localtonet.service op dezelfde manier in. VPN-netwerken zelf stel je in het dashboard in, zie VPN-beheer.

Hoe de services draaien #

GedragDetails
Headless-modusBeide services starten localtonet --headless. In deze modus vraagt de client nooit iets en slaat hij het token niet op in zijn eigen instellingen.
Tokensystemd geeft /etc/localtonet/auth-token door aan de service. Een service start niet zolang het bestand ontbreekt.
Starten bij het opstartenEen ingeschakelde service start nadat het netwerk beschikbaar is.
Herstartensystemd herstart de client tien seconden na een fout. Hij herstart hem niet wanneer de client stopt vanwege een ongeldig tokenbestand. Corrigeer het bestand en herstart de service zelf.

Het logboek lezen #

In headless-modus schrijft de client gewone regels naar het journal, één per wijziging:

Terminal
sudo journalctl -u localtonet.service -f
RegelBetekenis
Connection: ConnectedDe status van de sessie. Andere waarden zijn Connecting en Disconnected.
AuthTokenName: …De naam van het token waarmee de client is ingelogd.
OPEN …, ADDED …Een tunnel die op dit apparaat draait, met zijn openbare adres, protocol en lokale doel.
STATUS …Een tunnel heeft zijn status gewijzigd.
CLOSED …Een tunnel is gestopt of verwijderd.
Authentication failed: AuthToken was rejected.Het token in het bestand wordt niet geaccepteerd. Kopieer het opnieuw uit Mijn tokens.

Als een van deze regels het token zou bevatten, schrijft de client daarvoor in de plaats [redacted].

Upgraden #

Download het nieuwe pakket en installeer het op dezelfde manier als de eerste keer, en herstart daarna de service die je gebruikt. Je tokenbestand blijft behouden.

Tunnelservice
sudo systemctl restart localtonet
VPN-service
sudo systemctl restart localtonet-vpn.service

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 #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

Het verwijderen van het pakket stopt en schakelt beide services uit. Het tokenbestand is een configuratiebestand en pakketbeheerders behandelen die met zorg: controleer na het verwijderen of /etc/localtonet/auth-token of een opgeslagen kopie ervan er nog is, en verwijder het als je niet wilt dat het token op de machine blijft.

Probleemoplossing #

Invalid Localtonet headless configuration. Check the token file or environment settings.

Het tokenbestand is niet bruikbaar. Controleer of /etc/localtonet/auth-token bestaat, of de tijdelijke waarde DUMMY_AUTH_TOKEN weg is en of het bestand alleen het token van 33 tekens bevat, zonder spaties en op één regel. Voer de controle uit met sudo, omdat alleen root het bestand kan lezen.

De service is ingeschakeld maar draait niet

Voer systemctl status localtonet.service uit. Een service start niet zolang /etc/localtonet/auth-token ontbreekt en wordt niet herstart nadat hij is gestopt vanwege een ongeldig tokenbestand. Corrigeer het bestand, voer de configuratiecontrole uit en voer daarna sudo systemctl restart localtonet.service uit.

Het logboek meldt: Authentication failed: AuthToken was rejected.

Het bestand heeft het juiste formaat, maar het token wordt niet geaccepteerd. Kopieer het token opnieuw uit Mijn tokens, sla het op in het tokenbestand en herstart de service.

De tunnelservice stopte toen ik de VPN-service startte

Dat is de bedoeling. De twee services botsen, dus systemd stopt de ene wanneer de andere start. De VPN-service bedient ook je tunnels.

Het pakket installeert niet op mijn distributie

De pakketten hebben systemd 247 of nieuwer en OpenSSL 3 nodig. Op oudere releases kan de pakketbeheerder deze afhankelijkheden niet vervullen. Gebruik in plaats daarvan het installatiescript of een archief van de pagina Linux.

De pakketten staan hieronder. Kies Installatie-instructies onder een pakket voor de opdrachten met de bestandsnaam ervan.

Linux-pakketten

Installeerbare DEB- en RPM-pakketten voor x64 en ARM64. Vereist systemd 247 of nieuwer en OpenSSL 3, zoals Debian 12, Ubuntu 22.04+ of RHEL 9.

  • Debian / Ubuntu · x64
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-linux-x64.deb.

    sudo apt install ./localtonet-linux-x64.deb

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Schakel voor VPN over naar de VPN-service:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Om te upgraden installeer je het nieuwe pakket en voer je sudo systemctl restart localtonet uit. Je configuratie blijft behouden.

    Gebruik je VPN, herstart dan in plaats daarvan localtonet-vpn.service.

  • Debian / Ubuntu · ARM64
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-linux-arm64.deb.

    sudo apt install ./localtonet-linux-arm64.deb

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Schakel voor VPN over naar de VPN-service:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Om te upgraden installeer je het nieuwe pakket en voer je sudo systemctl restart localtonet uit. Je configuratie blijft behouden.

    Gebruik je VPN, herstart dan in plaats daarvan localtonet-vpn.service.

  • Fedora / RHEL · x64
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-linux-x64.rpm.

    sudo dnf install ./localtonet-linux-x64.rpm

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Schakel voor VPN over naar de VPN-service:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Om te upgraden installeer je het nieuwe pakket en voer je sudo systemctl restart localtonet uit. Je configuratie blijft behouden.

    Gebruik je VPN, herstart dan in plaats daarvan localtonet-vpn.service.

  • Fedora / RHEL · ARM64
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-linux-arm64.rpm.

    sudo dnf install ./localtonet-linux-arm64.rpm

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Schakel voor VPN over naar de VPN-service:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Om te upgraden installeer je het nieuwe pakket en voer je sudo systemctl restart localtonet uit. Je configuratie blijft behouden.

    Gebruik je VPN, herstart dan in plaats daarvan localtonet-vpn.service.

Support