# Cómo conectarse mediante SFTP: FileZilla, Cyberduck y línea de comandos Source: https://support.kapsulehost.com/es-es/sftp-access 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. ![Los detalles de conexión SSH y SFTP para un sitio en KPanel](https://support.kapsulehost.com/help/screenshots/sftp-access.df4a2e3e.webp) ## 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](https://support.kapsulehost.com/es-es/adding-ssh-keys) 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: 1. Inicie sesión en KPanel en [kpanel.kapsulehost.com](https://kpanel.kapsulehost.com). 2. Haga clic en **Sitios web** en la barra lateral izquierda. 3. Haga clic en el sitio al que desea conectarse. 4. Vaya a la página **SSH / SFTP**. 5. El nombre de usuario de su sitio se muestra en la parte superior de esta pestaña. Normalmente tiene un aspecto similar a `mysite_com` o `myexamplesite_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](https://filezilla-project.org) si todavía no lo tiene. ### Configuración paso a paso 1. Abra FileZilla. 2. Vaya a **File > Site Manager** (o pulse `Ctrl+S` en Windows / `Cmd+S` en Mac). 3. Haga clic en **Añadir Sitio Web** y asígnele un nombre (por ejemplo, "Mi sitio de KapsuleHost"). 4. En la pestaña **General**, configure los siguientes campos: | Campo | Valor | |---|---| | Protocolo | **SFTP - SSH File Transfer Protocol** | | Host | `cp1-kapsule.kapsulehost.com` | | Puerto | `22` | | Tipo 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 | 5. 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_ed25519` o `~/.ssh/id_rsa`). En Windows, suelen encontrarse en `C:\Users\YourName\.ssh\`. > **Note:** 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. 6. 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. > **Tip:** 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](https://cyberduck.io). ### Configuración paso a paso 1. Abra Cyberduck. 2. Haga clic en **Open Connection** (el icono del globo en la barra de herramientas). 3. En el menú desplegable de protocolo en la parte superior del cuadro de diálogo, seleccione **SFTP (SSH File Transfer Protocol)**. 4. Complete los campos de conexión: | Campo | Valor | |---|---| | Servidor | `cp1-kapsule.kapsulehost.com` | | Puerto | `22` | | Usuario | 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 | 5. 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: 1. Después de conectarse con éxito, vaya a **Bookmark > New Bookmark** (o pulse `Cmd+Shift+B` en Mac). 2. 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 ```bash 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`: ```bash 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** ```bash sftp> cd htdocs/wp-content/themes sftp> get my-theme.zip ``` **Ejemplo: subir un archivo** ```bash 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. > **Note:** 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](mailto: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](mailto: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. --- ## Artículos relacionados - [Cómo añadir claves SSH a su sitio](https://support.kapsulehost.com/es-es/adding-ssh-keys) - [Uso del gestor de archivos en KPanel](https://support.kapsulehost.com/es-es/file-manager) - [Conexión a su base de datos mediante un túnel SSH](https://support.kapsulehost.com/es-es/database-ssh-tunnel)