Torna all'indice della documentazione

Risoluzione Problemi

Questa guida copre problemi comuni e le loro soluzioni. Se non trovi il tuo problema qui, contatta il supporto.

Problemi di Connessione

Connessione Rifiutata

Sintomi: Non riesci a connetterti, ricevi errore "connection refused".

Soluzioni:

  1. Verifica che l'host e la porta siano corretti
  2. Assicurati che il server SSH sia in esecuzione sull'host
  3. Verifica le regole del firewall sull'host
  4. Verifica che il server ascolti sulla porta specificata
# Verifica se la porta SSH è aperta
nc -zv hostname 22

Timeout Connessione

Sintomi: La connessione va in timeout senza risposta.

Soluzioni:

  1. Verifica la connettività di rete all'host
  2. Verifica che l'indirizzo IP o l'hostname siano corretti
  3. Controlla eventuali blocchi del firewall
  4. Prova ad aumentare il timeout nelle impostazioni della connessione
# Testa la connettività di rete
ping hostname

Autenticazione Fallita

Sintomi: Nome utente o password rifiutati.

Soluzioni:

  1. Verifica le credenziali
  2. Assicurati che nome utente sia corretto
  3. Verifica che l'account non sia bloccato
  4. Controlla se il server richiede autenticazione con chiave

Chiave SSH Rifiutata

Sintomi: L'autenticazione con chiave fallisce.

Soluzioni:

  1. Assicurati che la chiave pubblica sia nel file ~/.ssh/authorized_keys del server
  2. Verifica i permessi della chiave (deve essere 600 o 400)
  3. Assicurati che la directory .ssh abbia permessi 700
  4. Verifica il formato della chiave (OpenSSH vs altri formati)
  5. Prova una chiave diversa se ne hai più di una
# Controlla i permessi della chiave
chmod 600 ~/.ssh/id_rsa
chmod 700 ~/.ssh

Jump Host Non Funziona

Sintomi: Non riesci a connetterti attraverso il jump host.

Soluzioni:

  1. Verifica prima la connessione al jump host
  2. Assicurati che la configurazione del jump host sia corretta
  3. Verifica di poter raggiungere l'host di destinazione dal jump host
  4. Controlla che le credenziali SSH funzionino per entrambi gli host

Problemi del Terminale

Terminale Non Risponde

Sintomi: Il terminale smette di accettare input.

Soluzioni:

  1. Prova Ctrl+C per interrompere i processi in esecuzione
  2. Prova Ctrl+Q se il terminale è in pausa (Ctrl+S)
  3. Chiudi e riapri il terminale
  4. Se connesso via SSH, la connessione potrebbe essere caduta

Caratteri Visualizzati Male

Sintomi: Caratteri strani o corrotti nel terminale.

Soluzioni:

  1. Assicurati che le impostazioni della codifica corrispondano al server (UTF-8)
  2. Prova un font diverso che supporti i caratteri necessari
  3. Verifica la variabile TERM (echo $TERM)
  4. Prova a resettare il terminale: reset

Colori Non Funzionano

Sintomi: I colori non vengono visualizzati.

Soluzioni:

  1. Verifica che la variabile TERM supporti i colori
  2. Prova export TERM=xterm-256color
  3. Verifica le impostazioni del tema in Termial
  4. Assicurati che l'applicazione supporti i colori

Copia/Incolla Non Funziona

Sintomi: Non riesci a copiare o incollare testo.

Soluzioni:

  1. Usa ⌘ C / ⌘ V (macOS) o Ctrl+Shift+C / Ctrl+Shift+V (Windows/Linux)
  2. Verifica le impostazioni degli appunti nelle preferenze
  3. Alcune applicazioni nel terminale catturano le scorciatoie
  4. Prova con il menu del clic destro

Problemi SFTP

Errore Connessione SFTP

Sintomi: Il browser SFTP non si connette.

Soluzioni:

  1. Assicurati che il sottosistema SFTP sia abilitato sul server
  2. Verifica che la connessione SSH funzioni prima
  3. Controlla i log del server per errori SFTP
  4. Prova a riconnetterti

Trasferimento File Fallisce

Sintomi: L'upload o il download di file fallisce.

Soluzioni:

  1. Controlla i permessi sulla directory di destinazione
  2. Assicurati che ci sia spazio su disco sufficiente
  3. Verifica la stabilità della connessione di rete
  4. Prova file più piccoli per testare

Permessi Negati

Sintomi: Non puoi accedere o modificare file.

Soluzioni:

  1. Verifica i permessi dei file sul server
  2. Assicurati di avere i permessi necessari
  3. Controlla il proprietario dei file
  4. Potresti aver bisogno di accesso sudo per alcune operazioni

Problemi Assistente AI

AI Non Risponde

Sintomi: L'assistente AI non restituisce risposte.

Soluzioni:

  1. Verifica la connessione internet
  2. Assicurati che il tuo abbonamento includa le funzionalità AI
  3. Controlla lo stato del servizio AI
  4. Prova a chiudere e riaprire il pannello AI

Risposte AI Irrilevanti

Sintomi: Le risposte AI non sono utili.

Soluzioni:

  1. Fornisci contesto più specifico nella tua domanda
  2. Prova una modalità AI diversa (Comando, Contesto, Agente)
  3. Riformula la tua domanda
  4. Assicurati che la cronologia del terminale rilevante sia visibile

Problemi di Sincronizzazione Cloud

Sincronizzazione Non Funziona

Sintomi: I dati non si sincronizzano tra i dispositivi.

Soluzioni:

  1. Verifica la connessione internet
  2. Assicurati di essere connesso con lo stesso account
  3. Verifica lo stato dell'abbonamento
  4. Prova la sincronizzazione manuale nelle impostazioni

Errore Chiave di Crittografia

Sintomi: I dati non si decrittano correttamente.

Soluzioni:

  1. Assicurati di usare la stessa chiave di crittografia su tutti i dispositivi
  2. Verifica di aver inserito la chiave correttamente
  3. Se hai perso la chiave, i dati cloud potrebbero essere irrecuperabili

Conflitti di Dati

Sintomi: Le connessioni scompaiono o si duplicano.

Soluzioni:

  1. Forza la sincronizzazione su tutti i dispositivi
  2. Controlla i conflitti nella dashboard cloud
  3. Unisci o elimina manualmente i duplicati

Problemi Docker

Daemon Docker Non Connesso

Sintomi: Non riesci a connetterti a Docker.

Soluzioni:

  1. Assicurati che Docker sia installato e in esecuzione
  2. Verifica che il socket Docker sia accessibile
  3. Controlla i permessi Docker (potresti aver bisogno del gruppo docker)
# Verifica lo stato di Docker
docker info

Container Non Visibili

Sintomi: I container non appaiono in Termial.

Soluzioni:

  1. Aggiorna la lista dei container
  2. Verifica che i container esistano con docker ps -a
  3. Controlla la connessione al daemon Docker

Problemi di Prestazioni

Applicazione Lenta

Sintomi: Termial funziona lentamente.

Soluzioni:

  1. Chiudi terminali e connessioni inutilizzati
  2. Riduci la dimensione dello scrollback nelle impostazioni
  3. Disabilita gli effetti di animazione
  4. Riavvia l'applicazione

Alto Uso di Memoria

Sintomi: Termial usa troppa memoria.

Soluzioni:

  1. Riduci la dimensione dello scrollback
  2. Chiudi le sessioni inattive
  3. Riavvia l'applicazione periodicamente
  4. Aggiorna all'ultima versione

Problemi Specifici della Piattaforma

macOS: Richieste di Accesso

Sintomi: Richieste continue per l'accesso alle cartelle.

Soluzioni:

  1. Concedi l'accesso quando richiesto
  2. Controlla Preferenze di Sistema → Privacy e Sicurezza → Accesso Completo al Disco
  3. Aggiungi Termial alle applicazioni autorizzate

Windows: Rilevamento Antivirus

Sintomi: L'antivirus blocca Termial.

Soluzioni:

  1. Aggiungi Termial alle eccezioni dell'antivirus
  2. Verifica che il download sia dalla fonte ufficiale
  3. Contatta il supporto se i problemi persistono

Linux: Problemi di Permessi

Sintomi: Errori di permesso per operazioni.

Soluzioni:

  1. Verifica i permessi sui file di configurazione
  2. Assicurati che l'utente sia nei gruppi necessari
  3. Controlla i permessi del socket Docker se usi Docker

Ottenere Supporto

Prima di Contattare il Supporto

Raccogli queste informazioni:

  1. Versione di Termial (menu Informazioni)
  2. Sistema operativo e versione
  3. Descrizione dettagliata del problema
  4. Passi per riprodurre il problema
  5. Messaggi di errore (screenshot se possibile)

Canali di Supporto

  • Email: Contatta il supporto dal menu dell'applicazione
  • Documentazione: Consulta la documentazione online
  • Aggiornamenti: Assicurati di usare l'ultima versione

Modalità Debug

Per raccogliere informazioni di debug:

  1. Vai su Impostazioni → Avanzate
  2. Abilita Modalità Debug
  3. Riproduci il problema
  4. Raccogli i log dalla directory di configurazione