Passa al contenuto principale

Collegarsi in SSH

Il Suo VPS Pro si apre con la Sua chiave SSH: una coppia di file creata sul Suo computer, di cui registra la parte pubblica nella Sua area clienti. La parte privata resta sul Suo computer e non si trasmette a nessuno, nemmeno al nostro team.

Creare la Sua chiave​

Su macOS, Linux e Windows 10 o 11 (PowerShell o il Terminale), un solo comando:

ssh-keygen -t ed25519

Accetti la posizione proposta, e scelga una passphrase per proteggere la chiave. Nella cartella .ssh del Suo account compaiono due file:

  • id_ed25519: la Sua chiave privata, che resta presso di Lei;
  • id_ed25519.pub: la Sua chiave pubblica, quella che registra. Sta su una sola riga, che inizia con ssh-ed25519.

Per mostrare la chiave pubblica e copiarla:

cat ~/.ssh/id_ed25519.pub

Registrare la Sua chiave nell'area clienti​

  1. Apra my.simafri.com, sezione VPS.
  2. Nella scheda del Suo server, incolli la Sua chiave pubblica in Le Sue chiavi pubbliche, una per riga.
  3. Faccia clic su Salva le chiavi.

La Sua chiave viene installata sul server entro un minuto, e la scheda lo indica: Installate sul server il seguito dalla data, con l'impronta di ogni chiave (SHA256:..., la stessa che mostra ssh-keygen -lf ~/.ssh/id_ed25519.pub). Se la registra durante la preparazione del server, la chiave viene installata alla sua creazione.

Utile sapere:

  • fino a 10 chiavi per server, una per persona o per computer;
  • tipi accettati: ed25519, RSA di almeno 2048 bit, ECDSA, e le chiavi di sicurezza hardware (sk-ssh-ed25519, sk-ecdsa); è accettato anche il formato PuTTYgen;
  • ogni salvataggio sostituisce l'insieme delle chiavi registrate: incolli tutte quelle da mantenere;
  • il proprietario dell'account e i gestori registrano le chiavi; un operatore le consulta (veda Membri e ruoli).

Le chiavi registrate dall'area clienti occupano un blocco a sé del file /root/.ssh/authorized_keys, tra due righe di riferimento my.simafri.com. Il resto del file Le appartiene: una chiave che vi aggiunge Lei stesso, fuori da questo blocco, resta al suo posto.

Collegarsi​

La scheda del Suo server mostra il comando Connessione SSH, pronto da copiare:

ssh -p 22101 root@203.0.113.10

La porta, tra 22100 e 22999, è propria del Suo server: riprenda quella della Sua scheda. Anche il nome del Suo server funziona al posto dell'indirizzo:

ssh -p 22101 root@app.mia-azienda.it

Per un server il cui nome è sotto il Suo dominio, questo nome risponde non appena il Suo record DNS designa il Suo server (veda Mettere online un sito o un'applicazione).

In IPv6​

Se la Sua connessione Internet dispone dell'IPv6, raggiunge il Suo server anche direttamente tramite il suo indirizzo IPv6, mostrato nella scheda, sulla porta SSH abituale:

ssh root@2001:db8::101

Una scorciatoia: il file ~/.ssh/config​

Per non dover più digitare la porta e l'indirizzo, aggiunga un blocco al Suo file ~/.ssh/config:

Host miovps
    HostName app.mia-azienda.it
    Port 22101
    User root
    IdentityFile ~/.ssh/id_ed25519

A quel punto basta ssh miovps, e la stessa scorciatoia serve a scp, rsync, git e al Suo editor.

Da Windows​

Windows 10 e 11 includono il client OpenSSH: apra PowerShell o il Terminale e incolli il comando della Sua scheda. Il Suo file di scorciatoie si trova in C:\Users\<il Suo nome>\.ssh\config.

Con PuTTY, inserisca l'indirizzo e la porta della Sua scheda in Session, l'utente root in Connection > Data, e la Sua chiave privata in formato .ppk in Connection > SSH > Auth > Credentials. La chiave pubblica mostrata da PuTTYgen si registra così com'è nella Sua area clienti.

Trasferire file​

Con la stessa porta e la stessa chiave:

# un file, verso il server
scp -P 22101 archive.tar.gz root@app.mia-azienda.it:/srv/

# una cartella, sincronizzata
rsync -avz -e "ssh -p 22101" ./build/ root@app.mia-azienda.it:/var/www/app/

scp prende la porta con una P maiuscola. I programmi SFTP come FileZilla o WinSCP si collegano in SFTP, con l'indirizzo, la porta e la chiave privata del Suo computer.

Lavorare dal Suo editor​

L'estensione Remote - SSH di Visual Studio Code apre le cartelle del Suo server come se fossero sul Suo computer: legge il Suo file ~/.ssh/config, basta scegliere miovps. Gli editor JetBrains offrono la stessa connessione tramite Remote Development.

Dare accesso a un collega​

Due modi di procedere, secondo ciò che vuole affidargli:

  • un accesso da amministratore: aggiunga la sua chiave pubblica accanto alla Sua in Le Sue chiavi pubbliche, una per riga, poi Salva le chiavi;
  • un accesso limitato: gli crei un account sul server, con la sua chiave:
adduser camille
mkdir -p /home/camille/.ssh
nano /home/camille/.ssh/authorized_keys   # incolli la sua chiave pubblica
chown -R camille:camille /home/camille/.ssh
chmod 700 /home/camille/.ssh && chmod 600 /home/camille/.ssh/authorized_keys

Per revocare un accesso, salvi l'elenco delle chiavi senza la sua, oppure elimini il suo account con deluser camille.

Sostituire una chiave persa​

Ha cambiato computer o la Sua chiave privata è scomparsa: crei una nuova chiave con ssh-keygen -t ed25519, poi registri la nuova chiave pubblica nella Sua scheda, togliendo quella vecchia. Viene installata entro un minuto, e Lei ritrova l'accesso al Suo server.

Il Suo assistente IA​

Un assistente IA collegato alla Sua area clienti Simafri (server MCP https://mcp.simafri.com/v1/mcp) legge i Suoi server, il loro stato, i loro indirizzi e il loro comando di connessione, e registra le Sue chiavi pubbliche per Lei, con i diritti della persona connessa. Una chiave privata viene rifiutata, come nell'area clienti.

Domande frequenti​

«Permission denied (publickey)»: che cosa verificare?​

  1. La scheda del Suo server indica Installate sul server il seguito da una data.
  2. L'impronta mostrata nella scheda è quella della Sua chiave: ssh-keygen -lf ~/.ssh/id_ed25519.pub.
  3. Il Suo comando indica proprio la porta della Sua scheda, e l'utente root.
  4. Se la Sua chiave ha un altro nome, la indichi: ssh -i ~/.ssh/mia_chiave -p 22101 root@....

Descriva poi la situazione al supporto, con il comando eseguito e il messaggio ottenuto: l'Assistenza integrale La aiuta a ripristinare l'accesso.

La mia connessione si interrompe quando resto inattivo.​

Aggiunga ServerAliveInterval 60 al Suo blocco in ~/.ssh/config: il Suo computer mantiene viva la connessione. Esegua un comando lungo in tmux o screen, che lo mantengono attivo anche dopo la disconnessione.

L'area clienti indica «Questo testo contiene una chiave PRIVATA».​

Ha incollato il file senza .pub. Incolli il contenuto del file che termina con .pub. Se la Sua chiave privata è stata inviata per errore a qualcuno, ne crei una nuova e registri la sua chiave pubblica.

Posso collegarmi con una password?​

Il Suo server si apre con la chiave SSH, il metodo più sicuro: una chiave non si indovina e non circola mai. Registri una chiave per persona, e ognuna mantiene il proprio accesso.