# Connessione tramite SFTP: FileZilla, Cyberduck e riga di comando Source: https://support.kapsulehost.com/it-it/sftp-access SFTP (Secure File Transfer Protocol) ti offre accesso diretto ai file del tuo sito sul server. Questa guida copre tutto ciò che ti serve per collegarti con successo, dal trovare le tue credenziali alla risoluzione degli errori. ## Cos'è SFTP e quando usarlo Il gestore file integrato in KPanel è comodo per modifiche rapide: rinominare un file, visualizzare una configurazione o caricare un singolo elemento. SFTP è lo strumento giusto quando hai bisogno di più: - Caricare o scaricare un gran numero di file in una sola volta (migrazione di un sito, caricamento massivo di immagini). - Trasferire file di grandi dimensioni che andrebbero in timeout in un caricamento via browser. - Lavorare come parte di un flusso di sviluppo in cui modifichi i file in locale e carichi le modifiche. - Usare un client GUI che ti permette di mantenere sincronizzata una cartella locale e una remota. - Accedere a log o file di configurazione non esposti tramite il gestore file di KPanel. SFTP cifra tutti i dati in transito, il che lo rende più sicuro del semplice FTP. KapsuleHost non offre connessioni FTP non cifrate. ![I dettagli di connessione SSH e SFTP per un sito in KPanel](https://support.kapsulehost.com/help/screenshots/sftp-access.df4a2e3e.webp) ## Prerequisiti Prima di poterti collegare, ti servono due cose. **1. Una chiave SSH aggiunta al tuo sito in KPanel.** SFTP su KapsuleHost utilizza l'autenticazione tramite chiave SSH. L'autenticazione con password è disabilitata per sicurezza. Se non hai ancora aggiunto la tua chiave pubblica SSH, segui prima la guida [Aggiungere chiavi SSH al tuo sito](https://support.kapsulehost.com/it-it/adding-ssh-keys), poi torna qui. **2. Il nome utente del tuo sito.** Ogni sito su KapsuleHost ha un utente di sistema dedicato. Non è il tuo indirizzo email di KPanel. È un breve nome utente legato specificamente a quel sito. Per trovarlo: 1. Accedi a KPanel su [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com). 2. Fai clic su **Siti web** nella barra laterale sinistra. 3. Fai clic sul sito a cui vuoi collegarti. 4. Vai alla pagina **SSH / SFTP**. 5. Il nome utente del tuo sito è mostrato nella parte superiore di questa scheda. In genere ha un aspetto simile a `mysite_com` o `myexamplesite_net`. **Dettagli di connessione in sintesi:** | Campo | Valore | |---|---| | Host | `cp1-kapsule.kapsulehost.com` | | Porta | `22` | | Protocollo | SFTP (non FTP, non FTPS) | | Autenticazione | Solo chiave SSH | | Nome utente | Il nome utente del tuo sito (da KPanel > Websites > [sito] > Settings > SFTP) | --- ## Connessione con FileZilla FileZilla è un client SFTP gratuito e multipiattaforma disponibile per Windows, macOS e Linux. Scaricalo da [filezilla-project.org](https://filezilla-project.org) se non lo hai già. ### Configurazione passo dopo passo 1. Apri FileZilla. 2. Vai su **File > Site Manager** (oppure premi `Ctrl+S` su Windows / `Cmd+S` su Mac). 3. Fai clic su **Aggiungi Sito Web** e assegnagli un nome (ad esempio, "Il mio sito KapsuleHost"). 4. Nella scheda **General**, configura i seguenti campi: | Campo | Valore | |---|---| | Protocollo | **SFTP - SSH File Transfer Protocol** | | Host | `cp1-kapsule.kapsulehost.com` | | Porta | `22` | | Tipo di accesso | **Key file** | | Utente | Il nome utente del tuo sito (ad esempio, `mysite_com`) | | File della chiave | Fai clic su **Browse** e vai al file della tua chiave privata | 5. Per il file della chiave, seleziona la chiave privata corrispondente alla chiave pubblica che hai aggiunto in KPanel. Su macOS e Linux, le chiavi private si trovano tipicamente in `~/.ssh/` (ad esempio, `~/.ssh/id_ed25519` o `~/.ssh/id_rsa`). Su Windows, si trovano spesso in `C:\Users\YourName\.ssh\`. > **Note:** Se la tua chiave privata ha una passphrase, FileZilla ti chiederà di inserirla al momento della connessione. È normale. La passphrase protegge il file della tua chiave privata ed è indipendente da qualsiasi password di KapsuleHost. 6. Fai clic su **Connect** per testare la connessione, oppure su **OK** per salvare e collegarti più tardi. ### Salvare e ricollegarsi Una volta salvato in Site Manager, puoi ricollegarti in qualsiasi momento andando su **File > Site Manager** e facendo clic su **Connect**. FileZilla mostra anche i tuoi siti salvati nel menu a tendina sulla barra degli strumenti per un accesso rapido. > **Tip:** Nel Site Manager di FileZilla, seleziona la casella **Always trust this host** la prima volta che ti colleghi, per evitare la richiesta della chiave host nelle connessioni future. --- ## Connessione con Cyberduck Cyberduck è un client SFTP gratuito per macOS e Windows. Scaricalo da [cyberduck.io](https://cyberduck.io). ### Configurazione passo dopo passo 1. Apri Cyberduck. 2. Fai clic su **Open Connection** (l'icona del globo nella barra degli strumenti). 3. Dal menu a tendina del protocollo in alto nella finestra di dialogo, seleziona **SFTP (SSH File Transfer Protocol)**. 4. Compila i campi di connessione: | Campo | Valore | |---|---| | Server | `cp1-kapsule.kapsulehost.com` | | Porta | `22` | | Nome utente | Il nome utente del tuo sito (ad esempio, `mysite_com`) | | Password | Lascia vuoto | | Chiave privata SSH | Fai clic su **Choose** e seleziona il file della tua chiave privata | 5. Fai clic su **Connect**. Al primo collegamento, Cyberduck ti chiederà di verificare l'impronta della chiave host del server. Fai clic su **Allow** per procedere. Se vedi questa richiesta in una connessione successiva con un'impronta diversa, non accettarla e contatta l'assistenza, poiché potrebbe indicare una modifica alla configurazione. ### Salvare come segnalibro Per salvare la connessione per un uso futuro: 1. Dopo esserti collegato con successo, vai su **Bookmark > New Bookmark** (oppure premi `Cmd+Shift+B` su Mac). 2. Assegna un nome al segnalibro e chiudi la finestra di dialogo. Il segnalibro comparirà nel tuo elenco di segnalibri di Cyberduck. --- ## Connessione da Terminale (Mac, Linux o WSL) Se preferisci la riga di comando, il comando `sftp` è disponibile su macOS, Linux e Windows Subsystem for Linux (WSL). ### Connessione di base ```bash sftp mysite_com@cp1-kapsule.kapsulehost.com ``` Sostituisci `mysite_com` con il tuo effettivo nome utente del sito. Se la tua chiave privata non si trova nella posizione predefinita (`~/.ssh/id_rsa` o `~/.ssh/id_ed25519`), specificala con il flag `-i`: ```bash sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com ``` Al primo collegamento, ti verrà chiesto di confermare l'impronta della chiave host del server. Digita `yes` e premi Invio. Questo avviene solo una volta per ogni chiave per dispositivo. ### Comandi SFTP utili Una volta collegato, vedrai un prompt `sftp>`. Usa questi comandi per navigare e trasferire file: | Comando | Cosa fa | |---|---| | `ls` | Elenca i file nella directory remota corrente | | `lls` | Elenca i file nella directory locale corrente | | `cd [dir]` | Cambia directory sul server remoto | | `lcd [dir]` | Cambia directory sul tuo computer locale | | `pwd` | Mostra il percorso della directory remota corrente | | `lpwd` | Mostra il percorso della directory locale corrente | | `get [file]` | Scarica un file dal remoto al locale | | `get -r [dir]` | Scarica una directory in modo ricorsivo | | `put [file]` | Carica un file dal locale al remoto | | `put -r [dir]` | Carica una directory in modo ricorsivo | | `rm [file]` | Elimina un file sul server remoto | | `mkdir [dir]` | Crea una directory sul server remoto | | `quit` | Chiude la connessione SFTP | **Esempio: scaricare un file** ```bash sftp> cd htdocs/wp-content/themes sftp> get my-theme.zip ``` **Esempio: caricare un file** ```bash sftp> lcd ~/Desktop sftp> cd htdocs/wp-content/uploads sftp> put my-image.jpg ``` --- ## Dove si trovano i tuoi file Dopo esserti collegato, ti troverai nella directory home del tuo utente del sito: `/home/[siteuser]/`. La struttura delle directory è la seguente: ``` /home/mysite_com/ ├── htdocs/ ← Your web root (main location for site files) │ ├── index.php │ ├── wp-config.php │ ├── wp-content/ │ │ ├── themes/ │ │ ├── plugins/ │ │ └── uploads/ │ └── ... ├── logs/ ← PHP and access logs └── tmp/ ← Temporary files ``` La root web dove risiede il tuo WordPress (o altra applicazione) è `htdocs/`. Questa è la directory in cui trascorrerai la maggior parte del tuo tempo. Su alcune configurazioni di sito potrebbe chiamarsi `public_html/` invece. Se ti colleghi e vedi `public_html/` anziché `htdocs/`, usa quella. > **Note:** Puoi accedere solo ai file appartenenti al tuo utente del sito. Non puoi navigare sopra `/home/[siteuser]/` o accedere alle directory di altri clienti. Questo è voluto dal progetto. --- ## Risoluzione dei problemi di connessione ### "Connection refused" La connessione è stata attivamente rifiutata prima ancora di essere stabilita. **Verifica:** Conferma di star usando l'host `cp1-kapsule.kapsulehost.com` e la porta `22`. Un errore comune è inserire la porta `21` (che è FTP, non SFTP) oppure un errore di battitura nel nome host. ### "Permission denied (publickey)" Il server ha accettato il tentativo di connessione ma ha rifiutato la tua autenticazione. **Controlla ciascuno dei seguenti punti:** - La tua chiave pubblica SSH è aggiunta in **KPanel > Websites > [sito] > Settings > SSH Keys**. Se non è elencata lì, il server non ne ha traccia. - Hai selezionato la chiave privata corretta in FileZilla/Cyberduck, nello specifico quella che corrisponde alla chiave pubblica che hai aggiunto in KPanel. - Se la tua chiave ha una passphrase, assicurati di inserirla correttamente. - Se hai più chiavi, verifica di non aver selezionato per errore quella sbagliata. ### "Host key verification failed" Il tuo client SFTP ha già visto in precedenza una chiave host diversa per questo nome host e ti sta avvisando di una discrepanza. **Al primo collegamento:** Ti verrà chiesto di accettare l'impronta. È normale. Fai clic su Accept o digita `yes`. **In una connessione successiva con una nuova impronta:** Questo può indicare una modifica alla configurazione del server. Contatta l'assistenza a [support@kapsulehost.com](mailto:support@kapsulehost.com) prima di accettare, indicando cosa hai visto. Per rimuovere una vecchia chiave host dal terminale, modifica `~/.ssh/known_hosts` e rimuovi la riga relativa a `cp1-kapsule.kapsulehost.com`. ### "Could not read from remote repository" o Directory errata Potresti aver usato il tuo indirizzo email di KPanel come nome utente invece del nome utente del tuo sito. **Verifica:** Il nome utente deve essere il nome utente del tuo sito (ad esempio, `mysite_com`), non il tuo indirizzo email. Trova il nome utente corretto in **KPanel > Websites > [sito] > Settings > SFTP**. ### La connessione va in timeout Il tentativo di connessione resta in attesa e poi va in timeout senza alcun errore. **Possibili cause:** - Il tuo indirizzo IP potrebbe essere temporaneamente bloccato dal firewall di KapsuleHost a causa di ripetuti tentativi di accesso falliti. Contatta l'assistenza a [support@kapsulehost.com](mailto:support@kapsulehost.com) e chiedi di controllare il registro del firewall. - Un firewall locale o una VPN sulla tua rete potrebbero bloccare le connessioni in uscita sulla porta 22. Prova da una rete diversa (ad esempio, un hotspot mobile) per escludere questa possibilità. --- ## Articoli correlati - [Aggiungere chiavi SSH al tuo sito](https://support.kapsulehost.com/it-it/adding-ssh-keys) - [Usare il gestore file in KPanel](https://support.kapsulehost.com/it-it/file-manager) - [Connettersi al tuo database tramite tunnel SSH](https://support.kapsulehost.com/it-it/database-ssh-tunnel)