Acceso SSH a tu servidor (MiPanel)
Guía completa de SSH en MiPanel
SSH (Secure Shell) es un protocolo que te permite conectarte de forma segura a tu servidor y administrarlo desde la línea de comandos (una ventana de terminal). Con SSH puedes ejecutar comandos directamente en tu hosting: instalar dependencias de tu aplicación, importar bases de datos, gestionar archivos y mucho más.
Desde MiPanel (https://cp.mipanel.cloud) puedes habilitar el acceso SSH de tu paquete en minutos. Esta guía te muestra cómo hacerlo paso a paso, desde Mac o Windows.
¿Qué es SSH?
- SSH (Secure Shell) es un protocolo de red que permite acceder a tu servidor de forma cifrada y segura.
- A diferencia del Administrador de archivos o FTP, con SSH trabajas con comandos escritos en una terminal.
- Se conecta con un usuario y un nombre de host (servidor), por ejemplo:
[email protected]
- El panel te muestra los datos exactos de conexión de tu paquete en la sección Acceso SSH.
¿Por qué es importante?
- Control total: accedes a tu espacio web y ejecutas tareas que no siempre se pueden hacer desde el panel.
- Composer: instalas y actualizas dependencias de PHP (Laravel, Symfony, Magento, etc.).
- Importar bases de datos: restauras archivos
.sqldesde la línea de comandos, incluso comprimidos. - Gestión avanzada: permites, editas y ejecutas procesos, revisas errores y automatizas tareas.
- Mayor velocidad: para tareas repetitivas, la línea de comandos suele ser mucho más rápida.
Nota: SSH está recomendado para quienes están familiarizados con la línea de comandos. Si no lo usas, puedes administrar tu sitio desde el panel y el Administrador de archivos.
Casos de uso
- Instalar dependencias de PHP con Composer (por ejemplo,
composer installen un proyecto Laravel). - Importar una base de datos MySQL desde un archivo
.sql(útil en migraciones o restauraciones). - Gestionar archivos del sitio de forma rápida con comandos.
- Automatizar tareas y procesos que requieren acceso a la terminal.
- Depurar errores revisando el estado de tu aplicación desde el servidor.
Requisitos
- Un paquete de hosting que incluya acceso SSH (Cloud Hosting, Moodle Hosting, WordPress Hosting, etc.).
- Conocimientos básicos de línea de comandos (recomendado).
- Un cliente SSH:
- En Mac y Linux: la aplicación Terminal (ya incluida en el sistema).
- En Windows: PuTTY (gratuito) o la Terminal de Windows.
- Si vas a usar contraseña con doble factor: la app Google Authenticator en tu celular.
Paso a paso: Habilitar SSH en MiPanel
Paso 1: Ingresa a MiPanel
- Abre https://cp.mipanel.cloud.
- Inicia sesión con tu usuario y contraseña.
Paso 2: Ve a la sección Acceso SSH
- En el menú lateral selecciona "Su cuenta" y elige tu servicio.
- En la sección Seguridad, haz clic en "Acceso SSH".
Verás un mensaje similar a este:
"Permitimos la autenticación con claves o contraseña con autenticación de dos factores."
Y la información de conexión de tu paquete, por ejemplo:
[email protected]
Importante: El nombre de host y el usuario que aparecen son los que debes usar para conectarte. Son distintos en cada paquete.
Paso 3: Genera un par de claves SSH
MiPanel usa claves públicas para la autenticación segura. Primero debes generar un par de claves (pública y privada) en tu equipo:
-
En Mac o Linux — abre la Terminal y ejecuta:
ssh-keygenPresiona Enter para aceptar la ubicación predeterminada y deja la passphrase vacía (presiona Enter dos veces). Se creará la clave pública en:
/Users/tu-usuario/.ssh/id_rsa.pub -
En Windows — descarga PuTTY desde https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html y abre PuTTY Key Generator (PuTTYgen). Haz clic en Generate y mueve el mouse dentro del área gris para generar la clave. (Opcional) agrega una passphrase y guarda la clave privada con Save private key.
Paso 4: Agrega la clave pública en el panel
- En la sección Acceso SSH, copia el contenido de tu clave pública (archivo
.pub).- En Mac/Linux:
cat /Users/tu-usuario/.ssh/id_rsa.puby copia todo el texto.
- En Mac/Linux:
- Pega la clave en el campo "Clave pública".
- El panel espera el formato OpenSSH authorized_keys (el que generan
ssh-keygeny PuTTYgen).
- El panel espera el formato OpenSSH authorized_keys (el que generan
- En "Identificador" escribe una referencia para reconocerla (por ejemplo,
mi-mac). Si lo dejas vacío, el panel genera uno automáticamente. - Haz clic en "Agregar clave pública".
Paso 5: Espera la activación
- El servicio SSH tarda hasta 30 minutos en activarse después de agregar la primera clave.
- Después de eso, los cambios de clave son instantáneos.
Puedes administrar tus claves en la sección "Administrar claves públicas", donde las verás listadas y podrás eliminarlas cuando quieras.
Paso 6: Conéctate al servidor
Usa el usuario y el hostname que aparecen en la sección Acceso SSH (por ejemplo, [email protected]):
-
Mac / Linux: escribe el comando completo en la Terminal:
ssh [email protected]Cuando pregunte si deseas continuar, escribe
yesy presiona Enter. -
Windows (PuTTY): abre PuTTY, en Session escribe el hostname y haz clic en Open. Inicia sesión con tu usuario.
Conectarse desde Mac (paso a paso)
- Abre la aplicación Terminal en tu Mac.
- Genera tu clave con
ssh-keygen(si aún no lo hiciste). - Copia tu clave pública con:
cat /Users/tu-usuario/.ssh/id_rsa.pub - Agrégala en MiPanel (Acceso SSH → Clave pública → Agregar clave pública).
- Espera la activación (hasta 30 minutos la primera vez).
- Conéctate con el usuario y hostname de tu paquete:
ssh [email protected] - Escribe
yescuando te pregunte si deseas continuar.
¡Ya estás conectado vía SSH desde tu Mac!
Conectarse desde Windows con PuTTY (paso a paso)
- Descarga PuTTY desde https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html.
- Abre PuTTYgen, haz clic en Generate y mueve el mouse en el área gris.
- (Opcional) agrega una passphrase.
- En MiPanel, agrega la clave pública generada (Acceso SSH → Clave pública → Agregar clave pública).
- En PuTTYgen haz clic en Save private key y guarda la clave privada.
- Abre PuTTY:
- En el menú izquierdo ve a SSH → Auth → Browse y selecciona tu clave privada.
- Regresa a Session, escribe el hostname de tu paquete (por ejemplo,
ssh.gb.stackcp.com) y haz clic en Open.
- Inicia sesión con tu usuario.
- Si configuraste una passphrase, introdúcela cuando la pida.
¡Ya tienes acceso SSH desde Windows!
Conectarse con contraseña y doble factor (2FA)
MiPanel también permite la autenticación con contraseña + autenticación de dos factores (2FA), además de las claves:
- Descarga la app Google Authenticator en tu celular (iOS o Android).
- En la sección Acceso SSH de MiPanel:
- En "Set SSH password" (establecer contraseña SSH), define una contraseña y anótala.
- Haz clic en "Set up Authenticator" (configurar autenticador) y escanea el código QR con Google Authenticator.
- Espera 30 minutos antes de intentar conectar.
- Abre PuTTY (Windows) o la Terminal (Mac/Linux) y conéctate al hostname de tu paquete.
- Inicia sesión con tu usuario.
- Ingresa el código de verificación que muestra Google Authenticator.
- Ingresa la contraseña SSH que configuraste.
¡Conectado con doble factor!
Comandos útiles
Ejecutar Composer con una versión específica de PHP
En MiPanel se ejecutan múltiples versiones de PHP. Al usar el comando composer directamente en SSH, se usa la versión predeterminada del sistema (una versión ligera, sin todos los módulos de tu sitio).
Para ejecutar Composer con la versión de PHP que necesites, especifica la ruta completa del binario. Por ejemplo, con PHP 8.2:
/usr/bin/php82 -f /usr/bin/composer install
Con PHP 8.3:
/usr/bin/php83 -f /usr/bin/composer install
Nota: La lista de versiones de PHP disponibles aparece en el mensaje del día (MOTD) al iniciar sesión por SSH. Las versiones disponibles van de PHP 5.3 a PHP 8.5 según tu paquete.
Importar un archivo .sql
Con acceso SSH configurado, puedes importar una base de datos MySQL:
mysql -h hostname -u username -p username < databasefile.sql
Te pedirá la contraseña del usuario de la base de datos.
Si el archivo está comprimido:
.zip:unzip databasefile.sql.zip mysql -h hostname -u username -p username < databasefile.sql.gz:gunzip databasefile.sql.gz mysql -h hostname -u username -p username < databasefile.sql
¿Puedo usar sudo?
No. El comando sudo no está permitido en el hosting compartido. Su uso se considera una violación de acceso SSH y puede resultar en la suspensión de tu acceso. Esto se indica en el mensaje de bienvenida al conectar. Si usas sudo, la terminal se cerrará de inmediato.
Buenas prácticas de seguridad
- Protege tu clave privada: no la compartas ni la subas a servicios no confiables.
- Usa claves públicas en lugar de contraseñas cuando sea posible: son más seguras.
- Elimina claves que ya no uses desde "Administrar claves públicas".
- No uses
sudo: está prohibido en el hosting compartido. - Mantén tus proyectos actualizados con
composery las versiones de PHP soportadas. - Si usas contraseña + 2FA, usa una contraseña segura y guarda el código QR de respaldo.
Preguntas frecuentes
¿SSH está disponible en todos los paquetes? Está disponible en los paquetes de hosting que lo incluyen (Cloud Hosting, Moodle Hosting, WordPress Hosting, etc.). Puedes verificar en la sección Acceso SSH de tu servicio en MiPanel.
¿Qué datos necesito para conectarme?
El usuario y el nombre de host que aparecen en la sección Acceso SSH de tu paquete (por ejemplo, [email protected]).
¿Cuánto tarda en activarse el acceso SSH? Hasta 30 minutos después de agregar la primera clave pública. Los cambios posteriores de claves son instantáneos.
¿Puedo conectarme con contraseña en lugar de clave? Sí. MiPanel permite la autenticación con contraseña + autenticación de dos factores (2FA) como alternativa a las claves públicas.
¿Qué es el memory_limit de PHP?
Es el máximo de memoria que cada script PHP puede usar (por defecto 128M). Si un script supera el límite, verás un error como "Allowed memory size of x bytes exhausted". Puedes ajustarlo desde la Configuración de PHP de tu paquete.
¿Por qué al usar composer me muestra una versión de PHP distinta a la de mi sitio?
Porque el comando composer se ejecuta con la versión de PHP del sistema, que es ligera. Para usar la versión de tu sitio, especifica la ruta completa del binario (por ejemplo, /usr/bin/php83 -f /usr/bin/composer install).
¿Puedo usar sudo en mi hosting?
No. sudo no está permitido en el hosting compartido y su uso puede suspender tu acceso SSH.
¿Qué hago si no logro conectarme? Verifica que usas el usuario y hostname correctos de tu paquete, que la clave pública está agregada correctamente y que pasaron los 30 minutos de activación. Si sigues sin poder conectar, revisa que tu cliente SSH esté usando la clave privada correcta.