Localtonet unter macOS installieren
Auf dieser Seite 9 Abschnitte
- Bevor Sie beginnen
- Mit Homebrew installieren
- Den Localtonet-Tap hinzufügen und installieren
- Die Installation prüfen
- Manuell installieren
- Herunterladen und entpacken
- Optional: in den PATH verschieben
- Den Client starten
- Mit Ihrem Token starten
- Die Sitzung prüfen
- Als launchd-Dienst ausführen
- Den Dienst installieren
- Prüfen, ob er läuft
- Was die Installation anlegt
- Dienstbefehle
- Aktualisieren
- Deinstallieren
- Fehlerbehebung
- Verwandte Seiten
Unter macOS ist der Localtonet-Client ein Konsolenprogramm für Intel- und Apple-Silicon-Macs. Installieren Sie ihn mit Homebrew oder aus einem ZIP-Archiv, starten Sie ihn mit Ihrem AuthToken und installieren Sie ihn als launchd-Dienst, wenn er bei jedem Systemstart laufen soll.
Bevor Sie beginnen #
- Ein Localtonet-Konto. Erstellen Sie kostenlos eines, falls Sie noch keines haben.
- Ihr AuthToken. Wählen Sie Kopieren auf der Karte AuthToken im Dashboard oder kopieren Sie ein Token aus Meine Tokens.
- Für die Installation mit Homebrew: Homebrew.
- Für den launchd-Dienst: ein Konto, das
sudoverwenden kann.
Mit Homebrew installieren #
-
Den Localtonet-Tap hinzufügen und installieren #
Ein Tap fügt Homebrew ein Repository eines Drittanbieters hinzu, sodass Sie daraus Formeln installieren und aktualisieren können.
Terminalbrew tap localtonet/tap brew install localtonet -
Die Installation prüfen #
Terminallocaltonet --versionDer Befehl gibt die Version des Clients aus.
Manuell installieren #
Wenn Sie einen direkten Download bevorzugen, nehmen Sie das Archiv für Ihren Mac. Das ZIP enthält eine einzige Datei, localtonet.
| Mac | Archiv |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Herunterladen und entpacken #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip unzip localtonet-osx-64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Optional: in den PATH verschieben #
Ohne diesen Schritt starten Sie den Client über seinen Pfad,
~/localtonet/localtonet. Danach können Sie in jedem Ordnerlocaltoneteingeben.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Den Client starten #
-
Mit Ihrem Token starten #
Terminallocaltonet --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 Terminal 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, siehe Schnellstart.Drücken Sie Ctrl + C, um den Client zu beenden. Drücken Sie F12, um das gespeicherte Token zu entfernen und zu beenden.
Als launchd-Dienst ausführen #
Ein Dienst startet Localtonet bei jedem Systemstart, hält es nach dem Abmelden am Laufen und braucht kein offenes Terminal. Die Dienstbefehle benötigen Root-Rechte, führen Sie sie daher mit sudo aus.
-
Den Dienst installieren #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>Der Befehl registriert einen systemweiten launchd-Job für dieses Token und startet ihn sofort. Er antwortet mit dem Namen des Jobs:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>sind die ersten 9 Zeichen Ihres Tokens. Jedes Token erhält einen eigenen Job, daher brauchen die anderen Dienstbefehle dasselbe--authtoken, um ihn zu finden. -
Prüfen, ob er läuft #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Ein laufender Job antwortet
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Im Dashboard zeigt das Token unter Meine Tokens den Status Online.
Was die Installation anlegt #
| Element | Speicherort |
|---|---|
| launchd-Jobdefinition | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| Standardausgabe des Clients | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| Fehlerausgabe des Clients | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
Der Job startet, wenn der Mac hochfährt, und launchd startet den Client erneut, wenn er mit einem Fehler endet. Der Job führt die Datei localtonet aus dem Pfad aus, den sie bei der Installation des Dienstes hatte, mit dem Token als Teil seiner Argumente.
Dienstbefehle #
Führen Sie jeden Befehl mit sudo aus und fügen Sie --authtoken <YOUR_TOKEN> hinzu.
| Befehl | Funktion |
|---|---|
--install-service | Schreibt die Jobdefinition, lädt sie und startet den Client. |
--start-service | Startet den Job. Läuft er bereits, startet launchd ihn neu. |
--stop-service | Stoppt den Client. Der Job bleibt installiert und startet beim nächsten Systemstart wieder. |
--status-service | Gibt den Zustand aus, zum Beispiel Running, Stopped, NotFound oder Error. |
--remove-service | Stoppt den Job, entlädt ihn und löscht die Jobdefinition. |
Der Dienst wird mit den Optionen installiert, die Sie zusammen mit --install-service übergeben. Die Optionen sind in der CLI-Referenz aufgeführt.
Aktualisieren #
- Homebrew:
brew upgrade localtonet - Manuelle Installation: Laden Sie das aktuelle Archiv herunter und ersetzen Sie die Datei
localtonet.
Läuft Localtonet als Dienst, installieren Sie den Dienst nach einem Homebrew-Upgrade erneut: Entfernen Sie ihn und installieren Sie ihn dann mit demselben Token. Die Installation startet ihn auch.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Der Job behält den Pfad der Datei, aus der er installiert wurde. Bleibt der Client nach einem manuellen Upgrade am selben Ort, genügt es, den Dienst mit --stop-service zu stoppen, die Datei zu ersetzen und den Dienst mit --start-service zu starten. Als Dienst ausführen beschreibt diese Befehle.
Deinstallieren #
- Wenn Sie den Dienst installiert haben, entfernen Sie ihn:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Um das gespeicherte Token zu entfernen, starten Sie den Client und drücken Sie F12.
- Entfernen Sie den Client. Mit Homebrew:
brew uninstall localtonet, undbrew untap localtonet/tap, um den Tap zu entfernen. Löschen Sie nach einer manuellen Installation die Dateilocaltonet.
Fehlerbehebung #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
Der Befehl wurde ohne Root-Rechte ausgeführt. Wiederholen Sie ihn mit sudo.
sudo: localtonet: command not found
sudo findet den Client nicht in seinem eigenen Suchpfad. Geben Sie stattdessen den vollständigen Pfad an. command -v localtonet gibt ihn aus, zum Beispiel:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>Nach einer manuellen Installation ohne den PATH-Schritt lautet der Pfad ~/localtonet/localtonet.
Install failed: Plist already exists for 'Localtonet_…'
Ein Dienst für dieses Token ist bereits installiert. Prüfen Sie ihn mit --status-service. Um ihn erneut zu installieren, führen Sie zuerst --remove-service aus.
Der Dienst ist installiert, aber das Token bleibt Offline
Lesen Sie das Fehlerprotokoll des Jobs, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, und prüfen Sie, ob die Datei localtonet noch an dem Pfad existiert, den sie bei der Installation des Dienstes hatte.
Wrong Token!
Der Client erwartet den 33 Zeichen langen 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!
Auf diesem Mac läuft bereits ein anderer Localtonet-Client mit demselben Token. Schließen Sie ihn oder starten Sie diesen mit einem anderen Token. Verwenden Sie einen laufenden Client pro Token.