La pagina Terminale ti offre una shell SSH completa sul tuo server, direttamente nel browser. Non ti servono un client SSH, una chiave sul tuo computer o l'indirizzo del server: Vimonto Deploy apre la connessione con la chiave del server stesso.
Usala per eseguire al volo un comando, leggere un log con tail -f, lanciare php artisan tinker o dare un'occhiata quando qualcosa va storto. La trovi nella barra laterale del server in Terminale, oppure tramite Terminale web nell'intestazione del server.
Apri un terminale
- Apri il server e scegli Terminale nella barra laterale.
- Scegli con quale utente accedere: l'utente di sistema del server (ad esempio
vimonto) oppureroot. - Clicca su Connetti.
Dopo un attimo lo stato indica Connesso come seguito da utente e server, ad esempio vimonto@web-1, e puoi digitare. Incolla con Cmd+V su macOS o Ctrl+V su Windows e Linux. Il terminale si adatta alle dimensioni della finestra del browser.
Per terminare la sessione, clicca su Scollega, digita exit o chiudi la scheda. Per connetterti di nuovo, clicca su Riconnetti.
Con quale utente accedi?
| Utente | Quando usarlo |
|---|---|
L'utente di sistema (vimonto per impostazione predefinita) |
Il lavoro di tutti i giorni: qui si trovano i tuoi siti, i deploy e i comandi Artisan. Può usare sudo con la password sudo che hai ricevuto alla creazione del server. |
root |
Attività di amministrazione, come installare pacchetti o modificare la configurazione di sistema. |
L'utente è fisso per tutta la sessione. Per cambiarlo, clicca prima su Scollega, poi scegli l'altro utente e connettiti di nuovo.
Come funziona il terminale nel browser?
Un browser non può aprire da solo una connessione SSH, quindi Vimonto Deploy esegue un piccolo bridge del terminale: un servizio separato che si trova tra il tuo browser e il server.
- Quando clicchi su Connetti, l'app verifica il tuo permesso e crea un ticket monouso, valido per 30 secondi. Viene salvato solo un hash del ticket.
- Il tuo browser apre un WebSocket sicuro verso il bridge del terminale e gli consegna il ticket. Il browser non riceve mai la chiave privata né l'indirizzo del server.
- Il bridge riscatta il ticket presso l'app. L'app verifica di nuovo che tu abbia ancora accesso, poi fornisce al bridge ciò che gli serve per connettersi: indirizzo del server, porta SSH, chiave privata e host key nota. Un ticket funziona una sola volta; un secondo utilizzo viene rifiutato.
- Il bridge si connette al server via SSH. Accetta solo la host key che Vimonto Deploy ha salvato alla prima connessione al server. Se il server presenta una chiave diversa, il bridge rifiuta la connessione.
- Tasti digitati e output scorrono tra il tuo browser e il server finché la sessione non termina.
La chiave privata resta nella memoria del bridge solo per la durata della sessione.
Chi può usare il terminale?
Un terminale dà accesso completo al server, quindi ha un permesso a sé, separato dalla gestione dei server. Questi ruoli ce l'hanno:
| Ruolo | Terminale |
|---|---|
| Proprietario | Sì |
| Amministratore | Sì |
| Manager | Sì |
| Sviluppatore | Sì |
| Osservatore | No |
I membri senza questo permesso vedono Nessun terminale per il tuo ruolo e possono chiedere a un amministratore un altro ruolo. Vedi membri e ruoli.
Il permesso viene verificato quando clicchi su Connetti e di nuovo quando il bridge riscatta il ticket, così un membro a cui è appena stato cambiato il ruolo non può usare un ticket che aveva già.
Il terminale si apre solo su un server attivo. Vimonto Deploy deve inoltre conoscere la host key SSH del server, che impara alla prima connessione. Su un VPS personalizzato connesso ma mai usato, esegui prima un'azione, ad esempio apri la pagina Servizi.
Cosa viene registrato?
Vimonto Deploy registra chi ha avuto una shell, con quale utente, quando e per quanto tempo. Non salva mai ciò che digiti né ciò che il server stampa.
- Sessioni recenti in fondo alla pagina Terminale elenca le ultime dieci sessioni con il nome del membro, l'utente di accesso, la durata e l'ora di inizio. Una sessione ancora in corso è contrassegnata con Attivo.
- Quando una sessione termina, una voce come Terminale come root su web-1 viene aggiunta alle attività del server e alla pagina Attività dell'organizzazione, con il modo in cui la sessione è terminata: chiusa nel browser, terminata sul server, chiusa dopo un periodo di inattività o interrotta da un errore.
Limiti di tempo
| Limite | Valore |
|---|---|
| Validità del ticket | 30 secondi, monouso |
| Nessun input | La connessione si chiude dopo 15 minuti senza digitare nulla (valore predefinito; la tua installazione può usarne un altro, mostrato sotto il terminale). |
| Durata massima della sessione | 8 ore |
Quando una sessione si chiude per uno di questi motivi, la riga di stato ne indica il motivo. Clicca su Riconnetti per avviare una nuova sessione.
Risoluzione dei problemi
| Messaggio | Cosa significa |
|---|---|
| Questo ticket è scaduto o è già stato usato. Connettiti di nuovo. | Il browser ha impiegato più di 30 secondi per connettersi, oppure il ticket è stato usato. Clicca su Riconnetti. |
| Non hai (più) accesso a un terminale su questo server. | Il tuo ruolo è cambiato, oppure il server non è più attivo. |
| La host key SSH del server è cambiata; non ci connetteremo. | Il server presenta una host key diversa. Se hai reinstallato il server, usa Dimentica host key nelle impostazioni del server. Altrimenti qualcuno potrebbe intercettare la connessione. |
| Il server rifiuta la nostra chiave. | La chiave del server è stata rimossa da authorized_keys. |
| Il server non è raggiungibile via SSH. | Il server è spento, oppure il firewall o la porta SSH bloccano la connessione. Controlla le impostazioni di rete. |
| Il server del terminale non è raggiungibile. | Il bridge del terminale non è in esecuzione o non è raggiungibile dal tuo browser. |
Domande frequenti
Il terminale nel browser è sicuro?
Sì. Il tuo browser possiede solo un ticket che funziona una volta e scade dopo 30 secondi. La chiave privata del server non raggiunge mai il browser, la connessione viene rifiutata se la host key del server non corrisponde a quella nota e il tuo permesso viene verificato due volte. Le sessioni si chiudono dopo un periodo di inattività.
Posso usare invece il mio client SSH?
Sì. Aggiungi la tua chiave pubblica in Chiavi SSH e usa Accedi con SSH e poi Copia comando SSH nell'intestazione del server, ad esempio ssh vimonto@203.0.113.10.
Vimonto Deploy registra i miei comandi?
No. Tasti digitati e output non vengono mai salvati. Viene registrata solo la sessione in sé: chi, con quale utente, quando e per quanto tempo.
Posso accedere come root?
Sì, scegli root prima di connetterti. Root non ha una password; accede con la chiave del server.