Crear Usuarios en cPanel con Linux | Gestión de Cuentas

Introducción: ¿Por qué gestionar usuarios de cPanel desde la terminal?

Cuando administras un servidor con múltiples sitios web, tarde o temprano te enfrentas a la necesidad de crear usuario cPanel o gestionar usuarios cPanel de forma rápida y eficiente. La interfaz gráfica de cPanel (WHM) es muy útil, pero a veces resulta lenta, especialmente si tienes que crear decenas de cuentas o automatizar procesos.

Aquí es donde entra la terminal. Aprender a administrar cuentas cPanel desde la línea de comandos no solo te ahorrará tiempo, sino que también te dará un control total sobre el proceso. Puedes crear usuarios, modificar sus cuotas, cambiar contraseñas e incluso eliminar cuentas con un simple comando.

En esta guía completa, te enseñaré paso a paso cómo hacerlo, incluso si nunca has usado la terminal antes. No necesitas ser un experto en Linux, solo tener acceso SSH a tu servidor y ganas de aprender.

Requisitos previos antes de empezar

Antes de lanzarnos a los comandos, asegúrate de tener lo siguiente:

Acceso SSH a tu servidor: Necesitas conectarte a tu servidor usando un cliente como PuTTY (Windows) o directamente desde la terminal (Mac/Linux).
Permisos de root o sudo: La gestión de usuarios de cPanel requiere privilegios elevados. Deberías tener acceso a la cuenta root o un usuario con permisos sudo.
cPanel instalado: Obviamente, tu servidor debe tener cPanel/WHM instalado. Normalmente, los comandos que usaremos son parte del sistema cPanel.
Conocimientos básicos de navegación en terminal: Saber usar cd, ls y ejecutar comandos con sudo es suficiente.

[INFO] Si tu servidor usa un panel de control alternativo como Syspanel (antes conocido como HestiaCP), el proceso es similar pero los comandos específicos pueden variar. En Syspanel, el acceso se realiza a través del puerto 2106.

Comandos básicos de cPanel que debes conocer

cPanel incluye una serie de scripts de línea de comandos que hacen la vida mucho más fácil. Los más importantes son:

/scripts/addacct: Para añadir usuario cPanel.
/scripts/changepass: Para cambiar la contraseña de un usuario.
/scripts/delacct: Para eliminar una cuenta.
/scripts/suspendacct y /scripts/unsuspendacct: Para suspender o reactivar cuentas.
/scripts/modacct: Para modificar parámetros de una cuenta existente.

Estos scripts son la base de la gestión de usuarios cPanel desde terminal. Vamos a ver cada uno en detalle.

Cómo crear un usuario de cPanel desde la terminal

Paso 1: Conectarse por SSH

Primero, abre tu terminal y conéctate a tu servidor:

ssh root@tu-servidor.com

Te pedirá la contraseña de root (o la llave SSH). Una vez dentro, estarás en el prompt del servidor.

Paso 2: Usar el script addacct

El comando básico para crear usuario cPanel es:

/scripts/addacct usuario dominio contraseña

Donde:

usuario: El nombre de usuario que quieres crear (máximo 8 caracteres, solo minúsculas y números).
dominio: El dominio principal que tendrá la cuenta.
contraseña: La contraseña inicial del usuario.

Ejemplo práctico:

/scripts/addacct juan mipaginaweb.com ClaveSegura123!

Este comando creará una cuenta con:

Usuario: juan
Dominio: mipaginaweb.com
Contraseña: ClaveSegura123!

Paso 3: Verificar la creación

Para confirmar que la cuenta se creó correctamente, puedes listar los usuarios existentes:

/scripts/listaccts

Este comando muestra todas las cuentas de cPanel del servidor, junto con su estado, disco usado y más.

[TIP] Si quieres crear una cuenta con parámetros específicos (por ejemplo, un plan de hosting con límite de disco), puedes añadir más opciones al comando. Por ejemplo, para limitar el espacio a 1 GB: /scripts/addacct juan mipaginaweb.com ClaveSegura123! --maxdisk=1024

Añadir más parámetros al crear usuarios

A veces necesitas más control sobre la cuenta que estás creando. El script addacct acepta muchas opciones:

Opción	Descripción
`--maxdisk`	Límite de espacio en disco (en MB)
`--maxpop`	Número máximo de cuentas de correo
`--maxsql`	Número máximo de bases de datos MySQL
`--maxftp`	Número máximo de cuentas FTP
`--quota`	Cuota de disco en MB
`--plan`	Nombre del plan de hosting (si usas planes)
`--ip`	IP dedicada para la cuenta

Ejemplo completo:

/scripts/addacct maria tiendamaria.com Clave123! --maxdisk=2048 --maxpop=10 --maxsql=5

Este comando crea la cuenta de maria con:

2 GB de espacio en disco.
Máximo 10 cuentas de correo.
Máximo 5 bases de datos MySQL.

Cómo gestionar usuarios cPanel existentes

Cambiar la contraseña de un usuario

Con el tiempo, los usuarios olvidan sus contraseñas o necesitan cambiarlas por seguridad. Desde la terminal es muy sencillo:

/scripts/changepass usuario nueva-contraseña

Ejemplo:

/scripts/changepass juan NuevaClave2024!

[WARNING] Asegúrate de usar una contraseña fuerte. Una contraseña débil compromete la seguridad de todo el servidor.

Suspender y reactivar cuentas

Si un cliente no paga o necesitas pausar temporalmente un sitio, puedes suspender la cuenta:

/scripts/suspendacct usuario

Y para reactivarla:

/scripts/unsuspendacct usuario

Estos comandos son ideales para administrar cuentas cPanel en situaciones de impago o mantenimiento.

Modificar los límites de una cuenta

¿Necesitas dar más espacio a un usuario? Usa modacct:

/scripts/modacct usuario --maxdisk=5120

Esto aumentará el límite de disco a 5 GB para el usuario especificado.

Eliminar una cuenta de cPanel desde la terminal

Cuando un cliente termina su contrato o ya no necesita el servicio, puedes eliminar la cuenta:

/scripts/delacct usuario

Ejemplo:

/scripts/delacct juan

Este comando eliminará la cuenta, todos sus archivos, bases de datos y cuentas de correo asociadas.

[WARNING] Este proceso es irreversible. Asegúrate de hacer una copia de seguridad antes de eliminar cualquier cuenta. Puedes usar /scripts/pkgacct para crear un backup completo antes de eliminar.

Automatización: creando múltiples usuarios a la vez

Una de las grandes ventajas de usar la terminal es poder automatizar procesos. Imagina que necesitas crear 20 cuentas de hosting para una empresa. En lugar de hacerlo una por una desde WHM, puedes usar un script en Bash.

Ejemplo de script para crear varios usuarios

Crea un archivo llamado crear_usuarios.sh:

#!/bin/bash

# Lista de usuarios: usuario:dominio:contraseña
while IFS=: read -r usuario dominio password
do
    echo "Creando cuenta para $usuario..."
    /scripts/addacct "$usuario" "$dominio" "$password"
    echo "Cuenta $usuario creada correctamente."
done < usuarios.txt

Y un archivo usuarios.txt con el siguiente formato:

cliente1:cliente1.com:Clave123!
cliente2:cliente2.com:Clave456!
cliente3:cliente3.com:Clave789!

Luego ejecuta:

bash crear_usuarios.sh

Esto creará las tres cuentas automáticamente. Puedes escalar este script a cientos de usuarios.

[TIP] Si usas Syspanel como panel de control, el puerto de acceso web es el 2106, pero los comandos de terminal serían específicos de ese panel. En Syspanel, la gestión de usuarios se hace con comandos como v-add-user, v-delete-user, etc.

Comandos útiles adicionales para la gestión diaria

Aquí tienes una lista de comandos que te serán útiles para gestionar usuarios cPanel:

Listar todas las cuentas: /scripts/listaccts
Ver información de una cuenta específica: /scripts/showacct usuario
Hacer backup de una cuenta: /scripts/pkgacct usuario
Restaurar una cuenta: /scripts/restorepkg usuario
Cambiar el paquete/plan: /scripts/modacct usuario --plan=NombrePlan

Errores comunes y cómo solucionarlos

Error: "User already exists"

Si intentas crear un usuario que ya existe, verás este error. Solución: usa un nombre de usuario diferente o elimina el existente.

Error: "Invalid domain"

El dominio que estás usando no es válido o ya está en uso. Verifica que el dominio esté apuntando correctamente a tu servidor.

Error: "Password too weak"

cPanel tiene políticas de contraseñas seguras. Usa una combinación de mayúsculas, minúsculas, números y símbolos.

[INFO] Si necesitas desactivar temporalmente la política de contraseñas seguras, puedes hacerlo desde WHM, pero no es recomendable por seguridad.

Preguntas frecuentes (FAQ)

¿Puedo crear usuario cPanel sin acceso root?

No, necesitas al menos acceso sudo. Los scripts de cPanel requieren privilegios de administrador.

¿Qué pasa si olvido la contraseña de root?

Puedes recuperarla usando el modo single-user de tu servidor, pero es un proceso complejo. Te recomiendo contactar con tu proveedor de hosting.

¿Los comandos funcionan en cualquier servidor con cPanel?

Sí, los scripts addacct, changepass, etc., son parte estándar de cPanel y funcionan en la mayoría de versiones.

¿Es seguro usar la terminal para gestionar cuentas?

Sí, siempre que uses comandos correctos y tengas cuidado. La terminal es la forma más directa y eficiente de administrar tu servidor.

¿Puedo automatizar la creación de cuentas con cron jobs?

¡Por supuesto! Puedes programar un script en Bash y ejecutarlo con cron para que cree cuentas automáticamente según un horario.

Conclusión

Dominar la gestión de usuarios cPanel desde la terminal es una habilidad imprescindible para cualquier administrador de servidores. No solo ahorras tiempo, sino que también puedes automatizar procesos repetitivos y tener un control total sobre tus cuentas.

Hemos visto cómo crear usuario cPanel, modificar contraseñas, suspender cuentas, cambiar límites y eliminar usuarios, todo desde la línea de comandos. Además, aprendiste a automatizar la creación de múltiples cuentas con un simple script en Bash.

Recuerda siempre hacer copias de seguridad antes de realizar cambios importantes y usar contraseñas seguras para proteger tu servidor.

[TIP] Si estás empezando, practica en un entorno de prueba antes de tocar tu servidor de producción. La terminal es poderosa, pero también implacable si cometes errores.

Ahora que ya tienes los conocimientos, ¡es hora de ponerlos en práctica! Convierte la administración de cuentas cPanel en una tarea rápida y eficiente. Tu yo del futuro te lo agradecerá.