Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet unter Windows installieren

Hilfe zu dieser Seite
Auf dieser Seite 9 Abschnitte
  1. Bevor Sie beginnen
  2. Eine Version auswählen
  3. Die App verwenden
  4. Die App installieren und öffnen
  5. Mit Ihrem Token anmelden
  6. Einen Tunnel starten
  7. Den Konsolen-Client verwenden
  8. Herunterladen und entpacken
  9. Mit Ihrem Token starten
  10. Die Sitzung prüfen
  11. Als Windows-Dienst ausführen
  12. Den Dienst installieren
  13. Prüfen, ob er läuft
  14. Dienstbefehle
  15. Aktualisieren
  16. Deinstallieren
  17. Fehlerbehebung
  18. Verwandte Seiten

Unter Windows können Sie die Localtonet-App aus dem Microsoft Store, eine portable Version derselben App oder den Konsolen-Client verwenden. Der Konsolen-Client kann sich außerdem selbst als Windows-Dienst installieren, der bei jedem Systemstart startet.

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.
  • Für den Windows-Dienst: ein Fenster der Eingabeaufforderung oder von PowerShell, das als Administrator ausgeführt wird.

Eine Version auswählen #

VersionDownloadHinweise
App aus dem Microsoft StoreLocaltonet im Microsoft StoreEin App-Fenster mit einem Anmeldebildschirm. Erfordert Windows 10 Version 1809 (Build 17763) oder neuer.
Desktop-App, portable ZIPx64, x86, ARM64Dieselbe App ohne den Store. Entpacken Sie die ZIP-Datei und starten Sie die App aus dem entpackten Ordner.
Konsolen-Client64 Bit, 32 Bit, ARM64Eine ZIP-Datei mit einer einzigen Datei, localtonet.exe. Nur diese Version bietet die Dienstbefehle.

Die Seite Downloads bietet die Microsoft-Store-App und die drei Konsolen-Versionen unter Binärdateien an.

Die App verwenden #

  1. Die App installieren und öffnen #

    Installieren Sie Localtonet aus dem Microsoft Store, oder entpacken Sie die portable ZIP-Datei und starten Sie die App. Die App öffnet sich auf dem Bildschirm Sign in to Localtonet.

  2. Mit Ihrem Token anmelden #

    Fügen Sie Ihr AuthToken in das Feld Authtoken or PIN ein und wählen Sie Connect. Befindet sich das Token beim Öffnen des Bildschirms in der Zwischenablage, trägt die App es automatisch ein. Statt des Tokens können Sie die 6-stellige PIN eingeben, die Meine Tokens für ein Token anzeigt. Eine PIN ist eine Minute lang gültig.

    Antwortet die App mit Pin or authtoken is not valid., kopieren Sie das Token erneut und prüfen Sie, ob alle 33 Zeichen vorhanden sind.

  3. Einen Tunnel starten #

    Nach der Anmeldung listet die App die Tunnel auf, die auf diesem Gerät laufen. Solange die Liste No active tunnels anzeigt, erstellen und starten Sie im Dashboard einen Tunnel, siehe Schnellstart. Sign Out entfernt das Token aus der App, Quit Localtonet beendet sie.

Den Konsolen-Client verwenden #

  1. Herunterladen und entpacken #

    Laden Sie die ZIP-Datei für Ihre CPU herunter und entpacken Sie sie in einen Ordner, der an seinem Platz bleibt, zum Beispiel C:\Localtonet. Ein Dienst, den Sie später installieren, startet localtonet.exe aus diesem Ordner.

  2. Mit Ihrem Token starten #

    Öffnen Sie die Eingabeaufforderung oder PowerShell in diesem Ordner und führen Sie aus:

    Eingabeaufforderung
    localtonet --authtoken <YOUR_TOKEN>

    PowerShell führt ein Programm aus dem aktuellen Ordner nur aus, wenn Sie den Pfad angeben. Dort lautet der Befehl daher:

    PowerShell
    .\localtonet --authtoken <YOUR_TOKEN>

    Der Client speichert das Token lokal. 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.

  3. Die Sitzung prüfen #

    Das Fenster 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. Der Name Ihres Tokens erscheint unter der Tabelle.

    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.

Als Windows-Dienst ausführen #

Ein Dienst startet Localtonet bei jedem Systemstart, hält es nach dem Abmelden am Laufen und benötigt kein geöffnetes Terminal. Führen Sie diese Befehle mit dem Konsolen-Client in einer Eingabeaufforderung oder PowerShell aus, die als Administrator ausgeführt wird.

  1. Den Dienst installieren #

    Eingabeaufforderung (Administrator)
    localtonet --install-service --authtoken <YOUR_TOKEN>

    Der Befehl registriert einen Windows-Dienst für dieses Token, setzt den Starttyp auf automatisch und startet ihn sofort. Er antwortet mit dem Namen des Dienstes:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> sind die ersten 9 Zeichen Ihres Tokens. Jedes Token erhält einen eigenen Dienst, daher benötigen die anderen Dienstbefehle dasselbe --authtoken, um ihn zu finden.

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

    Eingabeaufforderung (Administrator)
    localtonet --status-service --authtoken <YOUR_TOKEN>

    Ein laufender Dienst antwortet [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Der Dienst ist auch in services.msc unter demselben Namen sichtbar, mit der Beschreibung Localtonet Service. Im Dashboard zeigt das Token unter Meine Tokens Online an.

Dienstbefehle #

Fügen Sie --authtoken <YOUR_TOKEN> zu jedem Befehl hinzu.

BefehlFunktionBenötigt Administratorrechte
--install-serviceErstellt den Dienst mit automatischem Start und startet ihn. Windows startet den Dienst eine Minute nach einem Fehler neu.Ja
--start-serviceStartet den installierten Dienst, zum Beispiel nachdem Sie ihn gestoppt haben.Ja
--stop-serviceStoppt den Dienst. Er startet beim nächsten Systemstart wieder.Ja
--status-serviceGibt den Zustand aus: Running, Stopped, Installing, während der Dienst startet, Paused, NotFound, wenn für dieses Token kein Dienst existiert, Error oder Unknown.Nein
--remove-serviceStoppt den Dienst und löscht ihn.Ja

Der Dienst wird mit den Optionen installiert, die Sie zusammen mit --install-service übergeben. Fügen Sie Client-Optionen wie --net und --ip daher diesem Befehl hinzu. Die Optionen sind in der CLI-Referenz aufgeführt.

Der Dienst führt localtonet.exe aus dem Ordner aus, in dem die Datei bei der Installation des Dienstes lag, mit dem Token als Teil seines Startbefehls. Verschieben oder löschen Sie die Datei nicht, solange der Dienst installiert ist.

Aktualisieren #

  • Microsoft-Store-App: Der Microsoft Store aktualisiert die App.
  • Konsolen-Client und portable App: Laden Sie die aktuelle ZIP-Datei von der Seite Downloads herunter und ersetzen Sie die alten Dateien. Windows erlaubt es nicht, localtonet.exe zu ersetzen, solange sie läuft, schließen Sie den Client also zuerst. Läuft er als Dienst, führen Sie --stop-service aus, ersetzen Sie die Datei und führen Sie dann --start-service aus.

localtonet --version gibt die installierte Version aus. 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: localtonet --remove-service --authtoken <YOUR_TOKEN> als Administrator.
  2. Um das gespeicherte Token zu entfernen, starten Sie den Konsolen-Client und drücken Sie F12.
  3. Löschen Sie den Ordner mit localtonet.exe, oder deinstallieren Sie die Store-App in den Windows-Einstellungen.

Fehlerbehebung #

'localtonet' wird nicht als interner oder externer Befehl, ausführbares Programm oder Batchdatei erkannt

Das Terminal befindet sich nicht in dem Ordner, der localtonet.exe enthält, oder Sie sind in PowerShell. Wechseln Sie zuerst in den Ordner. Starten Sie den Client in PowerShell als .\localtonet.

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

Das Terminal wird nicht als Administrator ausgeführt. Öffnen Sie die Eingabeaufforderung oder PowerShell mit Als Administrator ausführen und wiederholen Sie den Befehl. --start-service, --stop-service und --remove-service antworten mit derselben Art von Meldung.

Install failed: Service 'Localtonet_…' already exists.

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

Start failed: Service could not be started

Die Meldung enthält die Antwort des Windows-Tools sc. Der Fehler 1056 bedeutet, dass der Dienst bereits läuft. Das ist zu erwarten, wenn Sie --start-service direkt nach --install-service ausführen, weil der Installationsbefehl den Dienst bereits startet. Der Fehler 1060 bedeutet, dass für dieses Token kein Dienst existiert.

Der Status ist NotFound, aber ich habe den Dienst installiert

Der Dienstname wird aus dem Token gebildet. Wenn Sie ein anderes Token übergeben als das, mit dem Sie den Dienst installiert haben, sucht der Client nach einem anderen Dienst. Verwenden Sie dasselbe Token, oder suchen Sie in services.msc nach einem Dienst, dessen Name mit Localtonet_ beginnt.

Service installation cannot persist proxy passwords.

Sie haben --install-service mit --proxy-user oder mit einer Proxy-URL kombiniert, die ein Passwort enthält. Ein Dienst wird nicht mit Proxy-Passwörtern installiert. Verwenden Sie --proxy env und geben Sie die Zugangsdaten in der Umgebung des Dienstes an. 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 anderes Localtonet-Fenster auf diesem Computer läuft bereits mit demselben Token. Schließen Sie es, oder starten Sie dieses mit einem anderen Token. Verwenden Sie pro Token einen laufenden Client.

Das Token bleibt im Dashboard Offline

Offline bedeutet, dass das Gerät getrennt ist. Prüfen Sie, ob das Client-Fenster noch geöffnet ist oder der Dienststatus Running lautet und ob der Client mit dem Token gestartet wurde, das Sie gerade ansehen.

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

Support