Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet unter macOS installieren

Hilfe zu dieser Seite
Auf dieser Seite 9 Abschnitte
  1. Bevor Sie beginnen
  2. Mit Homebrew installieren
  3. Den Localtonet-Tap hinzufügen und installieren
  4. Die Installation prüfen
  5. Manuell installieren
  6. Herunterladen und entpacken
  7. Optional: in den PATH verschieben
  8. Den Client starten
  9. Mit Ihrem Token starten
  10. Die Sitzung prüfen
  11. Als launchd-Dienst ausführen
  12. Den Dienst installieren
  13. Prüfen, ob er läuft
  14. Was die Installation anlegt
  15. Dienstbefehle
  16. Aktualisieren
  17. Deinstallieren
  18. Fehlerbehebung
  19. 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 sudo verwenden kann.

Mit Homebrew installieren #

  1. 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.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. Die Installation prüfen #

    Terminal
    localtonet --version

    Der 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.

MacArchiv
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Herunterladen und entpacken #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -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
  2. Optional: in den PATH verschieben #

    Ohne diesen Schritt starten Sie den Client über seinen Pfad, ~/localtonet/localtonet. Danach können Sie in jedem Ordner localtonet eingeben.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Den Client starten #

  1. Mit Ihrem Token starten #

    Terminal
    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.

  2. 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, Ping und Status. 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.

  1. Den Dienst installieren #

    Terminal
    sudo 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.

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

    Terminal
    sudo 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 #

ElementSpeicherort
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.

BefehlFunktion
--install-serviceSchreibt die Jobdefinition, lädt sie und startet den Client.
--start-serviceStartet den Job. Läuft er bereits, startet launchd ihn neu.
--stop-serviceStoppt den Client. Der Job bleibt installiert und startet beim nächsten Systemstart wieder.
--status-serviceGibt den Zustand aus, zum Beispiel Running, Stopped, NotFound oder Error.
--remove-serviceStoppt 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.

Terminal
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 #

  1. Wenn Sie den Dienst installiert haben, entfernen Sie ihn: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Um das gespeicherte Token zu entfernen, starten Sie den Client und drücken Sie F12.
  3. Entfernen Sie den Client. Mit Homebrew: brew uninstall localtonet, und brew untap localtonet/tap, um den Tap zu entfernen. Löschen Sie nach einer manuellen Installation die Datei localtonet.

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:

Bash
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.

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

Support