Localtonet als Dienst ausführen
Auf dieser Seite 8 Abschnitte
Installieren Sie den Localtonet-Client als Hintergrunddienst, damit er mit dem Gerät startet, nach dem Abmelden weiterläuft und kein geöffnetes Terminal braucht. Ein Befehl registriert ihn bei den Windows-Diensten, bei launchd unter macOS oder bei systemd unter Linux.
Bevor Sie beginnen #
- Der Konsolen-Client ist auf dem Gerät installiert: Windows, macOS oder Linux.
- Ein AuthToken für dieses Gerät aus Meine Tokens.
- Administratorrechte: ein Terminal, das unter Windows mit Als Administrator ausführen geöffnet wurde, bzw.
sudounter macOS und Linux. - Unter Linux eine Distribution, die systemd verwendet. Termux wird nicht unterstützt; verwenden Sie dort die Android-App.
Über ein DEB- oder RPM-Paket installiert, unter OpenWrt oder in Docker? Diese bringen ihren eigenen Weg mit, beim Systemstart zu starten. Siehe DEB- und RPM-Pakete, OpenWrt und Docker statt dieser Seite.
Den Dienst installieren #
Führen Sie den Client einmal mit --install-service und Ihrem Token aus. Ersetzen Sie <YOUR_TOKEN> durch Ihren AuthToken. Geben Sie bei diesem Befehl immer --authtoken an: Der Dienst verbindet sich mit dem Token, mit dem Sie ihn installieren.
Windows #
Öffnen Sie die Eingabeaufforderung oder PowerShell als Administrator in dem Ordner, der localtonet enthält, und führen Sie dann Folgendes aus:
localtonet --install-service --authtoken <YOUR_TOKEN>Der Client erstellt einen Windows-Dienst mit automatischem Start und startet ihn. Der Dienst ist in services.msc mit der Beschreibung Localtonet Service sichtbar. Schlägt der Dienst fehl, startet Windows ihn nach einer Minute neu.
macOS
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Der Client schreibt einen launchd-Job nach /Library/LaunchDaemons/<SERVICE_NAME>.plist, lädt ihn und startet ihn. Der Job startet beim Systemstart, und launchd startet ihn erneut, wenn er mit einem Fehler endet.
Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Der Client schreibt eine systemd-Unit nach /etc/systemd/system/<SERVICE_NAME>.service, aktiviert sie und startet sie. Die Unit startet beim Systemstart, und systemd startet sie fünf Sekunden nach einem Fehler neu.
Findet sudo den Befehl localtonet nicht, führen Sie ihn mit seinem Pfad aus, zum Beispiel sudo ./localtonet in dem Ordner, der ihn enthält.
Bei Erfolg gibt der Client den Namen des Dienstes aus:
[CLI] Installed service 'Localtonet_AbCdEfGhI'Die Installation startet den Dienst auch, ein separater Startbefehl ist also nicht nötig. Sie können jetzt im Dashboard Tunnel für dieses Token erstellen und starten.
Der Dienstname #
Der Dienst heißt Localtonet_ gefolgt von den ersten neun Zeichen des Tokens, zum Beispiel Localtonet_AbCdEfGhI. Diese Seite schreibt dafür <SERVICE_NAME>. Da der Name vom Token stammt, können Sie auf demselben Gerät einen Dienst pro Token installieren, und jeder Verwaltungsbefehl braucht dasselbe Token, um seinen Dienst zu finden.
Was der Dienst ausführt #
Der Dienst startet dieselbe Datei localtonet am selben Ort, mit den Optionen, die Sie beim Installationsbefehl angegeben haben. Daraus folgen zwei Dinge:
- Verschieben oder löschen Sie die Datei nicht. Die Dienstdefinition enthält ihren vollständigen Pfad. Liegt die Datei unter Linux in
/root, kopiert das Installationsprogramm sie nach/usr/local/lib/<SERVICE_NAME>/, und der Dienst führt diese Kopie aus. - Weitere Optionen bleiben erhalten. Optionen wie
--netund--ipoder--proxy envbeim Installationsbefehl werden im Dienst gespeichert und bei jedem Start verwendet. Siehe die CLI-Referenz.
Den Dienst verwalten #
Verwenden Sie dasselbe Token mit einer dieser Optionen. Setzen Sie unter macOS und Linux sudo davor. Verwenden Sie unter Windows für alles außer dem Status ein Administrator-Terminal.
| Befehl | Funktion | Ausgabe bei Erfolg |
|---|---|---|
localtonet --status-service --authtoken <YOUR_TOKEN> | Zeigt den Zustand des Dienstes. | [CLI] Service '<SERVICE_NAME>' status: Running |
localtonet --stop-service --authtoken <YOUR_TOKEN> | Beendet den Dienst. Seine Tunnel gehen offline. Er startet beim nächsten Systemstart wieder. | [CLI] Stopped service '<SERVICE_NAME>'. |
localtonet --start-service --authtoken <YOUR_TOKEN> | Startet einen beendeten Dienst. | [CLI] Started service '<SERVICE_NAME>'. |
localtonet --remove-service --authtoken <YOUR_TOKEN> | Beendet den Dienst und entfernt seine Registrierung. Die Datei localtonet selbst bleibt erhalten. | [CLI] Removed service '<SERVICE_NAME>'. |
Der Status ist einer dieser Werte:
| Status | Bedeutung |
|---|---|
Running | Der Dienst läuft. |
Stopped | Der Dienst ist installiert, läuft aber nicht. |
Installing | Der Dienst startet gerade. |
NotFound | Für dieses Token ist kein Dienst installiert. |
Paused | Nur unter Windows: Der Dienst wurde angehalten. |
Error | Der Dienst ist fehlgeschlagen, oder sein Zustand konnte nicht gelesen werden. |
Unknown | Die Dienstverwaltung hat einen Zustand zurückgegeben, den der Client nicht erkennt. |
Sie können mit dem Dienstnamen auch die Werkzeuge des Betriebssystems verwenden:
Windows #
Öffnen Sie services.msc und suchen Sie <SERVICE_NAME>, oder verwenden Sie sc in einem Administrator-Terminal:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>Wo der Dienst registriert ist und wo seine Protokolle liegen #
| System | Registrierung | Protokolle |
|---|---|---|
| Windows | Ein Windows-Dienst namens <SERVICE_NAME>, Starttyp automatisch, ausgeführt unter dem Konto LocalSystem. | Der Dienst hat kein Konsolenfenster, und das Installationsprogramm richtet keine Protokolldatei ein. Prüfen Sie den Zustand des Dienstes sowie das Gerät und seine Tunnel im Dashboard. |
| macOS | /Library/LaunchDaemons/<SERVICE_NAME>.plist, ein systemweiter launchd-Job. | /var/log/<SERVICE_NAME>.out.log und /var/log/<SERVICE_NAME>.err.log |
| Linux | /etc/systemd/system/<SERVICE_NAME>.service, aktiviert für multi-user.target. | Das systemd-Journal: journalctl -u <SERVICE_NAME> -f |
Der Dienst gibt nicht die Tunneltabelle aus, die der Client in einem Terminal zeigt. Den Zustand Ihres Geräts und seiner Tunnel sehen Sie im Dashboard.
Das Token ändern #
Um das Token eines Geräts zu ändern, entfernen Sie den Dienst mit dem alten Token und installieren Sie ihn mit dem neuen erneut:
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>Wissenswertes #
- Ein Client pro Token. Starten Sie, solange der Dienst läuft, keinen weiteren Localtonet-Client mit demselben Token, weder auf diesem noch auf einem anderen Gerät. Ein zweiter Client, der sich mit einem Token verbindet, trennt den ersten.
- Den Client aktualisieren. Der Dienst führt weiterhin die Datei aus, auf die seine Definition verweist. Beenden Sie den Dienst, ersetzen Sie diese Datei durch die neue Version und starten Sie den Dienst wieder.
- Proxy-Passwörter werden nicht gespeichert. Der Installationsbefehl lehnt eine Proxy-URL mit Passwort und die Option
--proxy-userab. Installieren Sie mit--proxy envund setzen Sie die Proxy-Variablen in der Umgebung des Dienstes. - Geräte-Terminal. Läuft Localtonet auf dem Gerät als Dienst, führen Sie
localtonet --terminal enablein einem Administrator-Terminal oder mitsudoaus, damit der Dienst das Ergebnis verwenden kann. Siehe Geräte-Terminal.
Fehlerbehebung #
| Meldung | Ursache und Lösung |
|---|---|
[CLI] Install failed: '…' requires elevated (admin/root) privileges. | Der Befehl wurde ohne Administratorrechte ausgeführt. Öffnen Sie unter Windows das Terminal als Administrator oder verwenden Sie unter macOS und Linux sudo. Unter Windows und Linux erscheint dieselbe Meldung beim Starten, Beenden und Entfernen. |
[CLI] Install failed: gefolgt von Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) oder Plist already exists for … (macOS) | Für dieses Token ist bereits ein Dienst installiert. Starten Sie ihn mit --start-service oder entfernen Sie ihn zuerst mit --remove-service, wenn Sie ihn erneut installieren möchten. |
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment. | Der Installationsbefehl enthielt --proxy-user oder eine Proxy-URL mit Passwort. Verwenden Sie stattdessen --proxy env. |
[CLI] Start failed: … unter Windows direkt nach der Installation | Der Dienst läuft bereits, weil die Installation ihn startet. Prüfen Sie mit --status-service. |
Der Status ist NotFound | Für das übergebene Token existiert kein Dienst. Prüfen Sie, ob es das Token ist, mit dem Sie den Dienst installiert haben. |
Der Status ist Running, aber das Gerät ist im Dashboard offline | Prüfen Sie das Token: Kopieren Sie es erneut aus Meine Tokens, entfernen Sie den Dienst und installieren Sie ihn erneut. Stellen Sie außerdem sicher, dass kein anderer Client dasselbe Token verwendet. |