Connessione via SFTP: FileZilla, Cyberduck e riga di comando

SFTP (Secure File Transfer Protocol) ti dà accesso diretto ai file del tuo sito sul server. Questa guida copre tutto ciò che hai bisogno per connetterti con successo, dal reperimento delle tue credenziali alla risoluzione degli errori.

Cos'è SFTP e quando usarlo

Il file manager integrato in KPanel è conveniente per modifiche rapide: rinominare un file, visualizzare una configurazione o caricare una singola risorsa. SFTP è lo strumento giusto quando hai bisogno di più:

• Caricare o scaricare un gran numero di file contemporaneamente (migrare un sito, caricare immagini in massa).
• Trasferire file di grandi dimensioni che potrebbero scadere in un caricamento basato su browser.
• Lavorare come parte di un flusso di lavoro di sviluppo dove modifichi i file localmente e spingi i cambiamenti.
• Usare un client GUI che ti consente di mantenere una cartella locale e remota sincronizzate.
• Accedere a file di log o di configurazione non esposti tramite il file manager di KPanel.

SFTP crittografa tutti i dati in transito, il che lo rende più sicuro dell'FTP non crittografato. KapsuleHost non offre connessioni FTP non crittografate.

Prerequisiti

Prima di poter connetterti, hai bisogno di due cose.

1. Una chiave SSH aggiunta al tuo sito in KPanel.

SFTP su KapsuleHost utilizza l'autenticazione tramite chiave SSH. L'autenticazione tramite password è disabilitata per motivi di sicurezza. Se non hai ancora aggiunto la tua chiave pubblica SSH, segui prima la guida Aggiunta di chiavi SSH al tuo sito, quindi 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 nome utente breve associato specificamente a quel sito.

Per trovarlo:

1. Accedi a KPanel su kpanel.kapsulehost.com.
2. Fai clic su Websites nella barra laterale sinistra.
3. Fai clic sul sito a cui vuoi connetterti.
4. Vai alla pagina SSH / SFTP.
5. Il nome utente del tuo sito è mostrato in cima a questa scheda. Tipicamente assomiglia a mysite_com o myexamplesite_net.

Dettagli della connessione a colpo d'occhio:

---

Connessione con FileZilla

FileZilla è un client SFTP gratuito e multipiattaforma disponibile per Windows, macOS e Linux. Scaricalo da filezilla-project.org se non lo hai già.

Configurazione passo dopo passo

1. Apri FileZilla.

2. Vai su File > Site Manager (o premi Ctrl+S su Windows / Cmd+S su Mac).

3. Fai clic su Add Website e assegnagli un nome (ad esempio, "My Kapsule Site").

4. Nella scheda General, configura i seguenti campi:

   Campo	Valore
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	Il nome utente del tuo sito (ad esempio, mysite_com)
   Key file	Fai clic su Browse e naviga al tuo file di chiave privata

5. Per il file di chiave, seleziona la chiave privata che corrisponde alla chiave pubblica che hai aggiunto in KPanel. Su macOS e Linux, le chiavi private sono tipicamente memorizzate in ~/.ssh/ (ad esempio, ~/.ssh/id_ed25519 o ~/.ssh/id_rsa). Su Windows, si trovano spesso in C:\Users\YourName\.ssh\.

1. Fai clic su Connect per testare la connessione, o fai clic su OK per salvare e connetterti in seguito.

Salvataggio e riconnessione

Una volta salvato in Site Manager, puoi riconnetterti in qualsiasi momento andando su File > Site Manager e facendo clic su Connect. FileZilla mostra anche i tuoi siti salvati nel dropdown sulla barra degli strumenti per un accesso veloce.

---

Connessione con Cyberduck

Cyberduck è un client SFTP gratuito per macOS e Windows. Scaricalo da 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 discesa dei protocolli in cima alla finestra, seleziona SFTP (SSH File Transfer Protocol).

4. Compila i campi di connessione:

   Campo	Valore
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	Il nome utente del tuo sito (ad esempio, mysite_com)
   Password	Lascia vuoto
   SSH Private Key	Fai clic su Choose e seleziona il tuo file di chiave privata

5. Fai clic su Connect.

Alla prima connessione, Cyberduck ti chiederà di verificare l'impronta digitale della chiave host del server. Fai clic su Allow per procedere. Se vedi questo prompt in una connessione successiva con un'impronta diversa, non accettarla e contatta il supporto, poiché potrebbe indicare un cambio di configurazione.

Salvataggio come segnalibro

Per salvare la connessione per usi futuri:

1. Dopo essersi connessi con successo, vai a Bookmark > New Bookmark (oppure premi Cmd+Shift+B su Mac).
2. Dai un nome al bookmark e chiudi la finestra di dialogo. Il bookmark apparirà nell'elenco dei bookmark di Cyberduck.

---

Connessione dal 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

sftp mysite_com@cp1-kapsule.kapsulehost.com

Sostituisci mysite_com con il tuo nome utente del sito effettivo. Se la tua chiave privata non si trova nella posizione predefinita (~/.ssh/id_rsa o ~/.ssh/id_ed25519), specificala con il flag -i:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

Alla prima connessione, ti verrà chiesto di confermare l'impronta digitale dell'host del server. Digita yes e premi Invio. Questo accade una sola volta per chiave per dispositivo.

Comandi SFTP utili

Una volta connesso, vedrai un prompt sftp>. Usa questi comandi per navigare e trasferire file:

Esempio: scaricare un file

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

Esempio: caricare un file

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

Dove si trovano i tuoi file

Dopo la connessione, verrai posizionato nella home directory dell'utente del sito: /home/[siteuser]/.

La struttura delle directory è simile a questa:

/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 radice web dove si trova WordPress (o un'altra applicazione) è htdocs/. Questa è la directory in cui trascorrerai la maggior parte del tempo. Su alcune configurazioni del sito potrebbe essere denominata public_html/. Se ti connetti e vedi public_html/ anziché htdocs/, usala.

---

Risoluzione dei problemi di connessione

"Connessione rifiutata"

La connessione è stata attivamente rifiutata prima di essere stabilita.

Verifica: Conferma che stai utilizzando l'host cp1-kapsule.kapsulehost.com e la porta 22. Un errore comune è inserire la porta 21 (che è FTP, non SFTP) o un errore di battitura nel nome host.

"Permesso negato (publickey)"

Il server ha accettato il tentativo di connessione ma ha rifiutato la tua autenticazione.

Verifica ognuno dei seguenti punti:

• La tua chiave pubblica SSH è aggiunta in KPanel > Websites > [site] > SSH / SFTP. Se non è elencata lì, il server non ne ha alcun record.
• Hai selezionato la chiave privata corretta in FileZilla/Cyberduck, in particolare la chiave privata che si abbina alla chiave pubblica aggiunta a KPanel.
• Se la tua chiave ha una passphrase, assicurati di inserirla correttamente.
• Se hai più chiavi, conferma di non stare selezionando accidentalmente la chiave sbagliata.

"Verifica chiave host non riuscita"

Il tuo client SFTP ha visto una chiave host diversa per questo nome host prima e ti sta avvisando di una discrepanza.

Alla prima connessione: Ti verrà chiesto di accettare l'impronta digitale. Questo è normale. Fai clic su Accetta o digita yes.

Con una nuova impronta digitale in una connessione successiva: Questo potrebbe indicare un cambiamento di configurazione sul server. Contatta il supporto all'indirizzo support@kapsulehost.com prima di accettare e menziona cosa hai visto.

Per cancellare una vecchia chiave host nel terminale, modifica ~/.ssh/known_hosts e rimuovi la riga per cp1-kapsule.kapsulehost.com.

"Impossibile leggere dal repository remoto" o Directory errata

Potresti aver utilizzato il tuo indirizzo email di KPanel come nome utente invece del tuo nome utente del sito.

Verifica: Il nome utente deve essere il tuo nome utente del sito (ad esempio, mysite_com), non il tuo indirizzo email. Trova il nome utente corretto in KPanel > Websites > [site] > SSH / SFTP.

Timeout della connessione

Il tentativo di connessione si blocca e quindi scade senza alcun errore.

Possibili cause:

• Il tuo indirizzo IP potrebbe essere temporaneamente bloccato dal firewall di Kapsule a causa di ripetuti tentativi di accesso non riusciti. Contatta il supporto all'indirizzo support@kapsulehost.com e chiedi loro di controllare il log del firewall.
• Un firewall locale o VPN sulla tua rete potrebbe bloccare le connessioni in uscita sulla porta 22. Prova da una rete diversa (ad esempio, hotspot mobile) per escludere questa possibilità.

---

Articoli correlati

• Aggiunta di chiavi SSH al tuo sito
• Utilizzo del File Manager in KPanel
• Connessione al tuo database tramite tunnel SSH