Connettersi tramite SSH
Usa Octoboard su un server Linux o su un altro computer da questo computer, nell’app desktop o in un browser, tramite SSH: una connessione cifrata diretta a quella macchina, senza relay né servizi cloud.
Non sai se è la strada giusta per te? Scegli come connetterti la confronta con i modi solo browser che non richiedono SSH.
App desktop su questo computer · Browser tramite un inoltro SSH ⟷ SSH ⟷ Server Linux o altro computer
Sei alle prime armi?
- Host: la macchina su cui gira Octoboard e che vuoi raggiungere, un server Linux o un altro Mac o PC Windows.
- Server: qui, una macchina Linux a cui accedi in rete, di solito una che noleggi, senza schermo proprio.
- SSH: un modo standard e cifrato per accedere a un’altra macchina e digitarvi comandi. È integrato in macOS, Windows e Linux.
- Terminale: la finestra in cui digiti i comandi: Terminale su macOS, PowerShell su Windows.
- Inoltro SSH: un comando SSH che fa comparire qualcosa dell’host sul tuo computer, così il browser può aprirlo lì.
- Impronta (chiave host): un breve codice che identifica l’SSH di una macchina. Controllarla una volta ti conferma di aver raggiunto la macchina giusta.
- File della chiave: un file che ti fa accedere al posto di una password. Alcuni provider di server te ne danno uno.
Che cosa serve
Sezione intitolata “Che cosa serve”-
Un modo per accedere all’host con SSH. Per un server Linux, il provider ti dà l’indirizzo e il tuo nome utente. Per verificare che funzioni, apri Terminale (macOS) o PowerShell (Windows) ed esegui il comando qui sotto con il tuo nome utente e l’indirizzo del server. La prima volta, rispondi
yesquando ti chiede se considerare attendibile il server.Terminal window ssh <you>@<server>Per un Mac o un PC Windows come host, attivi l’accesso SSH nelle impostazioni di sistema; Usa un altro computer come host mostra come.
-
Per un server Linux, Octoboard installato e avviato su di esso. Installazione › Server Linux mostra come. Il programma server di Octoboard, octoboardd, è ciò che l’app chiama il servizio.
-
L’app Octoboard su questo computer, per macOS o Windows, a meno che userai solo un browser.
Connettiti a un server Linux
Sezione intitolata “Connettiti a un server Linux”-
Accedi al server via SSH come l’utente che esegue Octoboard, esegui questo comando e copia la riga che inizia con
octoboard+ssh://: i dati di connessione, che dicono all’app dove e come collegarsi.Terminal window octoboardd connectionSe questo computer raggiunge il server a un indirizzo o a una porta SSH diversi, aggiungi
--hosto--ssh-portal comando per stampare i dati di connessione corretti.Anche il codice QR che stampa contiene la stessa riga. Per ora nessuna app lo legge.
-
Nell’app Octoboard su questo computer, apri Dispositivi remoti dalla barra a sinistra oppure, su macOS, scegli Remoto › Dispositivi remoti dalla barra dei menu. Su Windows puoi anche scegliere Dispositivi remoti dal menu di sistema della finestra o dalla jump list dell’icona sulla barra delle applicazioni.
-
Seleziona Aggiungi servizio remoto, poi Incolla sotto Dati di connessione per compilare i campi.
-
Sotto Autenticazione, scegli Password se accedi con la password del tuo account. Scegli File della chiave se il provider del server ti ha dato invece un file della chiave (spesso con un nome come
id_ed25519o che termina con.pem), e indica dove si trova su questo computer. -
Seleziona Salva, poi Connetti. Se te la chiede, inserisci la password.
Se hai incollato i dati di connessione, l’identità del server (la sua impronta) è arrivata insieme e l’app la controlla per te. Se hai digitato l’indirizzo a mano, l’app mostra un’impronta la prima volta. Per assicurarti di aver raggiunto la macchina giusta, confrontala con quella che questo comando stampa sul server e collegati solo se coincidono:
Terminal window ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
Saprai che ha funzionato quando si apre una finestra Octoboard separata, che mostra i progetti e le sessioni del server.
Usa un altro computer come host
Sezione intitolata “Usa un altro computer come host”Puoi raggiungere anche un Mac o un PC Windows su cui gira l’app Octoboard.
- Sul computer che vuoi raggiungere, apri Impostazioni › Accesso remoto in Octoboard.
- Lì seleziona Apri Impostazioni di Sistema (macOS) o Apri Impostazioni (Windows) e attiva Login remoto (macOS) o OpenSSH Server (Windows), seguendo il percorso indicato nella riga, così questo computer accetta gli accessi SSH. Serve un amministratore. Tornando in Octoboard, la riga mostra poi Attivo.
- Attiva Consenti accesso remoto, seleziona Consenti per confermare e tieni Octoboard in esecuzione: se lo chiudi, l’accesso remoto si interrompe.
- Nella scheda App Octoboard, seleziona Copia dati di connessione e inviali all’altro computer, per esempio per email o in chat.
- Sul computer da cui lavorerai, aggiungi l’host come nei passaggi da 2 a 5 di Connettiti a un server Linux, incollando i dati che hai inviato. Accedi con il tuo nome utente e la tua password sull’host.
Saprai che ha funzionato quando si apre una finestra separata con i progetti e le sessioni dell’host.
Da un browser
Sezione intitolata “Da un browser”-
Ottieni il comando di inoltro SSH:
-
Su un host Mac o Windows, esegui prima i passaggi da 1 a 3 di Usa un altro computer come host. Poi, nella scheda Browser, guarda Passaggio 1: inoltro SSH. Fai clic sull’indirizzo nel comando per scegliere come l’altro computer raggiunge questo (oppure scegli Inserisci l’indirizzo manualmente e sostituisci
<server>più tardi), poi seleziona Copia comando di inoltro. Seleziona anche Copia indirizzo sotto Passaggio 2: indirizzo del browser. -
Su un server Linux, esegui questo sul server. Stampa l’indirizzo del browser, poi il comando SSH da eseguire.
Terminal window octoboardd addressSostituisci
<server>nel comando con l’indirizzo del server.
-
-
Sul computer da cui navigherai, esegui il comando SSH in Terminale (macOS) o PowerShell (Windows). La finestra potrebbe chiederti la password, poi non mostra altro: è normale. Lasciala aperta mentre lavori: chiuderla scollega il browser.
-
Apri nel browser l’indirizzo del browser, che inizia con
http://127.0.0.1:.
Saprai che ha funzionato quando Octoboard si apre nella scheda del browser senza chiederti di accedere.
Solo chi può raggiungere Octoboard tramite l’inoltro SSH può usare questo indirizzo. Tienilo privato: la sua chiave dà il controllo completo, resta nella cronologia e nei segnalibri del browser e si sincronizza con gli altri tuoi dispositivi se la sincronizzazione del browser è attiva.
Se non funziona
Sezione intitolata “Se non funziona”- “Impossibile raggiungere il server”, oppure il comando SSH dice “Connection refused” o va in timeout: l’accesso SSH è disattivato sull’host, oppure l’indirizzo o la porta SSH sono sbagliati. Controlla che Login remoto oppure OpenSSH Server sia attivo e che riesca ad accedere con il comando
sshqui sopra. - “Accesso non riuscito”, oppure “Permission denied”: il nome utente, la password o il file della chiave non sono corretti.
- “La chiave host non corrisponde”: la macchina che risponde non è quella a cui ti eri collegato prima. Succede dopo la reinstallazione di un server, ma può anche significare che qualcosa non va. Non proseguire finché non sai perché.
- La pagina del browser non si carica: la finestra SSH è stata chiusa o il suo comando si è fermato. Eseguilo di nuovo e ricarica la pagina.
Sicurezza
Sezione intitolata “Sicurezza”- Nessuna porta pubblica in più: Octoboard accetta solo connessioni dall’host stesso, quindi per collegarti da un altro computer devi prima accedere all’host via SSH. Per questo serve SSH, oppure uno dei relay.
- Controlla quale macchina raggiungi: l’app ricorda la chiave host, l’identità SSH della macchina, alla prima connessione riuscita e blocca la connessione con un avviso se quell’identità cambia in seguito.
- Nessuna password salvata: dopo il tuo primo accesso con una password o con il tuo file della chiave, l’app configura una chiave SSH separata che questo computer userà per gli accessi futuri.
- Revocare l’accesso a un computer: rimuovi la voce di quel computer dall’elenco delle chiavi SSH autorizzate dell’host (
~/.ssh/authorized_keyssu Linux e macOS). Quella chiave non potrà più accedere; una connessione già aperta resta fino alla sua fine.
In una finestra remota
Sezione intitolata “In una finestra remota”- Una finestra per ogni destinazione SSH: le connessioni con un nome utente, un host o una porta SSH diversi aprono ciascuna la propria finestra, così progetti, sessioni e notifiche non si mescolano mai.
- Vedi lo stato di ogni connessione: apri l’icona nella barra dei menu dell’app su macOS o l’icona nell’area di notifica su Windows per vedere una scheda per ogni connessione.
- Apri qui i siti web remoti: quando un agente avvia un sito web sull’host, fai clic sul link
localhostche ti dà e l’app apre quel sito su questo computer tramite SSH. - Apri qui i file remoti: visualizza un file nella finestra remota o scarica una copia da aprire con l’app predefinita di questo computer per quel file.
- Riconnessione automatica: se la rete cade, la finestra continua a provare a riconnettersi finché non ci riesce o la chiudi.