Die Seite Terminal gibt dir eine vollwertige SSH-Shell auf deinem Server, direkt im Browser. Du brauchst keinen SSH-Client, keinen Key auf deinem eigenen Computer und nicht die Adresse des Servers: Vimonto Deploy öffnet die Verbindung mit dem eigenen Key des Servers.
Nutze es, um schnell einen Befehl auszuführen, ein Log mit tail -f zu lesen, php artisan tinker zu starten oder dich umzusehen, wenn etwas schiefgeht. Du findest es in der Seitenleiste des Servers unter Terminal oder über Web-Terminal in der Serverkopfzeile.
Ein Terminal öffnen
- Öffne den Server und wähle Terminal in der Seitenleiste.
- Wähle, als wer du dich anmeldest: als Systembenutzer des Servers (zum Beispiel
vimonto) oder alsroot. - Klicke auf Verbinden.
Nach einem Moment zeigt der Status Verbunden als gefolgt von Benutzer und Server, zum Beispiel vimonto@web-1, und du kannst tippen. Füge mit Cmd+V unter macOS oder Strg+V unter Windows und Linux ein. Das Terminal passt sich der Größe deines Browserfensters an.
Um die Sitzung zu beenden, klicke auf Trennen, tippe exit oder schließe den Tab. Um dich erneut zu verbinden, klicke auf Neu verbinden.
Als welcher Benutzer meldest du dich an?
| Benutzer | Wann du ihn verwendest |
|---|---|
Der Systembenutzer (standardmäßig vimonto) |
Für die tägliche Arbeit: Hier liegen deine Sites, Deployments und Artisan-Befehle. Er kann sudo mit dem sudo-Passwort nutzen, das du beim Erstellen des Servers bekommen hast. |
root |
Für administrative Arbeit, etwa Pakete installieren oder die Systemkonfiguration bearbeiten. |
Der Benutzer steht für eine Sitzung fest. Um zu wechseln, klicke zuerst auf Trennen, wähle dann den anderen Benutzer und verbinde dich erneut.
Wie funktioniert das Browser-Terminal?
Ein Browser kann selbst keine SSH-Verbindung öffnen. Deshalb betreibt Vimonto Deploy eine kleine Terminal-Bridge: einen separaten Dienst, der zwischen deinem Browser und dem Server sitzt.
- Wenn du auf Verbinden klickst, prüft die App deine Berechtigung und erstellt ein Einmal-Ticket, das 30 Sekunden gültig ist. Gespeichert wird nur ein Hash des Tickets.
- Dein Browser öffnet einen sicheren WebSocket zur Terminal-Bridge und übergibt das Ticket. Der Browser erhält nie den privaten Key oder die Adresse des Servers.
- Die Bridge löst das Ticket bei der App ein. Die App prüft erneut, ob du noch Zugriff hast, und gibt der Bridge dann, was sie zum Verbinden braucht: Adresse, SSH-Port, privaten Key und bekannten Host-Key des Servers. Ein Ticket funktioniert einmal; eine zweite Verwendung wird abgelehnt.
- Die Bridge verbindet sich per SSH mit dem Server. Sie akzeptiert nur den Host-Key, den Vimonto Deploy bei der ersten Verbindung mit dem Server gespeichert hat. Zeigt der Server einen anderen Key, verweigert die Bridge die Verbindung.
- Tastatureingaben und Ausgabe fließen zwischen deinem Browser und dem Server, bis die Sitzung endet.
Der private Key bleibt nur für die Dauer der Sitzung im Arbeitsspeicher der Bridge.
Wer darf das Terminal nutzen?
Ein Terminal gibt vollen Zugriff auf den Server. Deshalb hat es eine eigene Berechtigung, getrennt von der Serververwaltung. Diese Rollen haben sie:
| Rolle | Terminal |
|---|---|
| Owner | Ja |
| Administrator | Ja |
| Manager | Ja |
| Developer | Ja |
| Betrachter | Nein |
Mitglieder ohne die Berechtigung sehen Kein Terminal für deine Rolle und können einen Administrator um eine andere Rolle bitten. Siehe Mitglieder und Rollen.
Die Berechtigung wird geprüft, wenn du auf Verbinden klickst, und erneut, wenn die Bridge das Ticket einlöst. Ein Mitglied, dessen Rolle gerade geändert wurde, kann ein Ticket, das es schon hatte, also nicht mehr verwenden.
Das Terminal öffnet sich nur auf einem aktiven Server. Vimonto Deploy muss außerdem den SSH-Host-Key des Servers kennen, den es bei der ersten Verbindung erfährt. Bei einem eigenen VPS, der verbunden, aber nie genutzt wurde, führe zuerst eine Aktion aus, etwa die Seite Services öffnen.
Was wird protokolliert?
Vimonto Deploy erfasst, wer eine Shell hatte, als welcher Benutzer, wann und wie lange. Was du tippst oder was der Server ausgibt, wird nie gespeichert.
- Letzte Sitzungen unten auf der Seite Terminal listet die letzten zehn Sitzungen mit dem Namen des Mitglieds, dem Login-Benutzer, der Dauer und der Startzeit. Eine laufende Sitzung ist mit Aktiv markiert.
- Wenn eine Sitzung endet, wird ein Eintrag wie Terminal als root auf web-1 zur Aktivität des Servers und zur Aktivitätsseite der Organisation hinzugefügt, mit der Angabe, wie die Sitzung endete: im Browser geschlossen, auf dem Server beendet, nach einer Zeit ohne Eingabe geschlossen oder durch einen Fehler abgebrochen.
Zeitlimits
| Limit | Wert |
|---|---|
| Gültigkeit des Tickets | 30 Sekunden, einmalig |
| Keine Eingabe | Die Verbindung wird nach 15 Minuten ohne Tastendruck geschlossen (Standardwert; deine Installation kann einen anderen Wert nutzen, der unter dem Terminal angezeigt wird). |
| Maximale Sitzungsdauer | 8 Stunden |
Wenn eine Sitzung aus einem dieser Gründe geschlossen wird, nennt die Statuszeile den Grund. Klicke auf Neu verbinden, um eine neue Sitzung zu starten.
Fehlerbehebung
| Meldung | Was sie bedeutet |
|---|---|
| Dieses Ticket ist abgelaufen oder wurde bereits verwendet. Verbinde dich erneut. | Der Browser hat länger als 30 Sekunden zum Verbinden gebraucht, oder das Ticket wurde schon verwendet. Klicke auf Neu verbinden. |
| Du hast (nicht mehr) Zugriff auf ein Terminal auf diesem Server. | Deine Rolle hat sich geändert, oder der Server ist nicht mehr aktiv. |
| Der SSH-Host-Key des Servers hat sich geändert; wir stellen keine Verbindung her. | Der Server zeigt einen anderen Host-Key. Wenn du den Server neu installiert hast, verwende Host-Key vergessen in den Servereinstellungen. Andernfalls fängt womöglich jemand die Verbindung ab. |
| Der Server lehnt unseren Schlüssel ab. | Der Key des Servers wurde aus authorized_keys entfernt. |
| Der Server ist über SSH nicht erreichbar. | Der Server ist aus, oder die Firewall oder der SSH-Port blockiert die Verbindung. Prüfe die Einstellungen unter Netzwerk. |
| Der Terminal-Server ist nicht erreichbar. | Die Terminal-Bridge läuft nicht oder ist von deinem Browser aus nicht erreichbar. |
Häufig gestellte Fragen
Ist das Browser-Terminal sicher?
Ja. Dein Browser hat immer nur ein Ticket, das einmal funktioniert und nach 30 Sekunden abläuft. Der private Key des Servers erreicht den Browser nie, die Verbindung wird abgelehnt, wenn der Host-Key des Servers nicht zum bekannten passt, und deine Berechtigung wird zweimal geprüft. Sitzungen werden nach einer Zeit ohne Eingabe geschlossen.
Kann ich stattdessen meinen eigenen SSH-Client verwenden?
Ja. Füge deinen öffentlichen Key unter SSH-Schlüssel hinzu und verwende in der Serverkopfzeile Mit SSH anmelden und dann SSH-Befehl kopieren, zum Beispiel ssh vimonto@203.0.113.10.
Zeichnet Vimonto Deploy meine Befehle auf?
Nein. Tastatureingaben und Ausgabe werden nie gespeichert. Protokolliert wird nur die Sitzung selbst: wer, als welcher Benutzer, wann und wie lange.
Kann ich mich als root anmelden?
Ja, wähle vor dem Verbinden root. Root hat kein Passwort; die Anmeldung erfolgt mit dem Key des Servers.