User Manual

awaBerry | Webbasiertes SSH-Terminal

Verbinden Sie sich über Web-SSH mit jedem awaBerry-Gerät. Öffnen Sie eine vollständige Terminalsitzung in Ihrem Browser – authentifiziert, verschlüsselt und...

Webbasiertes SSH-Terminal

Zusammenfassung

Das webbasierte SSH-Terminal bietet eine leistungsstarke Möglichkeit, Ihr verbundenes Gerät direkt über SSH (Secure Shell)-Befehle zu steuern. Diese Schnittstelle ermöglicht es Ihnen, Befehle zu senden, die Ausgabe in Echtzeit anzuzeigen, mehrere Terminalsitzungen zu verwalten und auf verschiedene Werkzeuge für eine effiziente Geräteinteraktion zuzugreifen, alles innerhalb Ihres Webbrowsers.

Seitenaufruf

Sie können diese Seite aufrufen, indem Sie zu folgender Adresse navigieren: /devices_connect

Seitenfunktionen

Das webbasierte SSH-Terminal bietet eine direkte Schnittstelle zur Steuerung Ihres verbundenen Geräts. Hier sind seine Hauptfunktionen und wie Sie mit ihnen interagieren können:

Terminal-Anzeigebereich

Dies ist das Hauptfenster, in dem Sie die Ausgabe Ihrer Befehle und Nachrichten vom Gerät sehen. Wenn Sie sich zum ersten Mal verbinden, sehen Sie möglicherweise die Meldung "Terminal wird initialisiert", während die Verbindung hergestellt wird.

Befehlseingabefeld & Senden-Schaltfläche

Am unteren Rand der Seite finden Sie ein Textfeld mit der Beschriftung "Befehl eingeben". Geben Sie hier Ihre gewünschten Linux-Befehle ein. Um einen Befehl auszuführen, drücken Sie entweder die Enter-Taste auf Ihrer Tastatur oder klicken Sie auf die Senden-Schaltfläche neben dem Eingabefeld. Während ein Befehl verarbeitet wird, zeigt die Senden-Schaltfläche einen rotierenden Kreis an.

Obere Menüleiste

Diese Leiste befindet sich am oberen Rand des Terminalbereichs und bietet verschiedene Werkzeuge zur Sitzungsverwaltung:

  • Menüleiste ein-/ausblenden: Dieses Symbol ermöglicht es Ihnen, die vollständige Menüleiste auszublenden oder anzuzeigen. Durch das Ausblenden wird mehr Platz für die Terminalanzeige geschaffen. Wenn ausgeblendet, wird der Text "SSH-Konsole" mit einem Tooltip angezeigt.
  • Terminalfenster wechseln: (Nur für nicht freigegebene Geräte) Diese Funktion ermöglicht es Ihnen, bis zu vier separate Terminalsitzungen gleichzeitig zu verwalten. Klicken Sie auf das Symbol, um nummerierte Kreise (1-4) anzuzeigen; ein Klick auf eine Nummer wechselt zu diesem Terminalfenster.
  • Administratorbenutzer aktivieren / deaktivieren: (Nur für nicht freigegebene Geräte) Verwenden Sie dieses Symbol, um Administratorrechte für Ihre aktuelle Sitzung zu erhöhen oder zu widerrufen, sodass Sie Befehle ausführen können, die erhöhte Berechtigungen erfordern.
  • Ausgewählten Text kopieren: Wenn Sie Text im Terminalfenster auswählen, kopiert dieses Symbol ihn in die Zwischenablage Ihres Computers. Sie können auch die Tastenkombination Strg+C (Windows/Linux) oder Cmd+C (macOS) verwenden.
  • Text einfügen: Klicken Sie auf dieses Symbol, um Text aus der Zwischenablage Ihres Computers direkt in das Befehlseingabefeld einzufügen. Die Tastenkombination Strg+V (Windows/Linux) oder Cmd+V (macOS) funktioniert ebenfalls. Diese Funktionalität ist für Demo-Freigabegeräte im Allgemeinen nicht verfügbar.
  • Terminalsitzung trennen: Ein Klick auf dieses Symbol beendet sofort Ihre aktuelle SSH-Verbindung zum Gerät.

Intelligente Chat-Schaltfläche

Die Chat-Schaltfläche, die sich ganz rechts in der oberen Menüleiste befindet, ermöglicht es Ihnen, vom direkten SSH-Terminal zu einer intelligenten Chat-basierten Schnittstelle für die Interaktion mit Ihrem Gerät zu wechseln.

Banner für freigegebene Geräte

Für bestimmte freigegebene Geräte (z. B. Demo-Geräte) kann oben im Terminalbereich ein informatives blaues Banner erscheinen. Dieses Banner enthält wichtige Details zu Ihrem Zugriff. Sie können es schließen, indem Sie auf das Schließen-Symbol klicken.

Fehlerbenachrichtigung beim Senden von Befehlen

Wenn beim Senden Ihres Befehls ein Problem auftritt, wird am unteren Bildschirmrand die temporäre Meldung "Fehler beim Senden des Befehls - versuchen Sie es erneut (drücken Sie Enter)" angezeigt. Dies weist auf ein vorübergehendes Kommunikationsproblem hin.

Szenarioausführungen

Mögliche Nutzungsschritte auf dieser Seite

Szenario: Grundlegende Befehlsausführung

  1. Stellen Sie sicher, dass das Terminal initialisiert und bereit ist (die Meldung "Terminal wird initialisiert" ist verschwunden).
  2. Geben Sie einen Befehl ein, z. B. ls -l, in das Feld "Befehl eingeben".
  3. Drücken Sie die Enter-Taste auf Ihrer Tastatur oder klicken Sie auf die Senden-Schaltfläche.
  4. Erwartetes Ergebnis: Die Terminalanzeige zeigt die Ausgabe des Befehls ls -l an, der Dateien und Verzeichnisse auf Ihrem Gerät auflistet.

Szenario: Text kopieren und einfügen

  1. Nachdem Sie einen Befehl ausgeführt haben, wählen Sie mit Ihrer Maus einen Teil des Ausgabetextes in der Terminalanzeige aus.
  2. Klicken Sie auf das Kopieren-Symbol in der oberen Menüleiste (oder verwenden Sie Strg+C / Cmd+C).
  3. Klicken Sie in das Feld "Befehl eingeben".
  4. Klicken Sie auf das Einfügen-Symbol in der oberen Menüleiste (oder verwenden Sie Strg+V / Cmd+V).
  5. Erwartetes Ergebnis: Der kopierte Text wird im Feld "Befehl eingeben" angezeigt. Sie können diesen Text dann bearbeiten oder senden.

Szenario: Wechseln von Terminalfenstern (für nicht freigegebene Geräte)

  1. Klicken Sie auf das Symbol "Terminalfenster wechseln" in der oberen Menüleiste.
  2. Unter der Menüleiste erscheinen nummerierte Kreise (1, 2, 3, 4).
  3. Klicken Sie auf eine der Nummern, z. B. "2".
  4. Erwartetes Ergebnis: Die Terminalansicht wechselt zu einer neuen, sauberen Terminalsitzung (Fenster 2). Sie können wiederholen, um zurück oder zu anderen Fenstern zu wechseln.

Szenario: Trennen der Sitzung

  1. Klicken Sie auf das Symbol "Terminalsitzung trennen" in der oberen Menüleiste.
  2. Erwartetes Ergebnis: Eine temporäre Meldung "Terminalsitzung wird getrennt" wird angezeigt und Ihre Verbindung zum Gerät wird beendet. Das Terminal kann nicht mehr reagieren oder eine Trennmeldung anzeigen.

Szenario: Zugriff auf das intelligente Chat-Terminal

  1. Klicken Sie auf die Chat-Schaltfläche ganz rechts in der oberen Menüleiste.
  2. Erwartetes Ergebnis: Die Benutzeroberfläche wechselt vom direkten SSH-Terminal zum intelligenten Chat-Terminal, wo Sie mit natürlicher Sprache mit Ihrem Gerät interagieren können.

Mögliche Fehler, die auf dieser Seite auftreten können

Fehler: Befehlssendung fehlgeschlagen

Warum es passiert: Dies geschieht in der Regel aufgrund einer vorübergehenden Netzwerkunterbrechung zwischen Ihrem Browser und dem Gerät oder wenn der Befehl aus irgendeinem Grund vom Gerät nicht verarbeitet werden konnte.

Was zu tun ist: Eine Meldung "Fehler beim Senden des Befehls - versuchen Sie es erneut (drücken Sie Enter)" wird angezeigt. Geben Sie Ihren Befehl einfach erneut ein oder senden Sie ihn erneut. Wenn das Problem weiterhin besteht, überprüfen Sie Ihre Internetverbindung oder den Status des Geräts.

Fehler: Terminal reagiert nicht mehr (Sitzung abgelaufen/getrennt)

Warum es passiert: Wenn Ihre Sitzung zu lange inaktiv war, kann sie aus Sicherheitsgründen ablaufen und getrennt werden. Alternativ kann ein Netzwerkproblem zu einer unerwarteten Trennung geführt haben.

Was zu tun ist: Sie werden feststellen, dass eingegebene Befehle keine Ausgabe erzeugen und die Senden-Schaltfläche möglicherweise nicht reagiert. Sie müssen die Seite aktualisieren oder zum Bildschirm für die Geräteverbindung zurückkehren, um eine neue SSH-Sitzung herzustellen.

Fehler: "Zugriff verweigert" beim Ausführen eines Befehls

Warum es passiert: Einige Befehle erfordern spezielle Administratorrechte, um ausgeführt zu werden. Wenn Ihre aktuelle Sitzung diese Berechtigungen nicht hat, lehnt das Gerät den Befehl ab.

Was zu tun ist: (Nur für nicht freigegebene Geräte) Klicken Sie in der oberen Menüleiste auf das Symbol Administratorbenutzer aktivieren / deaktivieren, um Ihre Berechtigungen zu erhöhen, und versuchen Sie den Befehl erneut. Denken Sie daran, den Admin-Modus zu deaktivieren, wenn er aus Sicherheitsgründen nicht mehr benötigt wird.

Fehler: Keine Einfügeoption für freigegebene Demo-Geräte

Warum es passiert: Aus Sicherheits- und Demonstrationsgründen sind einige freigegebene Demo-Geräte so konfiguriert, dass das direkte Einfügen von Befehlen in das Terminal verhindert wird. Dies stellt sicher, dass Benutzer nur vordefinierte oder manuell eingegebene Befehle ausführen.

Was zu tun ist: Wenn Sie ein freigegebenes Demo-Gerät verwenden, ist das Einfügen-Symbol nicht verfügbar. Sie müssen Befehle manuell eingeben.