Localtonet unter Windows installieren
Auf dieser Seite 9 Abschnitte
- Bevor Sie beginnen
- Eine Version auswählen
- Die App verwenden
- Die App installieren und öffnen
- Mit Ihrem Token anmelden
- Einen Tunnel starten
- Den Konsolen-Client verwenden
- Herunterladen und entpacken
- Mit Ihrem Token starten
- Die Sitzung prüfen
- Als Windows-Dienst ausführen
- Den Dienst installieren
- Prüfen, ob er läuft
- Dienstbefehle
- Aktualisieren
- Deinstallieren
- Fehlerbehebung
- 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 #
| Version | Download | Hinweise |
|---|---|---|
| App aus dem Microsoft Store | Localtonet im Microsoft Store | Ein App-Fenster mit einem Anmeldebildschirm. Erfordert Windows 10 Version 1809 (Build 17763) oder neuer. |
| Desktop-App, portable ZIP | x64, x86, ARM64 | Dieselbe App ohne den Store. Entpacken Sie die ZIP-Datei und starten Sie die App aus dem entpackten Ordner. |
| Konsolen-Client | 64 Bit, 32 Bit, ARM64 | Eine 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 #
-
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.
-
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. -
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 #
-
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, startetlocaltonet.exeaus diesem Ordner. -
Mit Ihrem Token starten #
Öffnen Sie die Eingabeaufforderung oder PowerShell in diesem Ordner und führen Sie aus:
Eingabeaufforderunglocaltonet --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
localtonetstarten. Starten Sie ihn ohne gespeichertes Token, fragt erPlease Enter AuthToken or PIN. -
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,PingundStatus. 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.
-
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. -
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 inservices.mscunter demselben Namen sichtbar, mit der BeschreibungLocaltonet Service. Im Dashboard zeigt das Token unter Meine Tokens Online an.
Dienstbefehle #
Fügen Sie --authtoken <YOUR_TOKEN> zu jedem Befehl hinzu.
| Befehl | Funktion | Benötigt Administratorrechte |
|---|---|---|
--install-service | Erstellt den Dienst mit automatischem Start und startet ihn. Windows startet den Dienst eine Minute nach einem Fehler neu. | Ja |
--start-service | Startet den installierten Dienst, zum Beispiel nachdem Sie ihn gestoppt haben. | Ja |
--stop-service | Stoppt den Dienst. Er startet beim nächsten Systemstart wieder. | Ja |
--status-service | Gibt 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-service | Stoppt 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.exezu ersetzen, solange sie läuft, schließen Sie den Client also zuerst. Läuft er als Dienst, führen Sie--stop-serviceaus, ersetzen Sie die Datei und führen Sie dann--start-serviceaus.
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 #
- Wenn Sie den Dienst installiert haben, entfernen Sie ihn:
localtonet --remove-service --authtoken <YOUR_TOKEN>als Administrator. - Um das gespeicherte Token zu entfernen, starten Sie den Konsolen-Client und drücken Sie F12.
- 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.