Zum Inhalt springen
Localtonet Localtonet Dashboard

Den Localtonet-Client installieren

Hilfe zu dieser Seite
Auf dieser Seite 5 Abschnitte
  1. Unterstützte Plattformen
  2. Die Installationsart wählen
  3. Was jede Installation gemeinsam hat
  4. Der Client meldet sich mit einem AuthToken an
  5. Sie starten den Client mit diesem Token
  6. Sie erstellen und starten Tunnel im Dashboard
  7. Der Client muss weiterlaufen
  8. Den Client aktuell halten
  9. Installationsanleitungen

Der Localtonet-Client läuft auf dem Gerät, das Ihren Dienst hostet, und hält den Tunnel zu Localtonet offen. Diese Seite listet die unterstützten Plattformen auf, hilft Ihnen bei der Wahl der passenden Installationsart und verweist auf die Anleitung für jede davon.

Unterstützte Plattformen #

Alle Downloads finden Sie auf der Seite Downloads.

PlattformWas Sie installieren könnenArchitekturen
WindowsMicrosoft-Store-App, portable Desktop-App, Konsolen-Client64-Bit (x64), 32-Bit (x86), ARM64
macOSKonsolen-Client, mit Homebrew oder als ZIP-ArchivIntel (x64), Apple Silicon (ARM64)
LinuxKonsolen-Client, mit dem Installationsskript oder als ZIP-Archivx64, ARM und ARM64, jeweils für glibc und für musl
Linux-PaketeDEB- und RPM-Pakete mit systemd-Dienstenx64, ARM64
AndroidAndroid-App aus Google Play oder als APK-DateiDie Mindestversion von Android für die App ist 5.0
TermuxKonsolen-Client als Termux-PaketARM64
DockerOffizielles Image localtonet/localtonetAMD64, ARM64
OpenWrtRouter-Pakete für OpenWrt 24.10 und 25.12+ (experimentell)x64, ARM64
NAS und Home AssistantEinrichtungsvorlagen für Docker Compose und Home AssistantAMD64, ARM64
SSH ohne InstallationNichts. Sie verwenden den SSH-Client, den Sie bereits haben.Jedes Gerät mit einem SSH-Client

Die Installationsart wählen #

OptionWas es istWählen Sie sie, wenn
Konsolen-ClientDas Programm localtonet für Windows, macOS und Linux. Sie starten es in einem Terminal mit Ihrem AuthToken. Es zeigt Ihre Tunnel in einer Live-Tabelle an und kann sich selbst als Dienst installieren.Sie in einem Terminal arbeiten oder das Gerät ein Server ohne Desktop ist.
Desktop-AppDie Localtonet-App für Windows mit einem Anmeldefenster, aus dem Microsoft Store oder als portables ZIP.Sie unter Windows ein App-Fenster einem Terminal vorziehen.
Mobile AppDie Localtonet-App für Android. Sie melden sich mit einem QR-Code, einer PIN oder dem Token an.das Gerät ein Android-Smartphone oder -Tablet ist, zum Beispiel für einen mobilen Proxy.
PaketDEB- und RPM-Pakete für Linux, ein Termux-Paket für Android und experimentelle Pakete für OpenWrt. Die Linux- und OpenWrt-Pakete bringen einen Dienst mit, der das Token aus einer Datei liest.Sie möchten, dass die Paketverwaltung des Systems den Client installiert und entfernt, und einen Dienst, der beim Systemstart startet.
ContainerDas offizielle Docker-Image sowie Einrichtungsvorlagen für NAS-Geräte und Home Assistant, die es verwenden.Ihre Dienste bereits in Containern laufen oder das Gerät ein NAS ist.
SSH ohne InstallationDas Dashboard erzeugt einen ssh-Befehl, der den Tunnel öffnet. Ein Download ist nicht nötig. Er wird für HTTP- und TCP-Tunnel angeboten.Sie auf dem Gerät nichts installieren können oder wollen.

Was jede Installation gemeinsam hat #

  1. Der Client meldet sich mit einem AuthToken an #

    Ein AuthToken verbindet ein Gerät mit Ihrem Konto. Kopieren Sie ihn mit Kopieren auf der Karte AuthToken des Dashboards oder erstellen Sie unter Meine Tokens für jedes Gerät ein benanntes Token. Tokens werden unter AuthTokens erklärt.

    Halten Sie Ihr Token privat. Jeder, der das Token hat, kann sich damit in der App anmelden.

  2. Sie starten den Client mit diesem Token #

    Ersetzen Sie <YOUR_TOKEN> durch Ihr Token.

    Windows

    Öffnen Sie die Localtonet-App und fügen Sie Ihren AuthToken ein, oder führen Sie den Konsolen-Client in der Eingabeaufforderung aus dem Ordner aus, der localtonet.exe enthält:

    Eingabeaufforderung
    localtonet --authtoken <YOUR_TOKEN>

    macOS

    Bash
    brew tap localtonet/tap
    brew install localtonet
    localtonet --authtoken <YOUR_TOKEN>

    Linux

    Bash
    curl -fsSL https://localtonet.com/install.sh | sh
    localtonet --authtoken <YOUR_TOKEN>

    Docker

    Bash
    docker pull localtonet/localtonet
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    Android

    Öffnen Sie die Localtonet-App, scannen Sie dann den QR-Code des Tokens, geben Sie seine PIN ein oder fügen Sie das Token ein und wählen Sie Connect. Der QR-Code und die PIN befinden sich unter Meine Tokens.

    Der Konsolen-Client speichert das Token lokal, sodass Sie ihn beim nächsten Mal allein mit localtonet starten können. Starten Sie ihn ohne gespeichertes Token, fragt er Please Enter AuthToken or PIN.

  3. Sie erstellen und starten Tunnel im Dashboard #

    Der Client muss Ihre Tunnel nicht im Voraus kennen. Sie erstellen einen Tunnel unter Meine Tunnel, wählen das Gerätetoken, und der Client, der mit diesem Token angemeldet ist, stellt ihn bereit. Der Schnellstart führt Sie durch den ersten Tunnel.

  4. Der Client muss weiterlaufen #

    Ein Tunnel geht online, sobald der Client mit Ihrem AuthToken läuft und der Tunnel gestartet ist. Meine Tokens zeigt jedes Gerät als Online oder Offline. Offline bedeutet, dass das Gerät getrennt ist, auch wenn seine Tunnel noch konfiguriert sind.

    Damit der Client nach dem Schließen des Terminals, dem Abmelden oder einem Neustart des Geräts weiterläuft, installieren Sie ihn als Dienst:

    PlattformWie
    Windowslocaltonet --install-service --authtoken <YOUR_TOKEN> in einem Terminal, das als Administrator läuft
    macOS, Linuxsudo localtonet --install-service --authtoken <YOUR_TOKEN>
    DEB-, RPM- und OpenWrt-PaketeDas Paket enthält den Dienst. Sie aktivieren ihn, nachdem Sie das Token gesetzt haben.
    AndroidDie App läuft im Hintergrund weiter und öffnet sich nach einem Neustart des Smartphones wieder.

    Die Einzelheiten stehen unter Als Dienst ausführen und auf der Seite jeder Plattform.

Den Client aktuell halten #

Die Spalte Client unter Meine Tokens zeigt die zuletzt gemeldete Version jedes Geräts. Ein Badge Update nötig verweist auf die Download-Seite, wenn eine neuere Version verfügbar ist. Der Konsolen-Client zeigt außerdem New Version available unter seiner Tunneltabelle an, und localtonet --version gibt die installierte Version aus.

Installationsanleitungen #

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

Support