Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet unter Linux installieren

Hilfe zu dieser Seite
Auf dieser Seite 9 Abschnitte
  1. Bevor Sie beginnen
  2. Mit dem Skript installieren
  3. Das Installationsskript ausführen
  4. Die Installation prüfen
  5. Manuell installieren
  6. Herunterladen und entpacken
  7. Optional: in Ihren PATH verschieben
  8. Den Client starten
  9. Mit Ihrem Token starten
  10. Die Sitzung prüfen
  11. Als systemd-Dienst ausführen
  12. Den Dienst installieren
  13. Prüfen, ob er läuft
  14. Dienstbefehle
  15. Die Unit und ihre Protokolle
  16. Aktualisieren
  17. Den Client ersetzen
  18. Den Dienst neu starten
  19. Deinstallieren
  20. Fehlerbehebung
  21. Verwandte Seiten

Unter Linux ist der Localtonet-Client ein einzelnes Konsolenprogramm. Installieren Sie ihn mit dem Installationsskript oder aus einem ZIP-Archiv, starten Sie ihn mit Ihrem AuthToken und installieren Sie ihn als systemd-Dienst, wenn er nach jedem Neustart starten soll.

Bevor Sie beginnen #

  • Ein Localtonet-Konto. Erstellen Sie kostenlos eines, falls Sie noch keins haben.
  • Ihr AuthToken. Wählen Sie Kopieren auf der Karte AuthToken im Dashboard, oder kopieren Sie ein Token aus Meine Tokens.
  • curl oder wget sowie unzip.
  • Für den systemd-Dienst: Root-Zugriff und eine Distribution, die systemd verwendet.

Weitere Möglichkeiten, Localtonet unter Linux zu betreiben. Unter Debian, Ubuntu, Fedora und RHEL können Sie ein DEB- oder RPM-Paket installieren, das eigene Dienste mitbringt. Es gibt eigene Anleitungen für Docker, OpenWrt-Router und Termux unter Android.

Mit dem Skript installieren #

  1. Das Installationsskript ausführen #

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

    Das Skript erkennt Ihre CPU (x64, ARM64 oder ARM) und ob das System glibc oder musl verwendet, lädt die passende Version herunter und installiert sie nach /usr/local/bin/localtonet. Es legt außerdem den Link /usr/bin/localtonet an, damit sudo localtonet auch auf Distributionen funktioniert, bei denen sudo nicht in /usr/local/bin sucht.

    Das Skript verwendet sudo, wenn Ihr Benutzer nicht in den Installationsordner schreiben kann, weshalb es möglicherweise nach Ihrem Passwort fragt. Fehlt unzip, versucht es, es mit dem Paketmanager Ihrer Distribution zu installieren.

  2. Die Installation prüfen #

    Das Skript gibt am Ende die installierte Version aus. Sie können sie jederzeit erneut ausgeben:

    Terminal
    localtonet --version

Manuell installieren #

Wenn Sie lieber direkt herunterladen, nehmen Sie das Archiv für Ihr System. Jede ZIP-Datei enthält eine einzige Datei, localtonet.

uname -m gibt Ihren CPU-Typ aus: x86_64 ist x64, aarch64 ist ARM64 und armv7l ist ARM.

  1. Herunterladen und entpacken #

    Das Beispiel verwendet die x64-glibc-Version. Ersetzen Sie den Dateinamen durch das Archiv für Ihr System.

    Terminal
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Optional: in Ihren PATH verschieben #

    Ohne diesen Schritt starten Sie den Client über seinen Pfad, ~/localtonet/localtonet. Danach können Sie in jedem Ordner localtonet eingeben.

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

Den Client starten #

  1. Mit Ihrem Token starten #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    Der Client speichert das Token lokal für Ihren Benutzer. Beim nächsten Mal können Sie ihn allein mit localtonet starten. Starten Sie ihn ohne gespeichertes Token, fragt er Please Enter AuthToken or PIN.

  2. Die Sitzung prüfen #

    Das Terminal zeigt Session Status: Connected über einer Tabelle mit einer Zeile pro laufendem Tunnel: IP/Url, Protocol, Client IP, Client Port, Ping und Status. Die Tabelle bleibt leer, bis Sie im Dashboard einen Tunnel starten, siehe Schnellstart.

    Drücken Sie Ctrl + C, um den Client zu beenden. Drücken Sie F12, um das gespeicherte Token zu entfernen und das Programm zu beenden.

Ist die Ausgabe kein Terminal, zum Beispiel wenn Sie sie in eine Datei umleiten, schreibt der Client statt der Tabelle bei jeder Änderung eine einfache Zeile.

VPN benötigt Root. Gehört das Gerät zu einem Netzwerk des VPN-Managers und der Client läuft ohne Root, zeigt die VPN-Zeile der Tabelle Admin rights required.. Starten Sie den Client in diesem Fall mit sudo oder als Dienst.

Als systemd-Dienst ausführen #

Ein Dienst startet Localtonet nach jedem Neustart, hält es nach dem Abmelden am Laufen und benötigt kein geöffnetes Terminal. Die Dienstbefehle benötigen Root.

  1. Den Dienst installieren #

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    Der Befehl schreibt eine systemd-Unit für dieses Token, aktiviert sie und startet sie sofort. Er antwortet mit dem Namen der Unit:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> sind die ersten 9 Zeichen Ihres Tokens. Jedes Token erhält eine eigene Unit, daher benötigen die anderen Dienstbefehle dasselbe --authtoken, um sie zu finden.

  2. Prüfen, ob er läuft #

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Ein laufender Dienst antwortet [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Im Dashboard zeigt das Token unter Meine Tokens Online an.

Dienstbefehle #

Führen Sie jeden Befehl mit sudo aus und fügen Sie --authtoken <YOUR_TOKEN> hinzu.

BefehlFunktion
--install-serviceSchreibt die Unit-Datei, aktiviert die Unit und startet sie.
--start-serviceStartet die Unit, zum Beispiel nachdem Sie sie gestoppt haben.
--stop-serviceStoppt die Unit. Sie bleibt aktiviert und startet nach einem Neustart wieder.
--status-serviceGibt den Zustand aus, zum Beispiel Running, Stopped oder Error, wenn die Unit fehlgeschlagen ist.
--remove-serviceStoppt und deaktiviert die Unit und löscht die Unit-Datei.

Der Dienst wird mit den Optionen installiert, die Sie zusammen mit --install-service übergeben. Die Optionen sind in der CLI-Referenz aufgeführt.

Die Unit und ihre Protokolle #

Die Unit-Datei ist /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd startet den Client fünf Sekunden nach einem Fehler neu. Da es eine normale systemd-Unit ist, können Sie sie auch mit systemctl verwalten und ihre Ausgabe mit journalctl lesen:

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

Die Unit startet die Datei localtonet aus dem Pfad, den sie bei der Installation des Dienstes hatte. Eine Ausnahme: Liegt dieser Pfad unter /root/, kopiert der Installationsbefehl die Datei nach /usr/local/lib/Localtonet_<TOKEN_PREFIX>/, und der Dienst führt die Kopie aus.

Aktualisieren #

  1. Den Client ersetzen #

    Führen Sie das Installationsskript erneut aus. Es lässt sich bedenkenlos wiederholen und überschreibt den installierten Client mit der aktuellen Version. Laden Sie nach einer manuellen Installation das aktuelle Archiv herunter und ersetzen Sie die Datei localtonet.

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Den Dienst neu starten #

    Ein laufender Dienst verwendet weiter die alte Version, bis er neu gestartet wird.

    Terminal
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    Führt der Dienst eine Kopie unter /usr/local/lib/ aus, entfernen Sie stattdessen den Dienst und installieren Sie ihn mit dem neuen Client erneut.

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.

Deinstallieren #

  1. Wenn Sie den Dienst installiert haben, entfernen Sie ihn: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Um das gespeicherte Token zu entfernen, starten Sie den Client und drücken Sie F12.
  3. Löschen Sie den Client: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet nach der Skript-Installation, oder den Ordner, in den Sie das Archiv entpackt haben.

Fehlerbehebung #

Installationsskript: Unsupported architecture

Das Skript hat Versionen für x64 (x86_64), ARM64 (aarch64) und 32-Bit-ARM (armv7l). Andere CPU-Typen werden von den Linux-Versionen nicht unterstützt.

Installationsskript: Neither curl nor wget found

Installieren Sie curl oder wget mit Ihrem Paketmanager und führen Sie das Skript erneut aus.

Installationsskript: Failed to install 'unzip'

Das Skript konnte unzip nicht selbst installieren. Installieren Sie es mit Ihrem Paketmanager und führen Sie das Skript erneut aus.

Installed but not found in PATH

Öffnen Sie eine neue Shell, oder starten Sie den Client über seinen vollständigen Pfad, /usr/local/bin/localtonet.

sudo: localtonet: command not found

Nach einer manuellen Installation liegt der Client nicht im Suchpfad von sudo. Verwenden Sie den vollständigen Pfad, zum Beispiel sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, oder verschieben Sie die Datei zuerst nach /usr/local/bin.

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

Der Befehl wurde ohne Root ausgeführt. Wiederholen Sie ihn mit sudo. Dasselbe gilt für --start-service, --stop-service und --remove-service.

Install failed: Systemd unit already exists for 'Localtonet_…'

Für dieses Token ist bereits ein Dienst installiert. Prüfen Sie ihn mit --status-service. Um ihn erneut zu installieren, führen Sie zuerst --remove-service aus.

Die Dienstbefehle schlagen auf einem System ohne systemd fehl

Der Dienstmodus verwendet systemd. Starten Sie den Client auf Systemen ohne systemd auf andere Weise, zum Beispiel in einem Docker-Container. Der Konsolen-Client hat dafür einen Headless-Modus: --headless läuft ohne Eingabeaufforderungen und liest das Token aus einer Datei, die mit --authtoken-file angegeben wird. Siehe die CLI-Referenz.

Wrong Token!

Der Client erwartet das 33-stellige AuthToken aus Meine Tokens oder eine 6-stellige PIN, die noch nicht abgelaufen ist. Kopieren Sie das Token erneut und geben Sie es an der Eingabeaufforderung ein.

This token is used in another localtonet application!

Ein anderer Localtonet-Client auf diesem Rechner läuft bereits mit demselben Token. Schließen Sie ihn, oder starten Sie diesen mit einem anderen Token. Verwenden Sie pro Token einen laufenden Client.

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

Support