Den Localtonet-Client installieren
Auf dieser Seite 5 Abschnitte
- Unterstützte Plattformen
- Die Installationsart wählen
- Was jede Installation gemeinsam hat
- Der Client meldet sich mit einem AuthToken an
- Sie starten den Client mit diesem Token
- Sie erstellen und starten Tunnel im Dashboard
- Der Client muss weiterlaufen
- Den Client aktuell halten
- 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.
| Plattform | Was Sie installieren können | Architekturen |
|---|---|---|
| Windows | Microsoft-Store-App, portable Desktop-App, Konsolen-Client | 64-Bit (x64), 32-Bit (x86), ARM64 |
| macOS | Konsolen-Client, mit Homebrew oder als ZIP-Archiv | Intel (x64), Apple Silicon (ARM64) |
| Linux | Konsolen-Client, mit dem Installationsskript oder als ZIP-Archiv | x64, ARM und ARM64, jeweils für glibc und für musl |
| Linux-Pakete | DEB- und RPM-Pakete mit systemd-Diensten | x64, ARM64 |
| Android | Android-App aus Google Play oder als APK-Datei | Die Mindestversion von Android für die App ist 5.0 |
| Termux | Konsolen-Client als Termux-Paket | ARM64 |
| Docker | Offizielles Image localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | Router-Pakete für OpenWrt 24.10 und 25.12+ (experimentell) | x64, ARM64 |
| NAS und Home Assistant | Einrichtungsvorlagen für Docker Compose und Home Assistant | AMD64, ARM64 |
| SSH ohne Installation | Nichts. Sie verwenden den SSH-Client, den Sie bereits haben. | Jedes Gerät mit einem SSH-Client |
Die Installationsart wählen #
| Option | Was es ist | Wählen Sie sie, wenn |
|---|---|---|
| Konsolen-Client | Das 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-App | Die 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 App | Die 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. |
| Paket | DEB- 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. |
| Container | Das 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 Installation | Das 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 #
-
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.
-
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.exeenthält:Eingabeaufforderunglocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker 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
localtonetstarten können. Starten Sie ihn ohne gespeichertes Token, fragt erPlease Enter AuthToken or PIN. -
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.
-
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:
Plattform Wie Windows localtonet --install-service --authtoken <YOUR_TOKEN>in einem Terminal, das als Administrator läuftmacOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>DEB-, RPM- und OpenWrt-Pakete Das Paket enthält den Dienst. Sie aktivieren ihn, nachdem Sie das Token gesetzt haben. Android Die 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.