Guida

Connessione via SSH

Accesso da terminale al Mac noleggiato da Windows, Mac o Linux: chiave SSH, primo accesso, trasferimento di file, tmux e VS Code. Nessun software aggiuntivo.

Ti colleghi al Mac noleggiato con il normale SSH attraverso il nostro gateway gate.bohemiansilicon.com. Non installi nient’altro e non configuri nulla nella rete. La configurazione richiede circa 10 minuti e la prima ora di ogni noleggio è gratuita, così puoi preparare tutto con calma.

Nella nostra email con i dati di accesso ricevi il tuo nome utente, il tuo numero di porta (ha questo aspetto: 2201), l’impronta del Mac e, per il desktop remoto, una password. Dove la guida indica NOMEUTENTE e PORTA, usa i dati di quell’email.

Per SSH ci invii solo la tua chiave SSH pubblica. L’accesso con password è disattivato per SSH; accedi solo con la chiave.

Windows

Windows 10 e 11 includono già il client SSH, non devi installare nient’altro.

1. Crea una chiave SSH

Ti consigliamo una chiave dedicata solo a Bohemian Silicon. I comandi qui sotto la salvano con un nome proprio, così non sovrascrivono una chiave che usi già altrove (ad esempio id_ed25519 per GitHub).

1. Apri PowerShell (fai clic su Start, digita PowerShell e aprilo).
2. Esegui questi comandi. Quando ti viene chiesta una passphrase, inseriscila e confermala (mentre digiti non compare nulla). La passphrase protegge la chiave se qualcuno copia il file. Puoi lasciarla vuota, ma è meno sicuro.

mkdir -Force $HOME\.ssh | Out-Null
ssh-keygen -t ed25519 -f $HOME\.ssh\bohemian_ed25519 -C bohemian-silicon

Il comando crea due file. bohemian_ed25519 è la tua chiave privata: resta sul tuo computer e non la condividi mai. bohemian_ed25519.pub è la chiave pubblica: è quella che ci invii. Puoi mandarla tranquillamente con una normale email, perché da sola non permette di accedere.

Vuoi usare una chiave che hai già? Inviaci il suo file .pub e nei comandi qui sotto usa il suo nome di file al posto di bohemian_ed25519.

3. Mostra la chiave pubblica:

Get-Content $HOME\.ssh\bohemian_ed25519.pub

Copia l’intera riga che inizia con ssh-ed25519.

4. Inviaci la chiave via email. Non inviare mai il file senza .pub: è la tua chiave privata e resta solo sul tuo computer.

Inserirai la passphrase della chiave a ogni connessione.

2. Collegati

ssh -i $HOME\.ssh\bohemian_ed25519 -p PORTA NOMEUTENTE@gate.bohemiansilicon.com

1. La prima volta SSH mostra l’impronta del Mac (ED25519 key fingerprint is SHA256:…) e chiede Are you sure you want to continue connecting?. Confrontala con l’impronta nella nostra email. Digita yes solo se corrispondono esattamente. Altrimenti digita no e scrivici.
2. Hai effettuato l’accesso quando vedi una riga che termina con %. Con exit ti disconnetti.

Mac

1. Crea una chiave SSH

Ti consigliamo una chiave dedicata solo a Bohemian Silicon. I comandi qui sotto la salvano con un nome proprio, così non sovrascrivono una chiave che usi già altrove (ad esempio id_ed25519 per GitHub).

1. Apri il Terminale (Applicazioni → Utility → Terminale).
2. Esegui questi comandi. Quando ti viene chiesta una passphrase, inseriscila e confermala (mentre digiti non compare nulla). La passphrase protegge la chiave se qualcuno copia il file. Puoi lasciarla vuota, ma è meno sicuro.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

Il comando crea due file. bohemian_ed25519 è la tua chiave privata: resta sul tuo computer e non la condividi mai. bohemian_ed25519.pub è la chiave pubblica: è quella che ci invii. Puoi mandarla tranquillamente con una normale email, perché da sola non permette di accedere.

Vuoi usare una chiave che hai già? Inviaci il suo file .pub e nei comandi qui sotto usa il suo nome di file al posto di bohemian_ed25519.

3. Mostra la chiave pubblica:

pbcopy < ~/.ssh/bohemian_ed25519.pub

La chiave è ora negli appunti; incollala con ⌘V.

4. Inviaci la chiave via email. Non inviare mai il file senza .pub: è la tua chiave privata e resta solo sul tuo computer.

Suggerimento: per non digitare la passphrase ogni volta, salvala nel portachiavi di macOS:

ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519

2. Collegati

ssh -i ~/.ssh/bohemian_ed25519 -p PORTA NOMEUTENTE@gate.bohemiansilicon.com

1. La prima volta SSH mostra l’impronta del Mac (ED25519 key fingerprint is SHA256:…) e chiede Are you sure you want to continue connecting?. Confrontala con l’impronta nella nostra email. Digita yes solo se corrispondono esattamente. Altrimenti digita no e scrivici.
2. Hai effettuato l’accesso quando vedi una riga che termina con %. Con exit ti disconnetti.

Linux

1. Crea una chiave SSH

Ti consigliamo una chiave dedicata solo a Bohemian Silicon. I comandi qui sotto la salvano con un nome proprio, così non sovrascrivono una chiave che usi già altrove (ad esempio id_ed25519 per GitHub).

1. Apri un terminale.
2. Esegui questi comandi. Quando ti viene chiesta una passphrase, inseriscila e confermala (mentre digiti non compare nulla). La passphrase protegge la chiave se qualcuno copia il file. Puoi lasciarla vuota, ma è meno sicuro.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

Il comando crea due file. bohemian_ed25519 è la tua chiave privata: resta sul tuo computer e non la condividi mai. bohemian_ed25519.pub è la chiave pubblica: è quella che ci invii. Puoi mandarla tranquillamente con una normale email, perché da sola non permette di accedere.

Vuoi usare una chiave che hai già? Inviaci il suo file .pub e nei comandi qui sotto usa il suo nome di file al posto di bohemian_ed25519.

3. Mostra la chiave pubblica:

cat ~/.ssh/bohemian_ed25519.pub

Copia l’intera riga che inizia con ssh-ed25519.

4. Inviaci la chiave via email. Non inviare mai il file senza .pub: è la tua chiave privata e resta solo sul tuo computer.

Suggerimento: sulla maggior parte dei desktop Linux è già attivo un agente SSH, quindi inserisci la passphrase una sola volta per sessione:

ssh-add ~/.ssh/bohemian_ed25519

2. Collegati

ssh -i ~/.ssh/bohemian_ed25519 -p PORTA NOMEUTENTE@gate.bohemiansilicon.com

1. La prima volta SSH mostra l’impronta del Mac (ED25519 key fingerprint is SHA256:…) e chiede Are you sure you want to continue connecting?. Confrontala con l’impronta nella nostra email. Digita yes solo se corrispondono esattamente. Altrimenti digita no e scrivici.
2. Hai effettuato l’accesso quando vedi una riga che termina con %. Con exit ti disconnetti.

Trasferire file

Esegui scp sul tuo computer, non sul Mac noleggiato.

Windows

scp -i $HOME\.ssh\bohemian_ed25519 -P PORTA dati.zip NOMEUTENTE@gate.bohemiansilicon.com:~/
scp -i $HOME\.ssh\bohemian_ed25519 -P PORTA NOMEUTENTE@gate.bohemiansilicon.com:~/risultati.zip .

Mac, Linux

scp -i ~/.ssh/bohemian_ed25519 -P PORTA dati.zip NOMEUTENTE@gate.bohemiansilicon.com:~/
scp -i ~/.ssh/bohemian_ed25519 -P PORTA NOMEUTENTE@gate.bohemiansilicon.com:~/risultati.zip .

La prima riga carica un file sul Mac noleggiato, la seconda scarica un file nella cartella corrente. Con -r copi un’intera cartella.

Attività lunghe (tmux)

Se chiudi il terminale o la connessione cade, terminano anche i programmi avviati al suo interno. Avvia le attività lunghe, come il download di modelli o l’addestramento, dentro tmux: la sessione continua sul Mac anche quando ti disconnetti. Dopo l’accesso al Mac avvia una sessione:

tmux new -s work

Avvia lì la tua attività. Per lasciarla in esecuzione e disconnetterti, premi Ctrl+B, rilascia entrambi i tasti e poi premi D. Dopo una nuova connessione torni alla sessione così:

tmux attach -t work

tmux ls elenca le tue sessioni; exit dentro una sessione la chiude. Tutte le sessioni terminano al più tardi alla fine del noleggio, quando il tuo account viene eliminato.

Visual Studio Code (Remote-SSH)

1. In VS Code installa l’estensione Remote - SSH di Microsoft.
2. Premi F1, scegli Remote-SSH: Add New SSH Host… e inserisci questo comando (uguale su Windows, Mac e Linux):

ssh -i ~/.ssh/bohemian_ed25519 -p PORTA NOMEUTENTE@gate.bohemiansilicon.com

3. Salvalo nel file di configurazione SSH proposto. Poi premi di nuovo F1, scegli Remote-SSH: Connect to Host… e l’indirizzo del Mac. Se ti viene chiesta la piattaforma, scegli macOS.
4. Alla prima connessione VS Code installa la sua parte server nel tuo account sul Mac; ci vogliono uno o due minuti. Poi puoi aprire cartelle sul Mac e usarne il terminale direttamente in VS Code.

Risoluzione dei problemi

• La connessione va in timeout o viene rifiutata: controlla l’indirizzo gate.bohemiansilicon.com e il numero di porta dopo -p. Alcune reti aziendali o di hotel bloccano le connessioni in uscita verso porte insolite; prova un’altra rete, per esempio l’hotspot del telefono, oppure scrivici.
• Permission denied (publickey) o una richiesta di password: la tua chiave non è stata usata. Collegati dal computer su cui hai creato la chiave, indica -i con il percorso della chiave e controlla il nome utente.
• REMOTE HOST IDENTIFICATION HAS CHANGED: interrompi e non collegarti. Scrivici prima. Ti diremo se il Mac è stato reinstallato e ti invieremo la sua nuova impronta. Solo allora esegui ssh-keygen -R "[gate.bohemiansilicon.com]:PORTA" e ricollegati, verificando la nuova impronta.

Alla fine del noleggio

Alla fine del noleggio eliminiamo il tuo account macOS con la sua cartella Inizio e cancelliamo i tuoi file dalle cartelle temporanee condivise (/tmp, /Users/Shared). Scarica tutto ciò che vuoi conservare prima della fine del noleggio. Dopo puoi eliminare la chiave anche dal tuo computer: i file bohemian_ed25519 e bohemian_ed25519.pub nella cartella .ssh.

Sei bloccato? Scrivi a hello@bohemiansilicon.com e allega uno screenshot o il testo dell’errore. Di solito rispondiamo entro pochi minuti.

← Tutte le guide