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.
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, 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:
- Accedi a KPanel su kpanel.kapsulehost.com.
- Fai clic su Siti web nella barra laterale sinistra.
- Fai clic sul sito a cui vuoi collegarti.
- Vai alla pagina SSH / SFTP.
- Il nome utente del tuo sito è mostrato nella parte superiore di questa scheda. In genere ha un aspetto simile a
mysite_comomyexamplesite_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 se non lo hai già.
Configurazione passo dopo passo
-
Apri FileZilla.
-
Vai su File > Site Manager (oppure premi
Ctrl+Ssu Windows /Cmd+Ssu Mac). -
Fai clic su Aggiungi Sito Web e assegnagli un nome (ad esempio, "Il mio sito KapsuleHost").
-
Nella scheda General, configura i seguenti campi:
Campo Valore Protocollo SFTP - SSH File Transfer Protocol Host cp1-kapsule.kapsulehost.comPorta 22Tipo 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 -
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_ed25519o~/.ssh/id_rsa). Su Windows, si trovano spesso inC:\Users\YourName\.ssh\.
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.
- 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.
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.
Configurazione passo dopo passo
-
Apri Cyberduck.
-
Fai clic su Open Connection (l'icona del globo nella barra degli strumenti).
-
Dal menu a tendina del protocollo in alto nella finestra di dialogo, seleziona SFTP (SSH File Transfer Protocol).
-
Compila i campi di connessione:
Campo Valore Server cp1-kapsule.kapsulehost.comPorta 22Nome 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 -
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:
- Dopo esserti collegato con successo, vai su Bookmark > New Bookmark (oppure premi
Cmd+Shift+Bsu Mac). - 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
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:
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
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 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.
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 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 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à.