Localtonet installeren vanuit een DEB- of RPM-pakket
Op deze pagina 9 secties
- Voordat je begint
- Wat het pakket installeert
- Stappen
- Het pakket downloaden en installeren
- Je AuthToken instellen
- De configuratie controleren
- Een service inschakelen
- Een tunnel starten
- Tunnelservice of VPN-service
- Hoe de services draaien
- Het logboek lezen
- Upgraden
- Verwijderen
- Probleemoplossing
- 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 #
| Pad | Wat het is |
|---|---|
/usr/bin/localtonet | De opdracht localtonet. |
/usr/lib/localtonet/ | De client zelf. |
/usr/lib/systemd/system/localtonet.service | De tunnelservice. |
/usr/lib/systemd/system/localtonet-vpn.service | De VPN- en tunnelservice. |
/etc/localtonet/auth-token | Het 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 #
-
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) ofdnf(RPM). Installatie-instructies onder elk pakket toont de exacte opdrachten voor dat bestand. -
Je AuthToken instellen #
Bewerk
/etc/localtonet/auth-tokenals root met een teksteditor en vervangDUMMY_AUTH_TOKENdoor je token op één regel. Zorg er daarna voor dat alleen root het bestand kan lezen:Terminalsudo chmod 600 /etc/localtonet/auth-token -
De configuratie controleren #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configDe 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. -
Een service inschakelen #
Schakel voor tunnels de tunnelservice in en lees het logboek ervan:
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceAls dit apparaat ook deelneemt aan een VPN-netwerk, schakel dan in plaats daarvan de VPN-service in. Zie Tunnelservice of VPN-service.
-
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.service | localtonet-vpn.service | |
|---|---|---|
| Gebruik het voor | Tunnels | VPN en tunnels |
| Draait als | Een gebruiker zonder bijzondere rechten die systemd voor de service aanmaakt | root, beperkt tot de netwerkmogelijkheden CAP_NET_ADMIN en CAP_NET_RAW |
| TUN-module | Niet gebruikt | Geladen 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:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.serviceOm 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 #
| Gedrag | Details |
|---|---|
| Headless-modus | Beide services starten localtonet --headless. In deze modus vraagt de client nooit iets en slaat hij het token niet op in zijn eigen instellingen. |
| Token | systemd geeft /etc/localtonet/auth-token door aan de service. Een service start niet zolang het bestand ontbreekt. |
| Starten bij het opstarten | Een ingeschakelde service start nadat het netwerk beschikbaar is. |
| Herstarten | systemd 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:
sudo journalctl -u localtonet.service -f| Regel | Betekenis |
|---|---|
Connection: Connected | De 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.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceOnder 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 #
sudo apt remove localtonetsudo dnf remove localtonetHet 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.
Gerelateerde pagina's #
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.deb2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. Start de service. Zodra de configuratiecontrole slaagt:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSchakel 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.serviceOm te upgraden installeer je het nieuwe pakket en voer je
sudo systemctl restart localtonetuit. 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.deb2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. Start de service. Zodra de configuratiecontrole slaagt:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSchakel 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.serviceOm te upgraden installeer je het nieuwe pakket en voer je
sudo systemctl restart localtonetuit. 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.rpm2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. Start de service. Zodra de configuratiecontrole slaagt:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSchakel 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.serviceOm te upgraden installeer je het nieuwe pakket en voer je
sudo systemctl restart localtonetuit. 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.rpm2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. Start de service. Zodra de configuratiecontrole slaagt:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSchakel 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.serviceOm te upgraden installeer je het nieuwe pakket en voer je
sudo systemctl restart localtonetuit. Je configuratie blijft behouden.Gebruik je VPN, herstart dan in plaats daarvan
localtonet-vpn.service.