Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet aus einem DEB- oder RPM-Paket installieren

Hilfe zu dieser Seite
Auf dieser Seite 9 Abschnitte
  1. Bevor Sie beginnen
  2. Was das Paket installiert
  3. Schritte
  4. Das Paket herunterladen und installieren
  5. Ihren AuthToken festlegen
  6. Die Konfiguration prüfen
  7. Einen Dienst aktivieren
  8. Einen Tunnel starten
  9. Tunnel-Dienst oder VPN-Dienst
  10. Wie die Dienste laufen
  11. Das Protokoll lesen
  12. Aktualisieren
  13. Entfernen
  14. Fehlerbehebung
  15. 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 #

PfadWas es ist
/usr/bin/localtonetDer Befehl localtonet.
/usr/lib/localtonet/Der Client selbst.
/usr/lib/systemd/system/localtonet.serviceDer Tunnel-Dienst.
/usr/lib/systemd/system/localtonet-vpn.serviceDer VPN- und Tunnel-Dienst.
/etc/localtonet/auth-tokenDie 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 #

  1. 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) oder dnf (RPM). Einrichtungsanleitung unter jedem Paket zeigt die genauen Befehle für diese Datei.

  2. Ihren AuthToken festlegen #

    Bearbeiten Sie /etc/localtonet/auth-token als root mit einem Texteditor und ersetzen Sie DUMMY_AUTH_TOKEN in einer einzigen Zeile durch Ihr Token. Stellen Sie dann sicher, dass nur root die Datei lesen kann:

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. Die Konfiguration prüfen #

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

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

  4. Einen Dienst aktivieren #

    Aktivieren Sie für Tunnel den Tunnel-Dienst und lesen Sie sein Protokoll:

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

    Tritt dieses Gerät außerdem einem VPN-Netzwerk bei, aktivieren Sie stattdessen den VPN-Dienst. Siehe Tunnel-Dienst oder VPN-Dienst.

  5. 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.servicelocaltonet-vpn.service
Verwendung fürTunnelVPN und Tunnel
Läuft alsEin nicht privilegierter Benutzer, den systemd für den Dienst anlegtroot, beschränkt auf die Netzwerkfähigkeiten CAP_NET_ADMIN und CAP_NET_RAW
TUN-ModulWird nicht verwendetWird 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:

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

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

VerhaltenDetails
Headless-ModusBeide Dienste starten localtonet --headless. In diesem Modus fragt der Client nie nach, und er speichert das Token nicht in seinen eigenen Einstellungen.
Tokensystemd übergibt /etc/localtonet/auth-token an den Dienst. Ein Dienst startet nicht, solange die Datei fehlt.
Start beim SystemstartEin aktivierter Dienst startet, sobald das Netzwerk verfügbar ist.
Neustartsystemd 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:

Terminal
sudo journalctl -u localtonet.service -f
ZeileBedeutung
Connection: ConnectedDer 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.

Tunnel-Dienst
sudo systemctl restart localtonet
VPN-Dienst
sudo systemctl restart localtonet-vpn.service

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

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

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

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

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:

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

    Fü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.service

    Für ein Upgrade installieren Sie das neue Paket und führen sudo systemctl restart localtonet aus. Ihre Konfiguration bleibt erhalten.

    Wenn Sie VPN nutzen, starten Sie stattdessen localtonet-vpn.service neu.

  • 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.deb

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:

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

    Fü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.service

    Für ein Upgrade installieren Sie das neue Paket und führen sudo systemctl restart localtonet aus. Ihre Konfiguration bleibt erhalten.

    Wenn Sie VPN nutzen, starten Sie stattdessen localtonet-vpn.service neu.

  • 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.rpm

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:

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

    Fü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.service

    Für ein Upgrade installieren Sie das neue Paket und führen sudo systemctl restart localtonet aus. Ihre Konfiguration bleibt erhalten.

    Wenn Sie VPN nutzen, starten Sie stattdessen localtonet-vpn.service neu.

  • 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.rpm

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:

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

    Fü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.service

    Für ein Upgrade installieren Sie das neue Paket und führen sudo systemctl restart localtonet aus. Ihre Konfiguration bleibt erhalten.

    Wenn Sie VPN nutzen, starten Sie stattdessen localtonet-vpn.service neu.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support