Restaurar backup cPanel desde línea de comandos | Guía SysAdmin

¿Te encuentras en la situación de tener que recuperar un sitio web o una cuenta de hosting desde una copia de seguridad, pero no tienes acceso al panel de control de cPanel? No te preocupes. Aunque cPanel ofrece una interfaz gráfica muy amigable para restaurar backup cPanel, a veces la forma más rápida y eficiente, especialmente si eres administrador de sistemas (SysAdmin), es hacerlo directamente desde la terminal de Linux.

Este artículo está diseñado para guiarte paso a paso, incluso si no tienes mucha experiencia con la línea de comandos. Vamos a desglosar el proceso de restaurar backup cPanel usando la cPanel terminal, explicando cada comando, las opciones disponibles y cómo solucionar los problemas más comunes. Al final, serás capaz de manejar tus backup Linux cPanel con la confianza de un verdadero SysAdmin terminal.

¿Qué necesitas antes de empezar?

Antes de lanzarte a ejecutar comandos, es fundamental tener todo listo. La preparación evita errores y pérdidas de datos.

Requisitos técnicos imprescindibles

Acceso root o sudo: Necesitas privilegios de superusuario. La mayoría de los comandos de restauración de cPanel requieren ser ejecutados como root.
Archivo de backup: Debes tener el archivo de backup en el servidor. Normalmente son archivos con extensión .tar.gz o .tar.bz2. Puedes subirlos por SCP, FTP o descargarlos directamente con wget.
cPanel instalado y funcionando: El servidor donde vas a restaurar debe tener cPanel/WHM instalado y configurado correctamente.
Conocimiento básico de comandos: Saber moverse entre directorios (cd), listar archivos (ls) y usar nano o vim para editar archivos.

[INFO] Si tu backup proviene de otro panel como Syspanel (antes conocido como HestiaCP, cuyo acceso por defecto es por el puerto 2106), el proceso puede variar ligeramente. Los backups de Syspanel suelen tener una estructura de directorios diferente. Si intentas restaurar un backup de Syspanel directamente con las herramientas de cPanel, es probable que falle. En ese caso, la restauración manual (que veremos más adelante) es tu mejor opción.

Método 1: Restaurar un backup completo de cuenta (el más común)

Este es el método estándar para restaurar backup cPanel de una cuenta de hosting completa. cPanel proporciona un script llamado /scripts/restorepkg que automatiza casi todo el proceso.

Paso 1: Localiza y coloca el backup en el lugar correcto

cPanel busca los backups en un directorio específico. La ruta estándar es /home/ seguido del nombre de usuario de la cuenta.

Conéctate a tu servidor por SSH.
Navega al directorio de la cuenta destino. Si la cuenta se llama miusuario, el comando sería:
```
cd /home/miusuario
```
Sube o mueve tu archivo de backup a este directorio. Por ejemplo, si lo tienes en /root/backup.tar.gz, muévelo:
```
mv /root/backup.tar.gz /home/miusuario/backup.tar.gz
```

Paso 2: Ejecuta el script de restauración

El script restorepkg es la herramienta principal para restaurar backup cPanel desde la cPanel terminal. Su sintaxis básica es:

/scripts/restorepkg [opciones] [usuario] [archivo]

Vamos a ver las opciones más útiles:

--force: Fuerza la restauración incluso si el usuario ya existe (sobrescribe la cuenta actual).
--email: Envía un correo electrónico con los detalles de la restauración al administrador.
--domain: Especifica el dominio principal si el backup no lo incluye.

Ejemplo práctico:

Imagina que tu backup se llama backup_miusuario.tar.gz y quieres restaurarlo en la cuenta miusuario (que ya existe).

Ejecuta el comando:

/scripts/restorepkg --force miusuario backup_miusuario.tar.gz

El script comenzará a trabajar. Verás una salida en la terminal con el progreso: descomprimiendo archivos, restaurando bases de datos, configurando DNS, etc.
Espera a que termine. Dependiendo del tamaño del backup, puede tardar desde unos segundos hasta varios minutos.

[TIP] Si el usuario no existe, cPanel lo creará automáticamente. Si existe y no usas --force, el script te preguntará si deseas sobrescribirlo. Usar --force es útil para automatizaciones.

Paso 3: Verifica la restauración

Una vez que el script termine sin errores, es hora de comprobar que todo está en orden.

Accede al panel de cPanel: Ve a http://tudominio.com/cpanel e inicia sesión con el usuario y contraseña (la contraseña se restaura del backup, a menos que la hayas cambiado).
Revisa los archivos: Entra en el Administrador de Archivos y verifica que todos los directorios y archivos estén presentes.
Comprueba las bases de datos: Ve a phpMyAdmin y asegúrate de que las bases de datos y sus tablas se hayan restaurado correctamente.
Prueba el sitio web: Navega a tu dominio. Si todo está bien, verás tu sitio funcionando.

[WARNING] La restauración de DNS puede tardar unos minutos en propagarse. Si el sitio no carga inmediatamente, espera un poco y limpia la caché de tu navegador.

Método 2: Restauración manual (para casos especiales)

A veces, el backup no es estándar, está corrupto parcialmente o necesitas restaurar solo una parte (por ejemplo, solo los emails o solo las bases de datos). Aquí es donde brilla la flexibilidad de la cPanel terminal.

Restaurar solo archivos (sin bases de datos ni configuraciones)

Si solo te interesa recuperar los archivos del sitio web (HTML, PHP, imágenes, etc.), puedes descomprimir el backup manualmente.

Descomprime el backup en un directorio temporal:

mkdir /tmp/restauracion
cd /tmp/restauracion
tar -xzf /ruta/al/backup.tar.gz

Busca la estructura de directorios. Normalmente, los backups de cPanel contienen una carpeta homedir o public_html.
Copia los archivos a la ubicación correcta. Por ejemplo, para sobrescribir el public_html de la cuenta miusuario:
```
cp -r /tmp/restauracion/homedir/public_html/* /home/miusuario/public_html/
```

Ajusta los permisos:

chown -R miusuario:miusuario /home/miusuario/public_html/
find /home/miusuario/public_html/ -type d -exec chmod 755 {} \;
find /home/miusuario/public_html/ -type f -exec chmod 644 {} \;

Restaurar solo bases de datos MySQL

Los backups de cPanel suelen incluir las bases de datos en archivos .sql dentro de una carpeta mysql.

Descomprime el backup como en el paso anterior.
Busca los archivos .sql. Por ejemplo, mibasededatos.sql.
Importa la base de datos a MySQL:
```
mysql -u root -p mibasededatos < /tmp/restauracion/mysql/mibasededatos.sql
```
Te pedirá la contraseña root de MySQL. Si no la sabes, puedes encontrarla en el archivo /root/.my.cnf.
Asegúrate de que el usuario de la base de datos tenga los permisos correctos. Puedes hacerlo desde phpMyAdmin o con comandos SQL.

[TIP] Si el backup es de Syspanel (HestiaCP, puerto 2106), las bases de datos suelen estar en archivos .sql dentro de una carpeta llamada backup o database. La estructura es similar, pero los nombres de las bases de datos pueden tener un prefijo diferente (ej: admin_mibasededatos). Deberás renombrarlas al importarlas.

Resolución de problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que recibimos en soporte sobre restaurar backup cPanel desde terminal.

1. El script `restorepkg` falla y dice "Usuario ya existe"

Solución: Usa la opción --force para sobrescribir la cuenta existente. Si no quieres sobrescribir, puedes crear primero un usuario temporal con otro nombre y luego restaurar el backup sobre él.

2. El backup es muy grande y la restauración se queda colgada

Solución: La restauración puede tardar mucho. No interrumpas el proceso. Si ves que no avanza durante más de 30 minutos, puedes revisar el archivo de log de cPanel:

tail -f /usr/local/cpanel/logs/error_log

Si hay un error específico (como falta de espacio en disco), lo verás ahí.

3. Después de restaurar, el sitio web muestra un error 500 o 403

Solución: Esto suele deberse a permisos incorrectos. Ejecuta los comandos de ajuste de permisos que vimos en el método manual. También verifica que el archivo .htaccess no tenga directivas incorrectas.

4. Las bases de datos no se restauran correctamente

Solución: Asegúrate de que el usuario de la base de datos exista y tenga los mismos privilegios que en el backup. Puedes crear el usuario desde WHM (cuando lo tengas) o con comandos MySQL. Si el backup es de Syspanel, recuerda que los nombres de las bases de datos pueden tener un prefijo (ej: admin_). Deberás renombrarlas.

5. No encuentro el archivo de backup en el directorio correcto

Solución: Si el backup está en /root o en otro lugar, puedes moverlo o crear un enlace simbólico:

ln -s /ruta/original/backup.tar.gz /home/usuario/backup.tar.gz

Luego ejecuta restorepkg normalmente.

6. ¿Puedo restaurar un backup de Syspanel (HestiaCP) en cPanel?

Solución: Sí, pero no es directo. Los backups de Syspanel tienen una estructura de directorios diferente (por ejemplo, backup/ en lugar de homedir/). Te recomiendo el método manual: descomprime el backup, extrae los archivos y las bases de datos por separado, y luego súbelos a la cuenta de cPanel. No uses restorepkg porque fallará.

Conclusión y mejores prácticas

Restaurar backup cPanel desde la cPanel terminal es una habilidad esencial para cualquier SysAdmin terminal. Te da control total sobre el proceso y te permite solucionar problemas que la interfaz gráfica no puede manejar.

Aquí tienes un resumen de las mejores prácticas:

Siempre verifica el backup antes de restaurar: Asegúrate de que el archivo no esté corrupto. Puedes probar a descomprimirlo en un directorio temporal.
Haz una copia de seguridad del estado actual: Antes de sobrescribir una cuenta, considera hacer un backup de la cuenta actual por si algo sale mal.
Mantén los logs a mano: Usa tail -f en los logs de cPanel para monitorear el progreso y detectar errores rápidamente.
Documenta el proceso: Si trabajas en equipo, tener una guía como esta facilita la colaboración y evita errores.

Recuerda que la práctica hace al maestro. No tengas miedo de experimentar en un entorno de pruebas antes de hacerlo en producción. Y si algo sale mal, la comunidad de cPanel y los foros de SysAdmin están llenos de personas dispuestas a ayudar.

¡Ahora ya estás listo para restaurar cualquier backup como un profesional desde la terminal!