Conexión por SFTP: FileZilla, Cyberduck y línea de comandos

SFTP (Secure File Transfer Protocol) te proporciona acceso directo a los archivos de tu sitio en el servidor. Esta guía cubre todo lo que necesitas para conectarte con éxito, desde encontrar tus credenciales hasta resolver errores.

Qué es SFTP y cuándo usarlo

El administrador de archivos integrado en KPanel es conveniente para ediciones rápidas: renombrar un archivo, ver una configuración o cargar un único recurso. SFTP es la herramienta correcta cuando necesitas más:

• Cargar o descargar grandes cantidades de archivos a la vez (migrar un sitio, cargar imágenes en lote).
• Transferir archivos grandes que agotarían el tiempo de espera en una carga basada en navegador.
• Trabajar como parte de un flujo de desarrollo donde editas archivos localmente e insertas cambios.
• Usar un cliente GUI que te permite mantener sincronizadas una carpeta local y una remota.
• Acceder a registros o archivos de configuración que no se exponen a través del administrador de archivos de KPanel.

SFTP cifra todos los datos en tránsito, lo que lo hace más seguro que FTP sin cifrar. KapsuleHost no ofrece conexiones FTP sin cifrar.

Requisitos previos

Antes de poder conectarte, necesitas dos cosas en su lugar.

1. Una clave SSH añadida a tu sitio en KPanel.

SFTP en KapsuleHost utiliza autenticación de clave SSH. La autenticación por contraseña está deshabilitada por seguridad. Si aún no has añadido tu clave pública SSH, sigue primero la guía Adding SSH Keys to Your Site y luego regresa aquí.

2. Tu nombre de usuario del sitio.

Cada sitio en KapsuleHost tiene un usuario del sistema dedicado. No es tu dirección de correo electrónico de KPanel. Es un nombre de usuario corto vinculado específicamente a ese sitio.

Para encontrarlo:

1. Inicia sesión en KPanel en kpanel.kapsulehost.com.
2. Haz clic en Websites en la barra lateral izquierda.
3. Haz clic en el sitio al que deseas conectarte.
4. Ve a la página SSH / SFTP.
5. Tu nombre de usuario del sitio se muestra en la parte superior de esta pestaña. Normalmente se parece a mysite_com o myexamplesite_net.

Detalles de conexión de un vistazo:

---

Conectarse con FileZilla

FileZilla es un cliente SFTP gratuito y multiplataforma disponible para Windows, macOS y Linux. Descárgalo desde filezilla-project.org si aún no lo tienes.

Configuración paso a paso

1. Abre FileZilla.

2. Ve a File > Site Manager (o presiona Ctrl+S en Windows / Cmd+S en Mac).

3. Haz clic en Add Website y dale un nombre (por ejemplo, "Mi Sitio Kapsule").

4. En la pestaña General, configura los siguientes campos:

   Campo	Valor
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	Tu nombre de usuario del sitio (por ejemplo, mysite_com)
   Key file	Haz clic en Browse y navega a tu archivo de clave privada

5. Para el archivo de clave, selecciona la clave privada que corresponde a la clave pública que añadiste en KPanel. En macOS y Linux, las claves privadas se almacenan típicamente en ~/.ssh/ (por ejemplo, ~/.ssh/id_ed25519 o ~/.ssh/id_rsa). En Windows, generalmente están en C:\Users\YourName\.ssh\.

1. Haz clic en Connect para probar la conexión, o haz clic en OK para guardar y conectarte más tarde.

Guardar y reconectar

Una vez guardado en Site Manager, puedes reconectarte en cualquier momento yendo a File > Site Manager y haciendo clic en Connect. FileZilla también muestra tus sitios guardados en la lista desplegable de la barra de herramientas para acceso rápido.

---

Conectarse con Cyberduck

Cyberduck es un cliente SFTP gratuito para macOS y Windows. Descárgalo desde cyberduck.io.

Configuración paso a paso

1. Abre Cyberduck.

2. Haz clic en Open Connection (el icono del globo en la barra de herramientas).

3. Desde la lista desplegable del protocolo en la parte superior del cuadro de diálogo, selecciona SFTP (SSH File Transfer Protocol).

4. Rellena los campos de conexión:

   Campo	Valor
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	Tu nombre de usuario del sitio (por ejemplo, mysite_com)
   Password	Dejar en blanco
   SSH Private Key	Haz clic en Choose y selecciona tu archivo de clave privada

5. Haz clic en Connect.

En la primera conexión, Cyberduck te pedirá que verifiques la huella digital de la clave de host del servidor. Haz clic en Allow para continuar. Si ves este aviso en una conexión posterior con una huella digital diferente, no lo aceptes y contacta con el soporte, ya que puede indicar un cambio de configuración.

Guardar como marcador

Para guardar la conexión para futuro uso:

1. Después de conectarse exitosamente, vaya a Bookmark > New Bookmark (o presione Cmd+Shift+B en Mac).
2. Asigne un nombre al marcador y cierre el diálogo. El marcador aparece en su lista de marcadores de Cyberduck.

---

Conectarse desde Terminal (Mac, Linux o WSL)

Si prefiere la línea de comandos, el comando sftp está disponible en macOS, Linux y Windows Subsystem for Linux (WSL).

Conexión Básica

sftp mysite_com@cp1-kapsule.kapsulehost.com

Reemplace mysite_com con su nombre de usuario real del sitio. Si su clave privada no está en la ubicación predeterminada (~/.ssh/id_rsa o ~/.ssh/id_ed25519), especifíquela con la bandera -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 presione Enter. Esto solo ocurre una vez por clave por dispositivo.

Comandos SFTP Útiles

Una vez conectado, verá un prompt sftp>. Use estos comandos para navegar y transferir archivos:

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 del sitio: /home/[siteuser]/.

La estructura de directorios se ve así:

/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 vive su WordPress (u otra aplicación) es htdocs/. Este es el directorio donde pasará la mayor parte de su tiempo. En algunas configuraciones de sitio puede llamarse public_html/ en su lugar. Si se conecta y ve public_html/ en lugar de htdocs/, use ese.

---

Solución de Problemas de Conexión

"Conexión rechazada"

La conexión fue rechazada activamente antes de ser establecida.

Verifique: Confirme que está usando el host cp1-kapsule.kapsulehost.com y el puerto 22. Un error común es ingresar el puerto 21 (que es FTP, no SFTP) o un error tipográfico en el nombre del host.

"Permiso denegado (publickey)"

El servidor aceptó el intento de conexión pero rechazó su autenticación.

Verifique cada uno de los siguientes:

• Su clave pública SSH está agregada en KPanel > Websites > [site] > SSH / SFTP. 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 agregó a KPanel.
• Si su clave tiene una contraseña, asegúrese de que la está ingresando correctamente.
• Si tiene múltiples claves, confirme que no está seleccionando accidentalmente la incorrecta.

"Verificación de clave de host fallida"

Su cliente SFTP ha visto una clave de host diferente para este nombre de host antes y le está advirtiendo sobre una discrepancia.

En la primera conexión: Se le pedirá que acepte la huella digital. Esto es normal. Haga clic en Aceptar o escriba yes.

En una conexión posterior con una huella digital nueva: Esto puede indicar un cambio de configuración en el servidor. Comuníquese con soporte en support@kapsulehost.com antes de aceptar, y mencione lo que vio.

Para borrar una clave de host antigua en la terminal, edite ~/.ssh/known_hosts y elimine la línea de cp1-kapsule.kapsulehost.com.

"No se pudo leer desde el repositorio remoto" o Directorio Incorrecto

Es posible que haya usado su dirección de correo electrónico de KPanel como nombre de usuario en lugar de su nombre de usuario del sitio.

Verifique: El nombre de usuario debe ser su nombre de usuario del sitio (por ejemplo, mysite_com), no su dirección de correo electrónico. Encuentre el nombre de usuario correcto en KPanel > Websites > [site] > SSH / SFTP.

La Conexión Expira

El intento de conexión se congela y luego expira sin ningún error.

Posibles causas:

• Su dirección IP puede estar bloqueada temporalmente por el cortafuegos de Kapsule debido a intentos de inicio de sesión repetidos fallidos. Comuníquese con soporte en support@kapsulehost.com y pídales que verifiquen el registro del cortafuegos.
• Un cortafuegos local o VPN en su red puede estar bloqueando conexiones salientes en el puerto 22. Intente desde una red diferente (por ejemplo, hotspot móvil) para descartar esto.

---

Artículos Relacionados

• Agregar Claves SSH a Su Sitio
• Usar el Administrador de Archivos en KPanel
• Conectarse a Su Base de Datos a través del Túnel SSH