Guida a Shellvana

Valida per la versione 1.0.0. Ultimo aggiornamento 2026-10-05.

Shellvana è un client SSH per telefoni. Si collega ai tuoi server con SSH standard e mostra l'output come testo leggibile. Questa pagina copre la configurazione e l'uso di tutti i giorni.

Cosa serve

• Un telefono. Un iPhone con iOS 15 o successivo, oppure un telefono Android.
• Un host con sshd standard. Va bene qualsiasi macchina Linux, BSD o macOS che già raggiungi con ssh. Sul server non c'è niente da installare: nessun agente, nessun daemon, nessun plugin.
• Un percorso di rete verso quell'host. Shellvana si collega direttamente dal tuo telefono all'indirizzo che inserisci. Se l'host è raggiungibile solo dalla rete di casa, collegati prima con la tua VPN (WireGuard, Tailscale o simili). Shellvana non ha nessun relay né servizio cloud in mezzo.

Installazione

Scarica Shellvana dall'App Store o da Google Play. L'app è gratuita. Non c'è nessun account da creare e nessun accesso da fare.

Aggiungere un host

• Nell'elenco degli host tocca + per aprire Add host (aggiungi host).
• Compila Name (un'etichetta a piacere), Host (un indirizzo o un hostname), Port (di solito 22) e User.
• Sotto Auth scegli Password o una delle tue chiavi SSH. Se non hai ancora chiavi, l'elenco offre solo Password. Vedi Chiavi SSH.
• Sotto Grid (griglia) scegli la dimensione del terminale che Shellvana chiede al server. Console è 132 colonne per 40 righe e va bene per il normale lavoro in shell. AI agent è 60 colonne per 40 righe e va bene per gli assistenti da terminale a schermo intero che disegnano una barra laterale. Con Custom imposti tu Cols e Rows.
• Tocca Save, poi tocca l'host per connetterti.

Prima connessione e chiavi host

La prima volta che ti connetti, Shellvana mostra l'algoritmo della chiave host del server e il suo fingerprint e chiede Trust this host? (vuoi fidarti di questo host?). Confronta il fingerprint con quello sul server, per esempio con ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub, poi tocca Trust.

Shellvana ricorda quella chiave. Se il server presenta una chiave diversa, vedi un avviso HOST KEY CHANGED con il fingerprint precedente e quello nuovo, e la sessione non si apre a meno che tu non scriva il nome dell'host per accettare la nuova chiave. Se non hai reinstallato il server né rigenerato le sue chiavi, non accettarla.

Gli algoritmi di chiave host deboli o obsoleti vengono rifiutati. Se vedi "Host key algorithm ... is not allowed", abilita sul server una chiave host moderna come Ed25519.

Leggere una sessione

• Vista di lettura. Ogni sessione si apre nella vista di lettura. Prosa e Markdown si riadattano in caratteri proporzionali dimensionati per un telefono. Tabelle, diff, output ad albero e tutto ciò che è allineato in colonne restano a spaziatura fissa con la spaziatura esatta.
• Vista terminale. Tocca l'icona del terminale nella barra in alto per vedere la griglia esatta inviata dal server. Tocca l'icona di lettura per tornare indietro. Entrambe le viste mostrano la stessa sessione, quindi cambiare non fa perdere nulla.
• Font e dimensione di lettura. Tocca l'icona Reading font (font di lettura) nella barra in alto per cambiare il carattere e la dimensione del testo.
• Programmi a schermo intero. Programmi come vim, htop e tmux funzionano normalmente. Quando uno occupa lo schermo, Shellvana ti avvisa che il suo layout richiede la griglia e propone un pulsante Grid.
• Link. Un link nell'output si apre solo dopo che hai confermato dove porta, e si apre nel tuo browser, fuori dall'app.

Scrivere comandi

• Scrivi nel campo in basso (Type a command) e tocca il pulsante di invio.
• La riga dei tasti sopra il campo invia i tasti che mancano alla tastiera di un telefono, come Ctrl-C, Tab, Esc, le frecce, Ctrl-D e Ctrl-Z.
• Quando l'output sembra la richiesta di una password, Shellvana propone Secure input (inserimento sicuro). Il testo inserito in quel modo viene inviato al server ma non viene salvato e non finisce nella trascrizione.

Chiavi SSH

Apri il menu (tre puntini) nell'elenco degli host e scegli SSH keys.

• Importare una chiave. Tocca Import, incolla una chiave privata OpenSSH e inserisci la sua passphrase, se ce l'ha. La chiave viene salvata cifrata sul dispositivo.
• Generare una chiave hardware (Pro). Generate secure key crea una chiave dentro l'hardware sicuro del telefono: il Secure Enclave su iPhone, oppure StrongBox o il keystore supportato dall'hardware su Android. La metà privata non può uscire dal dispositivo. Queste chiavi sono ECDSA P-256, che sul server compaiono come ecdsa-sha2-nistp256.
• Installare la metà pubblica sul server. Apri il menu della chiave, scegli Copy public key (copia la chiave pubblica) e aggiungi quella riga a ~/.ssh/authorized_keys del tuo utente sul server. La prima volta, per farlo, connettiti con una password.
• Usare la chiave. Modifica l'host e sotto Auth scegli la chiave al posto di Password.

Tenere in vita il lavoro dopo una disconnessione

Un telefono perde le connessioni: lo schermo si blocca, la rete cambia, l'app va in background. Quando Shellvana si riconnette, il server ti dà una shell nuova. Tutto ciò che girava nella vecchia shell è perso, a meno che non fosse in esecuzione sotto un multiplexer di terminale.

Per qualsiasi cosa di lunga durata, avviala dentro tmux o screen sul server. Per esempio, dopo esserti connesso esegui tmux new -A -s main. Se la connessione cade, riconnettiti ed esegui lo stesso comando per riprendere da dove eri rimasto.

Impostazioni di sicurezza per host

• Require unlock to connect. Disattivato per impostazione predefinita. Quando lo attivi per un host, Shellvana chiede la tua impronta digitale, il volto o il blocco schermo prima di aprire una sessione su quell'host.
• Block screenshots. Attivo per impostazione predefinita. Gli screenshot e l'anteprima di una sessione nel selettore delle app sono bloccati. Puoi disattivarlo host per host.
• Connect (incognito) (Pro). Nel menu di un host, apre una sessione che non scrive alcuna trascrizione.

Cronologia e dati

• Le trascrizioni delle sessioni sono salvate solo sul telefono, cifrate con SQLCipher. Le trascrizioni più vecchie di 30 giorni si eliminano da sole.
• Per rimuovere le trascrizioni salvate di un host, apri il menu di quell'host e scegli Clear this host's history (cancella la cronologia di questo host). Per rimuovere tutto, apri il menu principale e scegli Clear all history.
• Eliminare un host lo toglie dall'elenco ma mantiene le sue trascrizioni salvate e la sua chiave host attendibile. Se vuoi eliminare anche quelle, cancella prima la cronologia.
• Shellvana non ha account, né analisi, né segnalazione degli arresti anomali. L'informativa sulla privacy elenca ogni connessione di rete che l'app fa.

Free e Pro

• Free. Una sessione attiva, autenticazione con password e con chiave, profili host e il rendering leggibile completo. La leggibilità non è la parte a pagamento.
• Pro. Un solo acquisto una tantum, non un abbonamento. Aggiunge fino a quattro sessioni contemporanee, autenticazione con chiave supportata dall'hardware, tutti i font di lettura e le sessioni in incognito.
• Acquistare o ripristinare. Apri il menu nell'elenco degli host e scegli Shellvana Pro. Su un telefono nuovo tocca Restore purchase (ripristina acquisto) in quella schermata.

Risoluzione dei problemi

• La connessione va in timeout. Controlla che il telefono riesca a raggiungere l'host. Se l'host è su una rete privata, attiva prima la tua VPN e verifica che la porta coincida con quella su cui è in ascolto sshd.
• La chiave viene rifiutata. Controlla che la chiave pubblica copiata con Copy public key sia su una sola riga in ~/.ssh/authorized_keys dello stesso utente indicato nel profilo host, e che il server accetti quel tipo di chiave.
• Il layout di un programma sembra sbagliato nella vista di lettura. Passa alla vista terminale. I programmi a schermo intero sono disegnati per una griglia, e la griglia è sempre l'output esatto.
• Un assistente a schermo intero risulta tagliato. Modifica l'host, cambia Grid in AI agent e riconnettiti.
• "No previous purchase found." Controlla che il telefono sia connesso allo stesso account App Store o Google Play con cui hai acquistato Pro, poi riprova con Restore purchase.

Aiuto

Scrivi a [email protected] indicando il modello del dispositivo e la versione di iOS o Android, oppure vai alla pagina di assistenza.