Chiave SSH: come crearla e collegarti al server

Una chiave SSH è una coppia di file sul tuo computer. Incolli la parte pubblica (il file .pub) nella dashboard e il server ti fa entrare senza password. La crei una volta sola e funziona per tutti i server. Se SSH non ti serve, puoi fare a meno della chiave: Jupyter e le app pronte si aprono con un pulsante nella dashboard.

1. Controlla se hai una chiave

Apri un terminale: Terminale su Mac, PowerShell su Windows, un terminale qualsiasi su Linux. Esegui:

Mac e Linux

Windows (PowerShell)

Cosa significa il risultato:

• Nell’elenco c’è id_ed25519.pub: hai già una chiave, passa al punto 3.
• Non c’è id_ed25519.pub, ma c’è id_rsa.pub o id_ecdsa.pub: va bene anche così. Al punto 3 usa quel nome di file al posto di id_ed25519.pub.
• Tanti file con nomi diversi (work.pub, github.pub e così via): sono chiavi per altri servizi, lasciale stare. Ti serve solo id_ed25519.pub o id_rsa.pub, perché il terminale le usa da solo. Se non ci sono, crea una chiave al punto 2: le altre chiavi non verranno toccate.
• “No such file” o “Cannot find path”: non hai ancora chiavi; creane una al punto 2.

2. Crea una chiave (se non ce l’hai)

Lo stesso comando funziona su Mac, Windows e Linux:

Il terminale fa tre domande: premi semplicemente Invio ogni volta. Lascia la posizione predefinita del file; la passphrase è facoltativa.

Se ti chiede “already exists. Overwrite (y/n)?”, rispondi n. Hai già una chiave e non serve sovrascriverla: passa al punto 3.

3. Copia la chiave pubblica

Mac: questo comando copia la chiave direttamente negli appunti:

Windows (PowerShell)

Linux: stampa la chiave e copia tutta la riga:

Una chiave corretta è una sola riga che inizia con ssh-ed25519. Il file senza .pub è la tua chiave privata: non incollarla mai da nessuna parte e non inviarla a nessuno.

4. Incolla la chiave nella dashboard

Dashboard → Impostazioni → Chiave SSH pubblica → incolla la riga → Salva chiave. La chiave viene aggiunta ai server già attivi e a tutti quelli nuovi.

5. Collegati

In I miei server, copia il comando SSH. Ha questo aspetto (ogni server ha la sua porta):

Incollalo nel terminale. Al primo collegamento vedrai Are you sure you want to continue connecting (yes/no)?: scrivi yes e premi Invio. Fatto, sei sul server. Controlla la GPU con nvidia-smi.

Errori comuni

“id_ed25519 already exists. Overwrite (y/n)?”

Hai già una chiave. Rispondi n: non sovrascriverla, altrimenti la vecchia chiave smetterà di funzionare ovunque l’hai aggiunta. Mostra e copia semplicemente quella esistente (punto 3).

“Permission denied (publickey)”

Il server non ha riconosciuto la tua chiave. Nella dashboard (Impostazioni) controlla che la chiave incollata sia la tua chiave pubblica: la stessa riga che stampa cat ~/.ssh/id_ed25519.pub. Se hai più chiavi, indica esplicitamente quella giusta: ssh -i ~/.ssh/id_ed25519 -p … root@vramfarm.com.

“Connection refused” o “Connection closed”

Il server si sta ancora avviando o si è già fermato. Aspetta lo stato Attivo in I miei server e riprova. Se il server è attivo e l’errore dura più di un paio di minuti, scrivi all’assistenza in chat.

“REMOTE HOST IDENTIFICATION HAS CHANGED”

Prima di questo, sulla stessa porta c’era un altro server e il tuo computer se lo ricorda. Elimina la vecchia voce (usa la tua porta): ssh-keygen -R "[vramfarm.com]:31001", poi collegati di nuovo.

“UNPROTECTED PRIVATE KEY FILE” o “bad permissions”

Altri utenti del tuo computer possono leggere la chiave, quindi SSH la rifiuta. Su Mac e Linux: chmod 600 ~/.ssh/id_ed25519.

“ssh non è riconosciuto come comando interno o esterno” (Windows)

Il client OpenSSH non è installato. Apri Impostazioni → App → Funzionalità facoltative → Aggiungi una funzionalità → Client OpenSSH, poi riapri PowerShell.

La dashboard dice “Questa non sembra una chiave SSH pubblica”

Molto probabilmente hai copiato la chiave privata (inizia con -----BEGIN OPENSSH PRIVATE KEY-----). Non inviarla mai a nessuno. Ti serve il file che finisce in .pub: una riga che inizia con ssh-ed25519.

Il terminale chiede una password

I server non hanno password: si accede solo con una chiave. Quindi la chiave non corrisponde: vedi “Permission denied” qui sopra. Se hai impostato una passphrase quando hai creato la chiave, il terminale potrebbe chiedertela: è la password della tua chiave, non del server.

Ancora problemi?

Scrivi nella chat di assistenza in basso a destra e allega uno screenshot del terminale (puoi incollarlo in chat con Ctrl+V). Mentre verifichiamo, puoi lavorare da Jupyter: Apri Jupyter → File → New → Terminal. È lo stesso terminale del server, senza bisogno di chiave.