SFTP (Protocolo de Transferencia Segura de Archivos) le brinda acceso directo a los archivos de su sitio en el servidor. Esta guía cubre todo lo que necesita para conectarse con éxito, desde encontrar sus credenciales hasta solucionar errores.
Qué es SFTP y cuándo usarlo
El gestor de archivos integrado en KPanel es conveniente para ediciones rápidas: renombrar un archivo, ver una configuración o subir un único recurso. SFTP es la herramienta adecuada cuando necesita más:
- Subir o descargar grandes cantidades de archivos a la vez (migrar un sitio, subir imágenes en masa).
- Transferir archivos grandes que agotarían el tiempo de espera en una subida basada en navegador.
- Trabajar como parte de un flujo de desarrollo donde edita archivos localmente y envía los cambios.
- Usar un cliente con interfaz gráfica que le permita mantener sincronizada una carpeta local y una remota.
- Acceder a registros o archivos de configuración que no están expuestos a través del gestor de archivos de KPanel.
SFTP cifra todos los datos en tránsito, lo que lo hace más seguro que el FTP sin cifrar. KapsuleHost no ofrece conexiones FTP sin cifrar.
Requisitos previos
Antes de poder conectarse, necesita tener dos cosas en orden.
1. Una clave SSH añadida a su sitio en KPanel.
SFTP en KapsuleHost utiliza autenticación mediante clave SSH. La autenticación por contraseña está deshabilitada por motivos de seguridad. Si todavía no ha añadido su clave pública SSH, siga primero la guía Cómo añadir claves SSH a su sitio y luego vuelva aquí.
2. El nombre de usuario de su sitio.
Cada sitio en KapsuleHost tiene un usuario de sistema dedicado. Este no es su dirección de correo electrónico de KPanel. Es un nombre de usuario breve vinculado específicamente a ese sitio.
Para encontrarlo:
- Inicie sesión en KPanel en kpanel.kapsulehost.com.
- Haga clic en Sitios web en la barra lateral izquierda.
- Haga clic en el sitio al que desea conectarse.
- Vaya a la página SSH / SFTP.
- El nombre de usuario de su sitio se muestra en la parte superior de esta pestaña. Normalmente tiene un aspecto similar a
mysite_comomyexamplesite_net.
Detalles de conexión de un vistazo:
| Campo | Valor |
|---|---|
| Host | cp1-kapsule.kapsulehost.com |
| Puerto | 22 |
| Protocolo | SFTP (no FTP, no FTPS) |
| Autenticación | Solo clave SSH |
| Usuario | El nombre de usuario de su sitio (desde KPanel > Websites > [sitio] > Settings > SFTP) |
Conexión con FileZilla
FileZilla es un cliente SFTP gratuito y multiplataforma disponible para Windows, macOS y Linux. Descárguelo desde filezilla-project.org si todavía no lo tiene.
Configuración paso a paso
-
Abra FileZilla.
-
Vaya a File > Site Manager (o pulse
Ctrl+Sen Windows /Cmd+Sen Mac). -
Haga clic en Añadir Sitio Web y asígnele un nombre (por ejemplo, "Mi sitio de KapsuleHost").
-
En la pestaña General, configure los siguientes campos:
Campo Valor Protocolo SFTP - SSH File Transfer Protocol Host cp1-kapsule.kapsulehost.comPuerto 22Tipo de inicio de sesión Key file Usuario El nombre de usuario de su sitio (por ejemplo, mysite_com)Archivo de clave Haga clic en Browse y navegue hasta su archivo de clave privada -
Para el archivo de clave, seleccione la clave privada que corresponde a la clave pública que añadió en KPanel. En macOS y Linux, las claves privadas suelen almacenarse en
~/.ssh/(por ejemplo,~/.ssh/id_ed25519o~/.ssh/id_rsa). En Windows, suelen encontrarse enC:\Users\YourName\.ssh\.
Si su clave privada tiene una frase de contraseña, FileZilla le pedirá que la introduzca al conectarse. Esto es normal. La frase de contraseña protege su archivo de clave privada y es independiente de cualquier contraseña de KapsuleHost.
- Haga clic en Connect para probar la conexión, o en OK para guardarla y conectarse más tarde.
Guardar y volver a conectarse
Una vez guardado en Site Manager, puede volver a conectarse en cualquier momento yendo a File > Site Manager y haciendo clic en Connect. FileZilla también muestra sus sitios guardados en el menú desplegable de la barra de herramientas para un acceso rápido.
En el Site Manager de FileZilla, marque la casilla Always trust this host la primera vez que se conecte para evitar el aviso de clave de host en conexiones futuras.
Conexión con Cyberduck
Cyberduck es un cliente SFTP gratuito para macOS y Windows. Descárguelo desde cyberduck.io.
Configuración paso a paso
-
Abra Cyberduck.
-
Haga clic en Open Connection (el icono del globo en la barra de herramientas).
-
En el menú desplegable de protocolo en la parte superior del cuadro de diálogo, seleccione SFTP (SSH File Transfer Protocol).
-
Complete los campos de conexión:
Campo Valor Servidor cp1-kapsule.kapsulehost.comPuerto 22Usuario El nombre de usuario de su sitio (por ejemplo, mysite_com)Contraseña Déjelo en blanco Clave privada SSH Haga clic en Choose y seleccione su archivo de clave privada -
Haga clic en Connect.
En la primera conexión, Cyberduck le pedirá que verifique la huella digital de la clave del servidor. Haga clic en Allow para continuar. Si ve este aviso en una conexión posterior con una huella digital diferente, no la acepte y contacte con soporte, ya que podría indicar un cambio de configuración.
Guardar como marcador
Para guardar la conexión para un uso futuro:
- Después de conectarse con éxito, vaya a Bookmark > New Bookmark (o pulse
Cmd+Shift+Ben Mac). - Asigne un nombre al marcador y cierre el cuadro de diálogo. El marcador aparece en su lista de marcadores de Cyberduck.
Conexión desde Terminal (Mac, Linux o WSL)
Si prefiere la línea de comandos, el comando sftp está disponible en macOS, Linux y el Subsistema de Windows para Linux (WSL).
Conexión básica
sftp mysite_com@cp1-kapsule.kapsulehost.com
Reemplace mysite_com con el nombre de usuario real de su sitio. Si su clave privada no está en la ubicación predeterminada (~/.ssh/id_rsa o ~/.ssh/id_ed25519), indíquela con la opción -i:
sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com
En la primera conexión, se le pedirá que confirme la huella digital del servidor. Escriba yes y pulse Enter. Esto solo ocurre una vez por clave y por dispositivo.
Comandos útiles de SFTP
Una vez conectado, verá un indicador sftp>. Use estos comandos para navegar y transferir archivos:
| Comando | Qué hace |
|---|---|
ls | Lista los archivos en el directorio remoto actual |
lls | Lista los archivos en el directorio local actual |
cd [dir] | Cambia de directorio en el servidor remoto |
lcd [dir] | Cambia de directorio en su máquina local |
pwd | Muestra la ruta del directorio remoto actual |
lpwd | Muestra la ruta del directorio local actual |
get [file] | Descarga un archivo del remoto al local |
get -r [dir] | Descarga un directorio de forma recursiva |
put [file] | Sube un archivo del local al remoto |
put -r [dir] | Sube un directorio de forma recursiva |
rm [file] | Elimina un archivo en el servidor remoto |
mkdir [dir] | Crea un directorio en el servidor remoto |
quit | Cierra la conexión SFTP |
Ejemplo: descargar un archivo
sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip
Ejemplo: subir un archivo
sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg
Dónde están sus archivos
Después de conectarse, llegará al directorio de inicio del usuario de su sitio: /home/[siteuser]/.
La estructura de directorios es la siguiente:
/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 raíz web donde se encuentra su WordPress (u otra aplicación) es htdocs/. Este es el directorio en el que pasará la mayor parte del tiempo. En algunas configuraciones de sitio, puede llamarse public_html/ en su lugar. Si al conectarse ve public_html/ en lugar de htdocs/, use ese.
Solo puede acceder a los archivos que pertenecen al usuario de su sitio. No puede navegar por encima de /home/[siteuser]/ ni acceder a los directorios de otros clientes. Esto es intencionado.
Solución de problemas de conexión
"Connection refused"
La conexión fue rechazada activamente antes de establecerse.
Verifique: confirme que está usando el host cp1-kapsule.kapsulehost.com y el puerto 22. Un error común es introducir el puerto 21 (que es FTP, no SFTP) o cometer una errata en el nombre del host.
"Permission denied (publickey)"
El servidor aceptó el intento de conexión pero rechazó su autenticación.
Verifique cada uno de los siguientes puntos:
- Su clave pública SSH está añadida en KPanel > Websites > [sitio] > Settings > SSH Keys. Si no aparece allí, el servidor no tiene registro de ella.
- Ha seleccionado la clave privada correcta en FileZilla/Cyberduck, específicamente la clave privada que se empareja con la clave pública que añadió en KPanel.
- Si su clave tiene una frase de contraseña, asegúrese de introducirla correctamente.
- Si tiene varias claves, confirme que no está seleccionando accidentalmente la incorrecta.
"Host key verification failed"
Su cliente SFTP ha visto previamente una clave de host diferente para este nombre de host y le advierte de una discrepancia.
En la primera conexión: se le pedirá que acepte la huella digital. Esto es normal. Haga clic en Accept o escriba yes.
En una conexión posterior con una huella digital nueva: esto puede indicar un cambio de configuración en el servidor. Contacte con soporte en support@kapsulehost.com antes de aceptar, y mencione lo que vio.
Para eliminar una clave de host antigua en la terminal, edite ~/.ssh/known_hosts y elimine la línea correspondiente a cp1-kapsule.kapsulehost.com.
"Could not read from remote repository" o directorio incorrecto
Puede que haya usado su dirección de correo electrónico de KPanel como nombre de usuario en lugar del nombre de usuario de su sitio.
Verifique: el nombre de usuario debe ser el nombre de usuario de su sitio (por ejemplo, mysite_com), no su dirección de correo electrónico. Encuentre el nombre de usuario correcto en KPanel > Websites > [sitio] > Settings > SFTP.
La conexión se agota por tiempo de espera
El intento de conexión se queda colgado y luego se agota el tiempo de espera sin ningún error.
Posibles causas:
- Su dirección IP puede estar bloqueada temporalmente por el firewall de KapsuleHost debido a intentos de inicio de sesión fallidos repetidos. Contacte con soporte en support@kapsulehost.com y pídales que revisen el registro del firewall.
- Un firewall local o una VPN en su red puede estar bloqueando las conexiones salientes en el puerto 22. Pruebe desde una red diferente (por ejemplo, un punto de acceso móvil) para descartar esto.