Guida utente

Benvenuto in Pockterm

Che cos'è Pockterm e come è organizzato

Pockterm è un client SSH completo per iPhone. Puoi connetterti a server, usare un terminale interattivo, trasferire file via SFTP e creare tunnel di inoltro porte.

Usa le schede in basso per spostarti tra Host, Snippet, Portachiavi e Inoltro porte.

Tutto resta sul tuo dispositivo — vedi I tuoi dati e la privacy per i dettagli.

Aggiungere un host

Crea un server a cui connetterti

Creare un host

• Nella scheda Host, tocca +, poi Nuovo host.
• Inserisci un'Etichetta, l'Indirizzo (hostname o IP) e la Porta (22 per impostazione predefinita).
• Scegli le Credenziali così Pockterm sa come autenticarsi. Se non ne hai ancora, tocca Nuove credenziali.
• Tocca Salva.

Azioni host

• Tocca un host per connetterti.
• Scorri a sinistra per Modifica, Preferito o Elimina.
• Scorri a destra e tocca File per sfogliarlo via SFTP.

Credenziali e chiavi SSH

Come Pockterm ti autentica

Le Credenziali sono un nome utente più un modo per autenticarsi: una password oppure una chiave SSH.

Generare una chiave

• Nella scheda Portachiavi, tocca +, scegli Genera chiave Ed25519… e assegna un'etichetta alla chiave.
• Pockterm crea una coppia di chiavi Ed25519 e conserva la chiave privata nel Portachiavi iOS.
• Aggiungi la riga di chiave pubblica mostrata al file ~/.ssh/authorized_keys del server.

Importare una chiave che hai già

• Nella scheda Portachiavi, tocca + e scegli Importa chiave esistente…
• Incolla l'intero file della chiave privata, comprese le righe BEGIN e END. Sono supportate chiavi Ed25519 e RSA in formato OpenSSH.
• Oppure tocca Scegli file… per selezionare la chiave da File.
• Se la chiave ha una passphrase, Pockterm la chiede una volta e la conserva nel Portachiavi insieme alla chiave.

Una chiave che inizia con -----BEGIN RSA PRIVATE KEY----- è nel vecchio formato PEM. Convertila con ssh-keygen -p -f <file> — riscrive il file senza modificare la chiave — poi importala.

Creare credenziali

• Nell'editor di un host, scegli Nuove credenziali.
• Inserisci il nome utente e scegli Password o Chiave.
• Per Chiave, seleziona una delle tue chiavi.

Il terminale

Connettersi e lavorare in una sessione

Tocca un host per aprire una sessione di terminale.

• La barra sopra la tastiera contiene esc, ctrl, tab, i tasti freccia e altro.
• Apri più host contemporaneamente — ogni sessione è una scheda in alto. Tocca il suo nome per passare a essa, o la ✕ rossa per chiuderla.
• Tocca il pulsante snippet per eseguire un comando salvato nella sessione.

Snippet

Salva ed esegui comandi riutilizzabili

Gli snippet sono comandi che usi spesso.

• Nella scheda Snippet, tocca + per salvare un comando con un'etichetta.
• Mentre sei connesso, tocca il pulsante snippet nel terminale per eseguirne uno.
• Assegna a un host uno Snippet di avvio per eseguirlo automaticamente alla connessione.

Gruppi, preferiti e ricerca

Mantieni ordinato un elenco di host lungo

• Dal menu Host, scegli Gestisci gruppi. I gruppi possono essere annidati e le credenziali e la porta predefinite di un gruppo vengono ereditate dai suoi host.
• Assegna un host a un gruppo nell'editor dell'host.
• Segna un host come Preferito (scorri a sinistra) per fissarlo nella sezione Preferiti.
• Trascina verso il basso per cercare per etichetta o indirizzo. Gli host usati di recente compaiono sotto Recenti.

Importare da ssh_config

Importa host esistenti

• Dal menu Host, scegli Importa da ssh_config.
• Incolla il testo della tua configurazione, oppure tocca Scegli file.
• Controlla gli host rilevati, disattiva quelli che non vuoi, poi tocca Importa.

Pockterm legge le impostazioni Host, HostName, User e Port. Per ogni nome utente vengono create credenziali con password, così puoi inserire il segreto in un secondo momento.

Trasferire file (SFTP)

Sfoglia, scarica e carica file

Ogni host ha un browser di file SFTP. SFTP viaggia sulla stessa connessione SSH, quindi non c'è nulla da configurare in più.

Apri il browser

• Tieni premuto un host e scegli Sfoglia file.
• Oppure imposta il Protocollo dell'host su SFTP (File): toccandolo si apre il browser invece del terminale.
• Sei già in una sessione? Tocca il pulsante cartella nella barra superiore del terminale.

Scaricare un file

• Tieni premuto il file, poi scegli Scarica.
• Si apre nel pannello di condivisione, così puoi inviarlo ovunque — scegli Salva su File per conservarlo, anche in iCloud Drive.

Caricare un file

• Tocca +, poi Carica file.
• Si apre il selettore di file dell'iPhone, così puoi caricare direttamente da iCloud Drive, Su questo iPhone o qualsiasi altra posizione di File.
• Il file finisce nella cartella che stai visualizzando.

Gestisci i file

• Tieni premuto un file per rinominarlo, cambiarne i Permessi o eliminarlo.
• Tocca + per creare una cartella. Trascina verso il basso per aggiornare l'elenco.
• Tocca .. in alto per salire di una directory.

I trasferimenti avvengono in blocchi, così nemmeno un file di grandi dimensioni esaurisce la memoria. Durante un trasferimento, la barra del percorso mostra quanto è stato trasferito e la dimensione totale.

Inoltro porte

Incanala le connessioni tramite SSH

L'inoltro delle porte instrada le connessioni di rete attraverso un server SSH.

• Local — una porta sul tuo dispositivo inoltra a un host raggiungibile dal server.
• Remoto — una porta sul server inoltra verso il tuo dispositivo.
• Dinamico — un proxy SOCKS5 sul tuo dispositivo invia ogni connessione attraverso il server.

Eseguire un inoltro

• Nella scheda Inoltro porte, tocca + per aggiungerne uno.
• Tocca una riga per modificarla.
• Tocca ▶ per avviare; lo stato indica quando è attivo. Tocca ⏹ per fermarlo.

Verificare le chiavi host

Fidarsi dei server in sicurezza

La prima volta che ti connetti a un server, Pockterm mostra il fingerprint della sua chiave e ti chiede di accettarlo. Questo si chiama trust on first use.

• Accetta solo se il fingerprint corrisponde a quello che ti aspetti dal proprietario del server.
• Una volta accettata, la chiave viene memorizzata e non ti verrà più chiesto.
• Se in seguito un server presenta una chiave diversa, Pockterm ti avvisa prima di continuare: può significare che il server è stato ricostruito, oppure che qualcosa non va.

I tuoi dati e la privacy

Dove viene conservato tutto

Pockterm non richiede alcun account e i dati delle tue connessioni restano sul tuo dispositivo.

• Host, gruppi, snippet e inoltri sono conservati sul tuo dispositivo.
• Le password e le chiavi private sono conservate nel Portachiavi iOS.
• Le chiavi host attendibili vengono memorizzate sul tuo dispositivo per gli avvisi descritti in Verificare le chiavi host.
• Le conversazioni con l'assistente restano sul tuo dispositivo, una per host, così una chat è ancora lì quando ti riconnetti. Tocca il cestino nell'assistente per eliminarne una.

L'Assistente AI è l'unica eccezione: quando lo usi, l'output pertinente del terminale (e gli eventuali file che alleghi) viene inviato al provider di modelli che configuri — Anthropic, OpenAI, OpenRouter o Hugging Face — usando la tua chiave API. Non viene inviato nulla finché non usi l'assistente, e la tua chiave è conservata nel Portachiavi iOS. Consulta l'informativa sulla privacy del tuo provider per sapere come tratta quei dati.