Guida operativa — cosa fare, passo dopo passo, per sfruttare al massimo SSHBorg.
Tocca il pulsante + nella schermata degli host per aggiungere un nuovo server.
ubuntu, root, deploy).Alla prima connessione SSHBorg mostra il fingerprint del server e chiede di accettarlo. È un controllo di sicurezza: garantisce che ti stai connettendo alla macchina giusta e non a un impostore. Verifica che il fingerprint corrisponda a quello fornito dall'amministratore del server o ottenuto tramite un canale affidabile prima di accettare.
Una volta accettato, il fingerprint viene salvato localmente. Se cambia in una connessione futura, SSHBorg ti avviserà — potrebbe indicare una reinstallazione del server, una rotazione delle chiavi o un attacco man-in-the-middle.
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pubQuando l'elenco dei server cresce, puoi organizzare gli host in gruppi richiudibili e colorati — ad esempio Produzione, Lab di casa, Clienti.
I colori si scelgono dagli swatch rapidi o liberamente con il selettore a gradiente. Un host può anche avere un colore proprio — si imposta nell'editor dell'host, subito sotto il gruppo — che prevale sul colore del gruppo e funziona anche per gli host senza gruppo.
Gli host senza gruppo restano in cima all'elenco e, se non crei alcun gruppo, l'elenco appare e si comporta esattamente come prima.
Il file manager SFTP ti permette di navigare, caricare, scaricare, rinominare ed eliminare file sul server direttamente dal telefono. Apri una sessione SFTP dalla schermata degli host toccando SFTP.
Tocca una cartella per aprirla. Usa la freccia indietro o tocca qualsiasi segmento della barra del percorso per risalire nell'albero delle directory.
I link simbolici sono mostrati con un piccolo badge a forma di catena. Toccare un link simbolico naviga verso la sua destinazione: se punta a una cartella la si entra, se punta a un file si comporta come un file normale.
Tocca il pulsante di caricamento (↑) per scegliere uno o più file dallo storage del telefono. Il caricamento inizia immediatamente e il progresso viene mostrato in cima alla schermata.
Tocca un file qualsiasi per scaricarlo immediatamente. Per scaricare un'intera cartella, tocca l'icona di download accanto ad essa — SSHBorg scaricherà l'intero albero di directory e lo salverà nella cartella Download del telefono.
Se un file esiste già nella destinazione, un dialogo chiederà se sovrascrivere, saltare il file, oppure annullare l'intero trasferimento.
Tieni premuto un elemento per entrare in modalità selezione, poi tocca altri elementi per aggiungere alla selezione. La barra degli strumenti mostra le azioni disponibili:
L'autenticazione tramite chiave è più sicura delle password e, una volta configurata, non richiede di ricordare o digitare nulla.
Vai in Impostazioni → Chiavi SSH → Genera nuova chiave. SSHBorg supporta:
Dai alla chiave un nome significativo (es. mio-vps o server-lavoro) per riconoscerla in seguito.
Dopo aver generato una chiave, toccala per vedere la chiave pubblica. Copiala e incollala nel file ~/.ssh/authorized_keys del server per l'utente con cui vuoi accedere.
mkdir -p ~/.ssh
chmod 700 ~/.ssh
echo "ssh-ed25519 AAAA...latuachiave..." >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keysPubkeyAuthentication yes in /etc/ssh/sshd_config. È il valore predefinito sulla maggior parte delle distribuzioni, ma alcune immagini hardened lo disabilitano.
SSHBorg offre una passphrase aggiuntiva opzionale per le tue chiavi (Impostazioni → Chiavi SSH → tocca una chiave → Abilita cifratura). Quando attiva, la chiave viene cifrata con una passphrase che SSHBorg non memorizza — ti verrà chiesta ogni volta che la chiave viene utilizzata.
È fortemente consigliata se conservi credenziali sensibili sul telefono, o se non hai un blocco app attivo.
SSHBorg mostra una barra di suggerimenti sopra la tastiera mentre digiti nel terminale. I suggerimenti vengono presi dalla cronologia della shell dell'utente con cui ti sei connesso.
Quando si apre una sessione terminale, SSHBorg legge il file di cronologia della shell dal server remoto. Cerca i seguenti percorsi in ordine:
~/.bash_history — predefinito per le shell Bash~/.zsh_history — predefinito per Zsh (verificato anche come $HISTFILE se impostato)~/.local/share/fish/fish_history — per gli utenti di Fish shellViene utilizzato il primo file esistente e leggibile. Mentre digiti, i comandi vengono filtrati in tempo reale e mostrati come chip nella barra dei suggerimenti. Tocca un chip per inserire il comando.
Nessun suggerimento appare
~/.bashrc:
HISTFILE=~/.bash_history
HISTSIZE=10000
HISTFILESIZE=20000~/.zshrc:
HISTFILE=~/.zsh_history
HISTSIZE=10000
SAVEHIST=10000
setopt APPEND_HISTORY SHARE_HISTORYI suggerimenti appartengono all'utente sbagliato
sudo su - root (o passi a un altro utente con su), la barra dei suggerimenti mostra ancora la cronologia dell'utente di login originale, non di root. Questo perché SSHBorg legge il file di cronologia prima che la shell avvii, usando le credenziali con cui ti sei connesso.
root (se il server lo consente).
Il terminale risponde ad alcune gesture touch oltre alla digitazione:
In Impostazioni → Terminale puoi adattare il terminale alle tue esigenze:
Quando la tastiera virtuale è aperta, sopra di essa appare una riga di pulsanti scorciatoia. Scorri la barra lateralmente per raggiungere tutti i tasti.
Ctrl e Alt sono toggle persistenti — toccane uno, poi tocca un tasto lettera per inviare la combinazione. Si resettano automaticamente dopo il tasto successivo.
L'icona di correzione ortografica alterna la tastiera tra modalità terminale e modalità parole. In modalità terminale (predefinita) autocorrettore e suggerimenti di parole sono disabilitati — ideale per comandi e percorsi di file. In modalità parole la tastiera si comporta come un normale campo di testo, con suggerimenti e autocorrettore attivi. Utile quando si digita testo in linguaggio naturale via SSH, ad esempio con Claude Code o altri strumenti interattivi.
Scorri la barra verso destra per raggiungere i tasti da F1 a F12.
La barra esiste in più layout. Tocca il tasto ⇄ sulla barra per cambiarlo: i tasti lasciano il posto all'elenco delle barre disponibili, ne tocchi una e hai finito — la scelta viene ricordata. Puoi scegliere e gestire le barre anche da Impostazioni → Terminale → Layout barra tasti extra → Personalizza.
/ - | ~ e le frecce nell'ordine della tastiera (← ↑ ↓ →).ESC / - Home ↑ End PgUp sopra Tab Ctrl Alt ← ↓ → PgDn.Per crearne una tua, duplica un preset (menu ⋮ accanto) oppure crea una barra nuova. L'editor mostra la barra esattamente come apparirà: tocca un tasto per selezionarlo, poi usa i pulsanti sotto per spostarlo a sinistra o a destra, in un'altra riga, cambiarlo, aggiungere un tasto dopo di lui o rimuoverlo. Ogni riga può scorrere (i tasti tengono la larghezza naturale) oppure riempire la larghezza dello schermo (fino a circa nove tasti per riga su un telefono). Fino a tre righe; la dimensione dei tasti è regolabile.
Oltre ai tasti soliti, una barra personalizzata può contenere tasti di testo: un testo qualsiasi, inviato così com'è — un singolo |, un prefisso sudo o un comando intero. Usa \n per Invio, \t per Tab e \e per Esc, così ls -la\n diventa una macro a un tocco. Ci sono altri due tasti azione: puntina tiene la barra visibile a tastiera chiusa, tastiera mostra o nasconde la tastiera.
Le barre personalizzate sono incluse nel backup delle impostazioni. Su Android TV funziona tutto col telecomando: tasti e pulsanti dell'editor sono raggiungibili col D-pad.
L'agent forwarding SSH permette di usare le chiavi memorizzate in SSHBorg per autenticare ulteriori connessioni effettuate dall'interno del server remoto — ad esempio per fare git clone di un repo privato, o per saltare su una seconda macchina.
Quando aggiungi o modifichi un host, abilita il toggle Agent forwarding. SSHBorg fungerà da agente SSH per quella sessione.
Il server deve permettere l'agent forwarding. Controlla /etc/ssh/sshd_config:
AllowAgentForwarding yesÈ il valore predefinito sulla maggior parte dei sistemi. Dopo averlo modificato, riavvia il demone SSH:
sudo systemctl restart sshdSe ti connetti a questo server anche da laptop o desktop, puoi configurare il forwarding in modo persistente nel tuo ~/.ssh/config locale:
Host myserver
HostName 203.0.113.42
User ubuntu
ForwardAgent yesAlcuni server più vecchi — apparati di rete, dispositivi embedded o sistemi con versioni obsolete di OpenSSH — supportano solo algoritmi di cifratura che i client SSH moderni non annunciano più di default.
Abilitando il toggle Cifrature Legacy nella configurazione dell'host, SSHBorg aggiunge i seguenti algoritmi alla lista di negoziazione:
aes128-cbc, aes192-cbc, aes256-cbc, 3des-cbcdiffie-hellman-group14-sha1, diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1ssh-dss (DSA 1024-bit)Il server negozia sempre l'algoritmo più forte disponibile su entrambi i lati, quindi abilitare questa opzione non indebolisce le connessioni ai server moderni — gli algoritmi legacy vengono usati solo se il server non può offrire nulla di meglio.
SSH è una connessione TCP attiva tra il telefono e il server. Se la connessione si interrompe — anche solo per un secondo — la sessione e tutto ciò che stava eseguendo va perso.
Le reti mobili sono particolarmente soggette a interruzioni per diversi motivi:
Un multiplexer di terminale esegue una sessione persistente sul server, completamente indipendente dalla connessione SSH. Se la connessione cade, la sessione e tutto ciò che sta eseguendo continua. Quando ti riconnetti, ti riattacchi e trovi tutto esattamente com'era.
È l'abitudine più utile per chi gestisce server dal telefono.
tmux è disponibile sulla maggior parte delle distribuzioni Linux moderne ed è la scelta consigliata.
# Avvia una nuova sessione con nome
tmux new -s work
# Distacca dalla sessione (lasciala in esecuzione)
Ctrl+B, poi D
# Elenca le sessioni in esecuzione
tmux ls
# Riattacca a una sessione
tmux attach -t work
# Riattacca alla sessione più recente
tmux attachscreen è più vecchio ma disponibile su praticamente ogni sistema Unix, incluse le immagini server minimali dove tmux potrebbe non essere installato.
# Avvia una nuova sessione con nome
screen -S work
# Distacca dalla sessione
Ctrl+A, poi D
# Elenca le sessioni in esecuzione
screen -ls
# Riattacca a una sessione
screen -r worktmux attach || tmux new -s maintmux attach || tmux new -s main al tuo ~/.bashrc o ~/.zshrc sul server in modo che una sessione multiplexer si avvii automaticamente ogni volta che accedi tramite SSHBorg.
Un jump host (detto anche bastion host) è un server intermedio attraverso cui devi passare per raggiungere un server di destinazione non direttamente accessibile da internet. SSHBorg supporta nativamente catene di salto singole e multi-hop.
Se devi saltare attraverso più server intermedi (es. internet → bastion → dmz → target), crea una voce per ogni hop e concatenale:
La configurazione equivalente in un ~/.ssh/config su desktop è la seguente:
Host bastion
HostName bastion.example.com
User admin
ForwardAgent yes
Host target
HostName 10.0.1.50
User ubuntu
ProxyJump bastion
ForwardAgent yesCon questa configurazione, ssh target sul laptop salta trasparentemente attraverso il bastion.
SSHBorg permette di tenere aperte più sessioni di terminale SSH e di file manager SFTP contemporaneamente, anche verso server diversi.
tmux o screen lato server se vuoi che sopravvivano anche a una caduta della connessione SSH.
Scegli come proteggere l'app in Impostazioni → Sicurezza → Blocco app: Nessuno (predefinito), Solo biometrico (impronta digitale o riconoscimento facciale), Blocco del dispositivo (il PIN, la sequenza o la password del dispositivo, oltre alla biometria) o un PIN o passphrase in-app. Quando un blocco è attivo, SSHBorg richiede l'autenticazione prima di mostrare qualsiasi host, credenziale o dato di sessione.
Il PIN o passphrase in-app funziona su qualsiasi dispositivo, anche senza hardware biometrico o un blocco schermo di sistema — per questo è la scelta giusta su una Android TV. Per cambiarlo o rimuoverlo viene chiesto prima quello attuale. Non è recuperabile se dimenticato: dovresti cancellare i dati dell'app o reinstallarla, quindi tieni un backup dei tuoi host.
Puoi impostare un timeout di inattività — dopo quel numero di minuti in background l'app si blocca automaticamente.
Per impostazione predefinita SSHBorg blocca screenshot e registrazione dello schermo per evitare che il contenuto sensibile del terminale trapeli tramite la schermata delle app recenti o strumenti di cattura dello schermo.
Se devi fare uno screenshot (es. per condividere un output del terminale), puoi disabilitare temporaneamente la protezione in Impostazioni → Sicurezza → Consenti screenshot.
Tutte le credenziali (password, chiavi private, passphrase) sono memorizzate cifrate usando l'Android Keystore — un enclave sicuro basato su hardware disponibile su Android 10+. Non vengono mai scritte su storage esterno né trasmesse da nessuna parte.
SSHBorg può esportare e importare le configurazioni degli host e le impostazioni dell'app come file JSON. Questo permette di trasferire la lista dei server su un altro dispositivo o di conservare un backup portabile della propria configurazione.
Vai in Impostazioni → Backup → Esporta backup. Scegli dove salvare il file tramite il selettore file di sistema. Il file si chiama sshborg_backup.json per impostazione predefinita.
Vai in Impostazioni → Backup → Importa backup. Seleziona il file .json precedentemente esportato (o creato manualmente). SSHBorg lo unirà alla lista degli host esistenti:
keyLabel esportato, se esiste; altrimenti il campo viene ignorato.Il file esportato è un normale oggetto JSON. È possibile crearlo manualmente per importare in blocco una lista di server da un'altra fonte.
{
"version": 5,
"exported_at": "2026-05-14T10:00:00Z",
"groups": [
{ "name": "Produzione", "color": -1754827 }
],
"hosts": [
{
"label": "Il mio VPS",
"hostname": "203.0.113.42",
"port": 22,
"username": "ubuntu",
"agentForwarding": false,
"jumpMode": "simple",
"jumpHosts": null,
"jumpHostIdList": null,
"portForwardings": null,
"sftpStartMode": "last",
"sftpStartDir": null,
"sftpShowHidden": false,
"allowLegacyCiphers": false,
"keyLabel": "Chiave VPS",
"group": "Produzione"
}
],
"settings": {
"night_mode": 0,
"scrollback_lines": 2000,
"terminal_font_size": 13,
"terminal_color_scheme": 0,
"double_tap_action": 0
}
}L'oggetto settings (facoltativo) contiene le impostazioni dell'app e viene scritto automaticamente all'esportazione; puoi ometterlo se crei il file a mano.
label — nome visualizzato in SSHBorg. Usato come chiave univoca per l'unione in fase di importazione. Obbligatorio.hostname — indirizzo o IP del server (IPv4 o IPv6). Obbligatorio.port — porta SSH. Valore predefinito: 22.username — utente di login. Obbligatorio.agentForwarding — true per abilitare il forwarding dell'agente SSH. Valore predefinito: false.jumpMode — "simple" (usa il testo di jumpHosts) o "host_list" (usa gli ID interni di SSHBorg). Usa "simple" quando crei il file manualmente.jumpHosts — lista di jump host separati da virgola nel formato [utente@]host[:porta]. Usato solo con jumpMode "simple".portForwardings — regole di port forwarding locale separate da newline in sintassi SSH -L, es. "8080:localhost:8080".sftpStartMode — cartella iniziale SFTP: "last" (ricorda l'ultima visitata), "fixed" (usa sempre sftpStartDir), "home" (home del server). Valore predefinito: "last".sftpStartDir — percorso da usare quando sftpStartMode è "fixed".sftpShowHidden — true per mostrare i file nascosti (dotfile, nomi che iniziano con ".") nel browser SFTP di questo host. Predefinito false.allowLegacyCiphers — true per abilitare gli algoritmi legacy descritti sopra. Predefinito: false.keyLabel — nome della chiave SSH usata da questo host. All'importazione, se esiste una chiave con questo nome viene collegata all'host; altrimenti il campo viene ignorato. La chiave stessa non è mai inclusa nel backup.group — nome del gruppo a cui appartiene l'host. I gruppi sono elencati nell'array groups in cima al file, con name e color (ARGB come intero a 32 bit con segno). Se un host fa riferimento a un gruppo assente dall'array, il gruppo viene creato automaticamente con un colore predefinito: scrivendo il file a mano puoi quindi omettere l'array.color — colore opzionale del singolo host (ARGB come intero a 32 bit con segno). Prevale sul colore del gruppo.label, hostname e username sono opzionali. I campi omessi riprendono i valori predefiniti.
SSHBorg funziona su Android TV e Google TV. Si usa con il D-pad del telecomando, ma trattandosi di un'app molto basata sul testo, una tastiera fisica fa una grande differenza.
Per rinominare, eliminare, modificare, duplicare o scaricare da una riga, apri il suo menu: premi il tasto Menu (opzioni) del telecomando sulla riga con il focus, oppure tieni premuto OK (pressione lunga). OK da solo esegue l'azione primaria, non il menu.
Una tastiera fisica — USB o Bluetooth (Android TV supporta entrambe) è fortemente consigliata, e di fatto necessaria per il terminale. Con una tastiera i campi di testo e la shell funzionano normalmente.
Senza, la tastiera a schermo gestisce comunque inserimenti brevi: metti il focus su un campo, premi OK per aprirlo, digita e premi OK / Vai sulla tastiera per confermare — nel prompt della password questo connette direttamente. Inserire comandi shell con la tastiera a schermo, però, è poco pratico.
Una TV di solito non ha lettore di impronte né blocco schermo, quindi proteggi l'app con il blocco integrato con PIN o passphrase (Impostazioni → Sicurezza) — funziona interamente col telecomando o una tastiera. Vedi Sicurezza dell'app.