Localtonet aus einem DEB- oder RPM-Paket installieren
Auf dieser Seite 9 Abschnitte
- Bevor Sie beginnen
- Was das Paket installiert
- Schritte
- Das Paket herunterladen und installieren
- Ihren AuthToken festlegen
- Die Konfiguration prüfen
- Einen Dienst aktivieren
- Einen Tunnel starten
- Tunnel-Dienst oder VPN-Dienst
- Wie die Dienste laufen
- Das Protokoll lesen
- Aktualisieren
- Entfernen
- Fehlerbehebung
- Verwandte Seiten
Die DEB- und RPM-Pakete installieren den Localtonet-Client zusammen mit zwei systemd-Diensten, einem für Tunnel und einem für Tunnel plus VPN. Die Dienste lesen Ihren AuthToken aus einer Datei und laufen ohne Terminal, sodass der Client bei jedem Systemstart startet.
Bevor Sie beginnen #
- Ein 64-Bit-Linux-System: Die Pakete gibt es für x64 und ARM64.
- systemd 247 oder neuer und OpenSSL 3, etwa Debian 12, Ubuntu 22.04+ oder RHEL 9.
- Root-Zugriff (
sudo). - Ihr AuthToken. Wählen Sie Kopieren auf der Karte AuthToken im Dashboard oder kopieren Sie ein Token aus Meine Tokens.
Auf anderen Distributionen, auf 32-Bit-ARM oder wenn Sie kein Systempaket möchten, verwenden Sie das Installationsskript oder die Archive, die unter Linux beschrieben sind.
Was das Paket installiert #
| Pfad | Was es ist |
|---|---|
/usr/bin/localtonet | Der Befehl localtonet. |
/usr/lib/localtonet/ | Der Client selbst. |
/usr/lib/systemd/system/localtonet.service | Der Tunnel-Dienst. |
/usr/lib/systemd/system/localtonet-vpn.service | Der VPN- und Tunnel-Dienst. |
/etc/localtonet/auth-token | Die Token-Datei. Nur root kann sie lesen. Sie wird mit dem Platzhalter DUMMY_AUTH_TOKEN installiert. |
Das Paket heißt localtonet. Seine Abhängigkeiten, darunter OpenSSL 3, iproute2 (iproute im RPM), iptables und kmod, installiert Ihr Paketmanager. Die Installation des Pakets aktiviert oder startet keinen Dienst: Sie legen zuerst das Token fest und aktivieren dann den Dienst, den Sie benötigen.
Schritte #
-
Das Paket herunterladen und installieren #
Wählen Sie das Paket für Ihre Distribution und Ihre CPU aus der Liste am Ende dieser Seite und installieren Sie die heruntergeladene Datei dann mit
apt(DEB) oderdnf(RPM). Einrichtungsanleitung unter jedem Paket zeigt die genauen Befehle für diese Datei. -
Ihren AuthToken festlegen #
Bearbeiten Sie
/etc/localtonet/auth-tokenals root mit einem Texteditor und ersetzen SieDUMMY_AUTH_TOKENin einer einzigen Zeile durch Ihr Token. Stellen Sie dann sicher, dass nur root die Datei lesen kann:Terminalsudo chmod 600 /etc/localtonet/auth-token -
Die Konfiguration prüfen #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configDie Prüfung liest die Token-Datei, ohne eine Verbindung aufzubauen. Sie antwortet
Localtonet headless configuration OK., wenn die Datei ein 33-stelliges Token ohne Leerzeichen enthält. Sie fragt die Localtonet-Server nicht, ob das Token für Ihr Konto gültig ist. -
Einen Dienst aktivieren #
Aktivieren Sie für Tunnel den Tunnel-Dienst und lesen Sie sein Protokoll:
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceTritt dieses Gerät außerdem einem VPN-Netzwerk bei, aktivieren Sie stattdessen den VPN-Dienst. Siehe Tunnel-Dienst oder VPN-Dienst.
-
Einen Tunnel starten #
Das Token zeigt jetzt unter Meine Tokens Online an. Erstellen und starten Sie im Dashboard einen Tunnel dafür, siehe Schnellstart.
Tunnel-Dienst oder VPN-Dienst #
Beide Dienste führen denselben Client aus, und beide bedienen Ihre Tunnel. Sie unterscheiden sich in den Rechten, mit denen sie laufen. Aktivieren Sie einen von beiden: Die beiden Dienste schließen sich gegenseitig aus, und das Starten des einen stoppt den anderen.
localtonet.service | localtonet-vpn.service | |
|---|---|---|
| Verwendung für | Tunnel | VPN und Tunnel |
| Läuft als | Ein nicht privilegierter Benutzer, den systemd für den Dienst anlegt | root, beschränkt auf die Netzwerkfähigkeiten CAP_NET_ADMIN und CAP_NET_RAW |
| TUN-Modul | Wird nicht verwendet | Wird vor dem Start des Clients mit modprobe tun geladen |
| Arbeitsverzeichnis | /var/lib/localtonet | /var/lib/localtonet-vpn |
So wechseln Sie ein Gerät vom Tunnel-Dienst zum VPN-Dienst:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.serviceUm zurückzuwechseln, deaktivieren Sie localtonet-vpn.service und aktivieren Sie localtonet.service auf dieselbe Weise. VPN-Netzwerke selbst richten Sie im Dashboard ein, siehe VPN-Manager.
Wie die Dienste laufen #
| Verhalten | Details |
|---|---|
| Headless-Modus | Beide Dienste starten localtonet --headless. In diesem Modus fragt der Client nie nach, und er speichert das Token nicht in seinen eigenen Einstellungen. |
| Token | systemd übergibt /etc/localtonet/auth-token an den Dienst. Ein Dienst startet nicht, solange die Datei fehlt. |
| Start beim Systemstart | Ein aktivierter Dienst startet, sobald das Netzwerk verfügbar ist. |
| Neustart | systemd startet den Client zehn Sekunden nach einem Fehler neu. Stoppt der Client wegen einer ungültigen Token-Datei, startet systemd ihn nicht neu. Korrigieren Sie die Datei und starten Sie den Dienst selbst neu. |
Das Protokoll lesen #
Im Headless-Modus schreibt der Client schlichte Zeilen in das Journal, eine pro Änderung:
sudo journalctl -u localtonet.service -f| Zeile | Bedeutung |
|---|---|
Connection: Connected | Der Zustand der Sitzung. Weitere Werte sind Connecting und Disconnected. |
AuthTokenName: … | Der Name des Tokens, mit dem sich der Client angemeldet hat. |
OPEN …, ADDED … | Ein Tunnel, der auf diesem Gerät läuft, mit öffentlicher Adresse, Protokoll und lokalem Ziel. |
STATUS … | Ein Tunnel hat seinen Status geändert. |
CLOSED … | Ein Tunnel wurde gestoppt oder entfernt. |
Authentication failed: AuthToken was rejected. | Das Token in der Datei wird nicht akzeptiert. Kopieren Sie es erneut aus Meine Tokens. |
Würde eine dieser Zeilen das Token enthalten, schreibt der Client stattdessen [redacted].
Aktualisieren #
Laden Sie das neue Paket herunter und installieren Sie es genauso wie beim ersten Mal, und starten Sie dann den von Ihnen verwendeten Dienst neu. Ihre Token-Datei bleibt erhalten.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceUnter Meine Tokens zeigt die Spalte Client die Version, die das Gerät zuletzt gemeldet hat, und ein Badge Update nötig, wenn eine neuere verfügbar ist.
Entfernen #
sudo apt remove localtonetsudo dnf remove localtonetDas Entfernen des Pakets stoppt und deaktiviert beide Dienste. Die Token-Datei ist eine Konfigurationsdatei, und Paketmanager behandeln solche Dateien mit Vorsicht: Prüfen Sie nach dem Entfernen, ob /etc/localtonet/auth-token oder eine gespeicherte Kopie davon noch vorhanden ist, und löschen Sie sie, wenn das Token nicht auf dem Rechner bleiben soll.
Fehlerbehebung #
Invalid Localtonet headless configuration. Check the token file or environment settings.
Die Token-Datei ist nicht verwendbar. Prüfen Sie, ob /etc/localtonet/auth-token existiert, ob der Platzhalter DUMMY_AUTH_TOKEN entfernt wurde und ob die Datei nur das 33-stellige Token ohne Leerzeichen in einer einzigen Zeile enthält. Führen Sie die Prüfung mit sudo aus, denn nur root kann die Datei lesen.
Der Dienst ist aktiviert, läuft aber nicht
Führen Sie systemctl status localtonet.service aus. Ein Dienst startet nicht, solange /etc/localtonet/auth-token fehlt, und er wird nicht neu gestartet, nachdem er wegen einer ungültigen Token-Datei gestoppt ist. Korrigieren Sie die Datei, führen Sie die Konfigurationsprüfung aus und führen Sie dann sudo systemctl restart localtonet.service aus.
Das Protokoll meldet: Authentication failed: AuthToken was rejected.
Die Datei hat das richtige Format, aber das Token wird nicht akzeptiert. Kopieren Sie das Token erneut aus Meine Tokens, speichern Sie es in der Token-Datei und starten Sie den Dienst neu.
Der Tunnel-Dienst wurde gestoppt, als ich den VPN-Dienst gestartet habe
Das ist beabsichtigt. Die beiden Dienste schließen sich gegenseitig aus, daher stoppt systemd den einen, wenn der andere startet. Der VPN-Dienst bedient auch Ihre Tunnel.
Das Paket lässt sich auf meiner Distribution nicht installieren
Die Pakete benötigen systemd 247 oder neuer und OpenSSL 3. Bei älteren Versionen kann der Paketmanager diese Abhängigkeiten nicht erfüllen. Verwenden Sie stattdessen das Installationsskript oder ein Archiv von der Seite Linux.
Verwandte Seiten #
Die Pakete sind unten aufgelistet. Wählen Sie Einrichtungsanleitung unter einem Paket, um die Befehle mit dessen Dateinamen zu sehen.
Linux-Pakete
Installierbare DEB- und RPM-Pakete für x64 und ARM64. Erfordert systemd 247 oder neuer und OpenSSL 3, z. B. Debian 12, Ubuntu 22.04+ oder RHEL 9.
-
Debian / Ubuntu · x64
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-linux-x64.deb.sudo apt install ./localtonet-linux-x64.deb2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceFür VPN wechseln Sie zum VPN-Dienst:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceFür ein Upgrade installieren Sie das neue Paket und führen
sudo systemctl restart localtonetaus. Ihre Konfiguration bleibt erhalten.Wenn Sie VPN nutzen, starten Sie stattdessen
localtonet-vpn.serviceneu. -
Debian / Ubuntu · ARM64
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-linux-arm64.deb.sudo apt install ./localtonet-linux-arm64.deb2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceFür VPN wechseln Sie zum VPN-Dienst:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceFür ein Upgrade installieren Sie das neue Paket und führen
sudo systemctl restart localtonetaus. Ihre Konfiguration bleibt erhalten.Wenn Sie VPN nutzen, starten Sie stattdessen
localtonet-vpn.serviceneu. -
Fedora / RHEL · x64
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-linux-x64.rpm.sudo dnf install ./localtonet-linux-x64.rpm2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceFür VPN wechseln Sie zum VPN-Dienst:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceFür ein Upgrade installieren Sie das neue Paket und führen
sudo systemctl restart localtonetaus. Ihre Konfiguration bleibt erhalten.Wenn Sie VPN nutzen, starten Sie stattdessen
localtonet-vpn.serviceneu. -
Fedora / RHEL · ARM64
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-linux-arm64.rpm.sudo dnf install ./localtonet-linux-arm64.rpm2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceFür VPN wechseln Sie zum VPN-Dienst:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceFür ein Upgrade installieren Sie das neue Paket und führen
sudo systemctl restart localtonetaus. Ihre Konfiguration bleibt erhalten.Wenn Sie VPN nutzen, starten Sie stattdessen
localtonet-vpn.serviceneu.