Zum Inhalt springen
Localtonet Localtonet Dashboard

Geräte-Terminal

Kostenlos Desktop v8.6+ Windows, Linux und macOS

Hilfe zu dieser Seite
Auf dieser Seite 13 Abschnitte
  1. So funktioniert es
  2. Bevor Sie beginnen
  3. Gerät hinzufügen
  4. Gerät hinzufügen öffnen
  5. Token auswählen
  6. Befehl auf dem Computer ausführen
  7. Code eingeben und genehmigen
  8. Ohne jemanden am Computer
  9. Befehlsoptionen
  10. Die Geräteliste
  11. Ein Terminal im Browser öffnen
  12. Terminal auswählen
  13. Authenticator-Code eingeben
  14. Verbindung mit ssh
  15. SSH-Schlüssel
  16. Mit dem Localtonet-Client
  17. Zugriffsschlüssel für Skripte und KI-Agenten
  18. Elio
  19. Verbindungsverlauf
  20. Gerät umbenennen, entfernen oder deaktivieren
  21. Sicherheitshinweise
  22. Fehlerbehebung
  23. Verwandte Seiten

Meine Geräte listet Ihre Computer mit CPU-, Arbeitsspeicher- und Festplattenauslastung auf und öffnet auf jedem davon eine echte Shell direkt aus Ihrem Browser. Sie aktivieren die Funktion mit einem einzigen Befehl auf dem Rechner; auf dem Computer muss kein öffentlicher Port lauschen.

So funktioniert es #

Sie führen localtonet --terminal enable auf dem Rechner aus und genehmigen den kurzen Code, den der Befehl ausgibt, in Ihrem Dashboard. Danach öffnet die Schaltfläche Terminal in einem Browser-Tab eine Shell auf diesem Rechner. Dieselbe Shell erreichen Sie von jedem Terminal aus mit einem ssh-Befehl, den das Dashboard anzeigt.

  • Das Gerät baut nur ausgehende Verbindungen auf. Sie müssen keinen eingehenden Port öffnen und keinen SSH-Server installieren.
  • Zum Öffnen einer Shell im Browser benötigen Sie jedes Mal einen frischen Code aus Ihrer Authenticator-App.
  • Nur der lokale Befehl kann das Terminal aktivieren. Es lässt sich nicht über das Dashboard einschalten.

Bevor Sie beginnen #

  • Localtonet auf dem Rechner. Für diese Funktion erforderliche Mindestversion der Localtonet-App: Desktop v8.6. Sie finden sie auf der Seite Downloads.
  • Ein AuthToken für diesen Rechner. Geben Sie jedem Computer ein eigenes Token: Wenn Sie ein Token auf einem zweiten Computer ausführen, wird der erste getrennt. Das Terminal funktioniert mit Tokens Ihres persönlichen Kontos, nicht mit Team-Tokens. Siehe AuthTokens.
  • Zwei-Faktor-Authentifizierung. Zum Öffnen einer Shell benötigt Ihr Konto eine Authenticator-App. Ist sie noch nicht eingerichtet, zeigt Meine Geräte Zwei-Faktor-Authentifizierung aktivieren an. Siehe Konto und Sicherheit.

Meine Geräte finden Sie im Menü Ihres persönlichen Dashboards. Die Seite wird nicht angezeigt, solange ein Team ausgewählt ist.

Gerät hinzufügen #

  1. Gerät hinzufügen öffnen #

    Öffnen Sie Meine Geräte und wählen Sie Gerät hinzufügen.

  2. Token auswählen #

    Wählen Sie ein vorhandenes Token aus oder wählen Sie Neuen Token erstellen, um eines anzulegen und in den Befehl einzusetzen. Läuft Localtonet bereits auf diesem Computer, wählen Sie dessen Token. Die Liste kennzeichnet Tokens, die online sind oder bereits auf einem anderen Gerät verwendet werden. Ein Token, das gerade verbunden ist, zeigt eine Warnung: Verwenden Sie es nur, wenn Localtonet auf genau diesem Computer läuft.

  3. Befehl auf dem Computer ausführen #

    Kopieren Sie den Befehl aus dem Dialog und führen Sie ihn in einem Terminal auf dem Computer aus, den Sie hinzufügen möchten. Läuft Localtonet dort als Dienst, verwenden Sie ein Administrator-Terminal oder sudo.

    Auf dem Computer
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    Der Befehl gibt einen Genehmigungscode aus und wartet:

    Ausgabe
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    Wenn Sie ihn als Administrator oder root ausführen, fragt er zuerst Run shells as user: und schlägt Ihr eigenes Konto vor. Ohne diese Rechte laufen Shells unter dem Konto, das den Befehl ausgeführt hat.

  4. Code eingeben und genehmigen #

    Geben Sie im Dialog den Genehmigungscode unter 2. Geben Sie den angezeigten Code ein ein. Großbuchstaben und der Bindestrich werden automatisch ergänzt, und Sie können die gesamte vom Befehl ausgegebene Zeile einfügen. Geben Sie den 6-stelligen Code aus Ihrer Authenticator-App ein und wählen Sie Gerät genehmigen.

    Der Befehl auf dem Computer gibt dann Terminal enabled. Shells will run as … aus, und das Gerät erscheint in der Liste. Es wird als online angezeigt, solange Localtonet darauf läuft.

Der Genehmigungscode ist 15 Minuten gültig. Er besteht aus 8 Zeichen und enthält nie die Zeichen I, L, O, U, 0 oder 1. Läuft er ab, meldet der Befehl das: Führen Sie ihn erneut aus.

Nach der Genehmigung läuft ein Befehl, den Sie von Hand in einer Konsole gestartet haben, als normaler Localtonet-Lauf weiter. In einem Skript oder wenn Localtonet auf dem Gerät bereits mit diesem Token läuft, beendet sich der Befehl, sobald das Terminal aktiviert ist.

Ohne jemanden am Computer #

Für einen Rechner, an dem niemand einen Code ablesen kann, zum Beispiel einen Server, den Sie per Skript einrichten, verwenden Sie statt des Genehmigungscodes einen Einmalschlüssel.

  1. Wählen Sie im Dialog Gerät hinzufügen das Token aus und geben Sie Ihren Authenticator-Code ein.
  2. Öffnen Sie Niemand kann auf diesem Computer einen Code ablesen? und wählen Sie Einmalschlüssel erstellen. Der Schlüssel ist eine Stunde gültig und funktioniert nur einmal.
  3. Kopieren Sie den Befehl und ersetzen Sie ACCOUNT durch das Benutzerkonto, unter dem Shells auf diesem Computer laufen sollen.
Auf dem Computer
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

Mit einem gültigen Schlüssel wird das Gerät sofort genehmigt, und es wird kein Code angezeigt.

Befehlsoptionen #

OptionFunktion
--terminal enableAktiviert das Remote-Terminal für diesen Computer und startet die Kopplung.
--terminal disableDeaktiviert es auf diesem Computer und entfernt das Gerät aus Ihrem Konto.
--terminal statusGibt aus, ob das Terminal aktiviert ist und unter welchem Konto Shells laufen.
--terminal-user <ACCOUNT>Das Konto, unter dem Shells laufen, wenn Sie als root oder Administrator aktivieren. In diesem Fall erforderlich, wenn der Befehl ohne Konsole läuft, zum Beispiel aus einem Skript.
--pairing-key <PAIRING_KEY>Der Einmalschlüssel aus dem Dashboard, sodass kein Genehmigungscode nötig ist.

Die Geräteliste #

Die Liste aktualisiert sich selbstständig, solange die Seite geöffnet ist.

SpalteWas sie zeigt
GerätDer Name des Computers, sein Betriebssystem und seine Architektur sowie das Konto, unter dem Shells laufen.
StatusOnline bedeutet, dass Localtonet auf dem Computer läuft und verbunden ist.
CPUAktuelle Prozessorauslastung. Wird angezeigt, solange das Gerät online ist.
ArbeitsspeicherBelegter Arbeitsspeicher im Verhältnis zum Gesamtspeicher. Wird angezeigt, solange das Gerät online ist.
FestplatteBelegter Speicherplatz im Verhältnis zur Gesamtkapazität. Wird angezeigt, solange das Gerät online ist.
AktionenTerminal, Schlüssel, Verbindungsverlauf, Umbenennen und Entfernen.

Ein Terminal im Browser öffnen #

  1. Terminal auswählen #

    Wählen Sie in der Zeile des Geräts Terminal. Die Schaltfläche funktioniert nur, solange das Gerät online ist. Der Dialog zeigt Ihnen, unter welchem Konto die Shell läuft.

  2. Authenticator-Code eingeben #

    Geben Sie den 6-stelligen Code aus Ihrer Authenticator-App ein und wählen Sie Terminal öffnen. Die Shell öffnet sich in einem neuen Browser-Tab.

Verbindung mit ssh #

Der Dialog Terminal zeigt unter Oder aus jedem Terminal, ohne etwas zu installieren außerdem einen Befehl an. Er funktioniert von jedem Computer mit einem ssh-Client. Der Befehl hat diese Form, wobei <DEVICE> der Name Ihres Geräts und <NODE> der Localtonet-Server ist, mit dem es verbunden ist:

Beliebiges Terminal
ssh -p 24 <DEVICE>@<NODE>

Kopieren Sie den Befehl aus dem Dialog: Er zeigt den genauen Befehl für Ihr Gerät.

  • Der Dialog zeigt den Server-Fingerabdruck. ssh zeigt beim ersten Verbinden einen Fingerabdruck an. Stimmen beide überein, haben Sie Localtonet erreicht.
  • Haben Sie keinen SSH-Schlüssel hinzugefügt, zeigt ssh einen Link zur Genehmigung in Ihrem Browser an. Die Seite Verbindung genehmigen nennt das Gerät und die IP-Adresse, von der die Anfrage kam. Geben Sie Ihren Authenticator-Code ein, wählen Sie Verbindung zulassen und kehren Sie dann zu Ihrem Terminal zurück. Die Anfrage läuft nach 5 Minuten ab.

Genehmigen Sie eine Verbindung nur, wenn Sie den ssh-Befehl gerade selbst ausgeführt haben. Wer die Anfrage gestellt hat, erhält eine Shell auf diesem Computer.

SSH-Schlüssel #

Fügen Sie den öffentlichen SSH-Schlüssel Ihres eigenen Computers hinzu, damit ssh, scp und sftp sich verbinden, ohne im Browser nach einer Genehmigung zu fragen.

  1. Wählen Sie unter Meine Geräte SSH-Schlüssel.
  2. Geben Sie einen Name ein und fügen Sie eine Zeile Ihrer Datei mit dem öffentlichen Schlüssel, zum Beispiel ~/.ssh/id_ed25519.pub, in Public Key ein. Fügen Sie niemals Ihren privaten Schlüssel ein.
  3. Geben Sie Ihren Authenticator-Code ein und wählen Sie Schlüssel hinzufügen.

Akzeptierte Schlüsseltypen sind ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 und ssh-rsa. Ein Schlüssel gilt für alle Geräte Ihres Kontos. Wählen Sie neben einem Schlüssel Entfernen, damit er nicht mehr funktioniert. Der Dialog zeigt außerdem ein scp-Beispiel für eines Ihrer Geräte:

Beliebiges Terminal
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

Mit dem Localtonet-Client #

Ist Localtonet auf dem Computer installiert, von dem aus Sie sich verbinden, verbindet auch localtonet ssh, und die Sitzung bleibt bis zum Gerät verschlüsselt.

Beliebiges Terminal
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

Ohne Schlüssel gibt der Befehl Approve this connection in your browser mit einem Link aus und läuft weiter, sobald Sie genehmigen. Alles nach -- wird als ein Befehl auf dem Gerät ausgeführt, statt eine Shell zu öffnen.

Zugriffsschlüssel für Skripte und KI-Agenten #

Mit einem Zugriffsschlüssel erreicht ein Skript oder ein KI-Agent einen Computer ohne Browser. Wer ihn besitzt, kann dort Befehle ausführen. Halten Sie ihn daher geheim.

  1. Wählen Sie in der Zeile des Geräts Schlüssel.
  2. Geben Sie einen Name ein, legen Sie Gültig für (Tage) fest und geben Sie Ihren Authenticator-Code ein. Der Schlüssel funktioniert nach dieser Anzahl von Tagen nicht mehr, höchstens nach 3650.
  3. Wählen Sie Schlüssel erstellen und kopieren Sie den Schlüssel jetzt. Er wird nicht noch einmal angezeigt.

So verwenden Sie den Schlüssel:

  • ssh. Führen Sie den ssh-Befehl aus, den der Dialog zeigt. Wenn ssh fragt, fügen Sie den Schlüssel ein.
  • Localtonet-Client. Übergeben Sie den Schlüssel mit der Option --key, wie im folgenden Beispiel.
  • MCP. KI-Agenten, die mit dem MCP-Server von Localtonet verbunden sind, können den Schlüssel an das Tool RunDeviceCommand übergeben.
Skript
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

Der Dialog listet die Schlüssel des Geräts mit ihrem Ablaufdatum auf. Wählen Sie Entfernen, um einen zu widerrufen.

Elio #

Die Schaltfläche Elio unter Meine Geräte bezieht sich auf Elio, den kostenlosen Open-Source-SSH-Client von Localtonet. Sie laden ihn von elio.sh herunter, melden sich in Elio an und genehmigen die Anfrage im Dashboard mit Ihrem Zwei-Faktor-Code. Elio sieht dann die Namen und den Status Ihrer Geräte. Um darauf eine Shell zu öffnen, benötigen Sie weiterhin den Zugriffsschlüssel des Geräts oder eine Genehmigung. Der Dialog listet die angemeldeten Elio-Instanzen auf; wenn Sie eine entfernen, wird sie abgemeldet.

Verbindungsverlauf #

Wählen Sie in der Zeile eines Geräts die Uhr-Schaltfläche, um die letzten Verbindungen zu sehen. Jede Zeile zeigt, wann die Verbindung zustande kam, wie sie aufgebaut wurde und von welcher IP-Adresse. Das Wie ist eines von: das Browser-Terminal, ssh mit Ihrem SSH-Schlüssel, ssh mit einem Zugriffsschlüssel, im Browser genehmigtes ssh, localtonet ssh mit einem Zugriffsschlüssel oder im Browser genehmigt sowie ein KI-Agent über MCP mit einem Zugriffsschlüssel. Die Liste enthält die 50 jüngsten Verbindungen.

Localtonet speichert nur diesen Eintrag. Die Befehle, die Sie eingeben, und deren Ausgabe werden nicht gespeichert. Anhand der Liste erkennen Sie eine Verbindung, die nicht von Ihnen stammt: Finden Sie eine, entfernen Sie die Zugriffsschlüssel und SSH-Schlüssel, die Sie nicht mehr benötigen.

Gerät umbenennen, entfernen oder deaktivieren #

AktionWoErgebnis
UmbenennenDie Stift-Schaltfläche in der Zeile.Ändert den Namen, der in der Liste und im ssh-Befehl verwendet wird. Verwenden Sie Buchstaben, Zahlen, Punkte, Bindestriche oder Unterstriche.
EntfernenDie Papierkorb-Schaltfläche in der Zeile.Entfernt den Computer aus Ihrem Konto. Seine Schlüssel funktionieren nicht mehr, und er muss erneut genehmigt werden, um wieder dabei zu sein.
DeaktivierenAuf dem Computer selbst.Deaktiviert das Terminal lokal und entfernt das Gerät aus Ihrem Konto.
Auf dem Computer
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

Das Deaktivieren funktioniert auf dem Computer immer, auch wenn das Dashboard nicht erreichbar ist. In diesem Fall fordert Sie der Befehl auf, das Gerät zusätzlich im Dashboard zu entfernen.

Sicherheitshinweise #

  • Eine Shell auf einem Rechner bedeutet vollen Zugriff auf alles, was ihr Konto darf. Wählen Sie das Konto, unter dem Shells laufen, mit Bedacht; ein nicht privilegiertes Konto begrenzt, was eine Sitzung ändern kann.
  • Alles, was zu einer Shell führen kann, verlangt einen frischen Authenticator-Code: ein Gerät genehmigen, ein Terminal öffnen, einen Zugriffsschlüssel erstellen, einen SSH-Schlüssel hinzufügen und eine ssh-Verbindung genehmigen.
  • Ein Zugriffsschlüssel oder ein hinzugefügter SSH-Schlüssel verbindet ohne diesen Code. Geben Sie Schlüsseln eine kurze Gültigkeit, bewahren Sie sie wie Passwörter auf und entfernen Sie die, die Sie nicht mehr verwenden.
  • Nach zu vielen Versuchen in kurzer Zeit antwortet das Dashboard mit Zu viele Versuche. Warten Sie eine Minute und versuchen Sie es erneut.
  • Sehen Sie sich den Verbindungsverlauf ab und zu an. Eine Verbindung, die Sie nicht kennen, bedeutet, dass ein Schlüssel oder eine Genehmigung verwendet wurde, die Sie nicht erwartet haben.
  • Wenn Sie ein Gerät entfernen oder darauf --terminal disable ausführen, endet der Zugriff für alle seine Schlüssel.

Fehlerbehebung #

Dieser Genehmigungscode ist falsch oder abgelaufen.

Vergleichen Sie den Code mit dem, den der Befehl ausgegeben hat. Ein Code ist 15 Minuten gültig und gehört zum Konto des Tokens im Befehl. Führen Sie den Befehl erneut aus, um einen neuen Code zu erhalten.

Remote terminal is available on personal tokens only

Das Token im Befehl gehört zu einem Team. Erstellen Sie ein Token in Ihrem persönlichen Konto und verwenden Sie dieses.

The pairing key is not valid or has expired

Ein Einmalschlüssel funktioniert einmal und eine Stunde lang. Erstellen Sie im Dialog Gerät hinzufügen einen neuen.

Konto für Shells mit --terminal-user wählen

Der Befehl läuft als root oder Administrator ohne Konsole und kann daher nicht nachfragen. Fügen Sie --terminal-user <ACCOUNT> hinzu.

Die Schaltfläche Terminal ist deaktiviert, oder Dieses Gerät ist offline.

Das Terminal öffnet sich nur, solange das Gerät online ist. Starten Sie Localtonet auf diesem Computer mit demselben Token.

Dieser Authenticator-Code ist nicht korrekt.

Geben Sie den 6-stelligen Code ein, den Ihre Authenticator-App für Localtonet anzeigt. Es ist weder Ihr Passwort noch der Code, der auf dem Computer angezeigt wird, und er ändert sich alle 30 Sekunden.

Diese Anfrage ist abgelaufen. Beginnen Sie erneut bei „Meine Geräte“.

Eine Anfrage zum Öffnen eines Terminals oder zum Genehmigen einer ssh-Verbindung ist nur kurz gültig. Wählen Sie erneut Terminal oder führen Sie den ssh-Befehl erneut aus.

Das sieht nicht nach einem öffentlichen SSH-Schlüssel aus.

Fügen Sie die ganze Zeile aus Ihrer .pub-Datei ein, beginnend mit dem Schlüsseltyp.

The terminal is already enabled on this device

Nichts zu tun. Um den Rechner erneut zu koppeln, führen Sie zuerst --terminal disable und dann --terminal enable aus.

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

Support