Cómo agregar un dominio a cPanel: Guía técnica completa

Agregar un dominio a cPanel significa registrar un nombre de dominio adicional dentro de su panel de control de alojamiento para que el servidor sepa dónde enrutar las solicitudes entrantes y desde dónde servir los archivos. En cPanel, esto se gestiona a través de la interfaz Domains o Addon Domains, que crea un directorio raíz de documentos dedicado, configura la entrada de host virtual y, opcionalmente, configura un subdominio para la gestión interna, todo en un único flujo de trabajo.

Esta guía cubre cada paso de ese proceso en profundidad técnica: desde los requisitos previos de DNS y la configuración del dominio dentro de cPanel, pasando por la implementación de archivos a través del Administrador de archivos, hasta el aprovisionamiento de bases de datos MySQL. Se aplica directamente a cualquier entorno de VPS con cPanel, incluidas las instancias VPS de AlexHost que ejecutan LiteSpeed y almacenamiento NVMe.

Requisitos previos antes de agregar un dominio en cPanel

Omitir el paso de DNS es la razón más común por la que un dominio recién agregado no se resuelve. Antes de tocar cPanel, confirme lo siguiente:

• La propagación de DNS está en curso o completada. El registro A de su dominio debe apuntar a la dirección IP pública del servidor. La propagación generalmente tarda entre 15 minutos y 48 horas dependiendo del registrador y los valores TTL.
• Su cuenta de cPanel tiene espacios de dominio addon disponibles. En un VPS con acceso root y WHM, esto se controla por cuenta en “Modify an Account”. En planes compartidos, depende del paquete de alojamiento.
• Usted es propietario o controla el dominio. Si lo registró en otro lugar, necesita acceso al panel de gestión de DNS del registrador. Si necesita un nuevo dominio, el registro de dominios a través de AlexHost mantiene la gestión de DNS centralizada.
• SSL está planificado desde el principio. Agregar el dominio primero y luego solicitar un certificado es el orden correcto. AutoSSL en cPanel intentará la emisión automáticamente una vez que el dominio se resuelva en el servidor.

Paso 1: Agregar el dominio dentro de cPanel

Inicie sesión en su cuenta de cPanel (normalmente en yourdomain.com:2083 o a través del enlace “Go to cPanel” de WHM).

Navegación a la interfaz de gestión de dominios

En el tema moderno Jupiter de cPanel, el flujo de trabajo de gestión de dominios ha sido consolidado:

1. Desde la pantalla de inicio de cPanel, localice la sección Domains.
2. Haga clic en Domains (la interfaz unificada introducida en cPanel 76+, que reemplaza los iconos separados más antiguos de “Addon Domains”, “Subdomains” y “Aliases”).
3. Haga clic en el botón Create A New Domain en la esquina superior derecha.

Configuración de la nueva entrada de dominio

Verá un formulario con los siguientes campos:

• Domain: Ingrese el nombre de dominio completamente calificado, por ejemplo example.com. No incluya www — cPanel gestiona el alias de subdominio www automáticamente.
• Document Root: cPanel rellena automáticamente este campo según el nombre de dominio, resolviendo típicamente a /home/username/public_html/example.com. Puede anular esta ruta, pero el valor predeterminado es adecuado para la mayoría de las implementaciones.
• Casilla de verificación Share document root with main domain: Deje esta casilla sin marcar a menos que desee intencionalmente que este dominio sirva los mismos archivos que su dominio principal. Marcarla es un error común que hace que ambos dominios muestren contenido idéntico.

Haga clic en Submit (o Add Domain dependiendo de su versión de cPanel). cPanel:

• Creará el directorio raíz de documentos.
• Escribirá un nuevo bloque de configuración de host virtual Apache o LiteSpeed.
• Creará una entrada de subdominio (p. ej., example.com.yourmainaccount.com) para el enrutamiento interno.
• Agregará el dominio a la cola SSL/TLS si AutoSSL está habilitado.

Verificación de que el dominio se agregó correctamente

Después del envío, regrese a la lista de Domains. La nueva entrada debería aparecer con su ruta de raíz de documentos y una opción para gestionar DNS. Si está utilizando los servidores de nombres integrados de cPanel, haga clic en Manage junto al dominio para inspeccionar la zona DNS y confirmar que el registro A apunta a la IP correcta.

Paso 2: Subir archivos del sitio web a través del Administrador de archivos

Con el dominio configurado, el servidor está listo para servir contenido desde la raíz de documentos. El siguiente paso es implementar los archivos de su sitio web.

Acceso al Administrador de archivos

1. Desde la pantalla de inicio de cPanel, abra File Manager en la sección Files.
2. En el árbol de directorios del lado izquierdo, navegue a public_html/ y luego a la carpeta con el nombre de su dominio (p. ej., example.com/).
3. Alternativamente, File Manager se abre en public_html de forma predeterminada — puede navegar desde allí.

Subir archivos como archivo comprimido

El Administrador de archivos de cPanel impone un método de carga que requiere que los archivos estén empaquetados en un formato de archivo comprimido. Subir archivos individuales uno por uno es lento y, en muchas configuraciones de servidor, está restringido por razones de rendimiento.

Formatos de archivo comprimido compatibles para extracción:

• .zip
• .tar.gz / .tgz
• .tar.bz2
• .gz

El procedimiento de carga correcto:

1. Comprima los archivos de su sitio web localmente en un archivo .zip. Para una instalación de WordPress, esto significa comprimir el contenido completo del directorio del sitio (no la carpeta en sí, a menos que desee un nivel de subdirectorio adicional).
2. Dentro del Administrador de archivos, navegue a la carpeta raíz de documentos de su dominio.
3. Haga clic en Upload en la barra de herramientas superior.
4. Seleccione su archivo comprimido y espere a que se complete la carga. El Administrador de archivos muestra un indicador de progreso.
5. Una vez finalizada la carga, haga clic en Go Back to el directorio.
6. Haga clic derecho en el archivo comprimido cargado y seleccione Extract. Confirme que la ruta de extracción es el directorio actual.
7. Elimine el archivo comprimido después de la extracción para mantener limpia la raíz de documentos.

Detalle crítico: Si su archivo comprimido contiene una carpeta de nivel superior (p. ej., mysite/index.php en lugar de index.php en la raíz), su sitio se servirá desde example.com/mysite/ en lugar de example.com/. Verifique siempre la estructura de directorios después de la extracción. Mueva los archivos un nivel hacia arriba usando la función Move del Administrador de archivos si es necesario.

Alternativa: Implementación a través de SFTP

Para sitios más grandes o implementaciones automatizadas, SFTP es significativamente más eficiente que el Administrador de archivos. Use un cliente SFTP (FileZilla, WinSCP, o sftp en la línea de comandos) con los siguientes parámetros:

• Host: La dirección IP o nombre de host de su servidor
• Port: 22 (SSH/SFTP)
• Username: El nombre de usuario de su cuenta de cPanel
• Authentication: Contraseña o par de claves SSH

Navegue directamente a /home/username/public_html/example.com/ y transfiera los archivos. Este método omite el requisito de archivo comprimido y admite transferencias reanudables.

Paso 3: Crear una base de datos MySQL para su sitio web

La mayoría de las plataformas CMS — WordPress, Joomla, Drupal, Magento — requieren una base de datos relacional. cPanel proporciona dos herramientas para esto: MySQL Databases (control manual y granular) y MySQL Database Wizard (guiado, paso a paso). Para configuraciones sencillas, el Asistente es más rápido.

Uso del asistente de base de datos MySQL

1. Desde el inicio de cPanel, navegue a Databases > MySQL Database Wizard.
2. Paso 1 — Crear una base de datos: Ingrese un nombre para la base de datos. cPanel antepone automáticamente el nombre de usuario de su cuenta (p. ej., username_dbname). Anote este nombre completo — lo necesitará durante la instalación del CMS.
3. Paso 2 — Crear un usuario de base de datos: Ingrese un nombre de usuario y una contraseña segura. Use el Password Generator de cPanel para crear una contraseña criptográficamente segura. El nombre de usuario completo también tendrá un prefijo (p. ej., username_dbuser).
4. Paso 3 — Agregar usuario a la base de datos: Seleccione el usuario que acaba de crear y asigne privilegios. Para un CMS estándar, otorgue All Privileges. Haga clic en Next Step.
5. El Asistente confirma la base de datos, el usuario y la asignación de privilegios. Registre los tres valores: nombre de la base de datos, nombre de usuario y contraseña.

Uso de MySQL Databases (Avanzado)

Para entornos que requieren múltiples usuarios con diferentes niveles de privilegios, o cuando se gestionan varias bases de datos por dominio:

1. Vaya a Databases > MySQL Databases.
2. Cree la base de datos en Create New Database.
3. Desplácese hacia abajo hasta Add New User y cree el usuario con una contraseña segura.
4. En Add User to Database, seleccione el usuario y la base de datos, luego defina privilegios granulares (SELECT, INSERT, UPDATE, DELETE, etc.) en lugar de ALL PRIVILEGES de forma general.

Nota de seguridad: Nunca use el mismo usuario de base de datos en múltiples sitios de la misma cuenta. Si un sitio se ve comprometido, las credenciales de base de datos aisladas limitan el movimiento lateral hacia otras bases de datos.

Valor del host de la base de datos

Al configurar su instalador de CMS, el host de la base de datos es casi siempre localhost en un VPS de cPanel estándar. Esto se debe a que el servidor MySQL se ejecuta en la misma máquina y escucha en el socket local. Usar 127.0.0.1 también funciona, pero fuerza TCP en lugar del socket Unix, añadiendo una pequeña sobrecarga.

Paso 4: Configurar SSL para el nuevo dominio

Un dominio sin HTTPS será marcado por los navegadores y penalizado en los rankings de búsqueda. La función AutoSSL de cPanel (impulsada por Let’s Encrypt o Sectigo según la configuración del servidor) gestiona la emisión de certificados automáticamente una vez que el dominio se resuelve correctamente.

Verificación de la cobertura de AutoSSL

1. Navegue a Security > SSL/TLS Status.
2. Su nuevo dominio debería aparecer en la lista. Si AutoSSL ya se ha ejecutado, mostrará un candado verde y la fecha de vencimiento.
3. Si el dominio aparece como pendiente o fallido, haga clic en Run AutoSSL para activar un intento inmediato.

Razones comunes de fallo de AutoSSL:

• El registro A del dominio aún no apunta al servidor (DNS no propagado).
• Un registro DNS CAA en el dominio restringe la emisión a una CA diferente.
• El dominio está detrás de un proxy (p. ej., Cloudflare orange-cloud) que intercepta el desafío ACME HTTP-01.

Para dominios que requieren validación extendida o cobertura wildcard más allá de lo que proporciona AutoSSL, puede instalar un certificado SSL de terceros manualmente a través del SSL/TLS Manager de cPanel.

Addon Domains vs. Subdominios vs. Parked Domains: Diferencias clave

Comprender qué tipo de dominio agregar evita configuraciones incorrectas y tiempo de solución de problemas desperdiciado.

La interfaz moderna Domains de cPanel consolida estos en una sola pantalla, pero el comportamiento subyacente sigue siendo distinto. Cuando agrega un dominio y deja “Share document root” sin marcar, está creando lo que históricamente se llamaba un Addon Domain.

Problemas comunes y cómo resolverlos

El dominio muestra “Index of /” (Listado de directorio)

Esto significa que la raíz de documentos está vacía o carece de un archivo index.php / index.html. O sus archivos no se cargaron, o se extrajeron en un subdirectorio. Verifique la estructura de archivos en el Administrador de archivos.

Error 500 Internal Server Error después de la carga

Generalmente causado por permisos de archivo incorrectos o un archivo .htaccess malformado. Verifique que los directorios estén configurados en 755 y los archivos en 644. En el Administrador de archivos, haga clic derecho en cualquier archivo o carpeta y seleccione Change Permissions.

Error de conexión a la base de datos durante la instalación del CMS

Verifique que está usando el nombre completo de la base de datos y el nombre de usuario con prefijo (p. ej., username_dbname, no solo dbname). Confirme que la contraseña no tiene caracteres especiales que puedan ser malinterpretados por el analizador de configuración del CMS — o encierre el valor entre comillas en el archivo de configuración.

El dominio resuelve al sitio incorrecto

Si dos dominios en la misma cuenta resuelven al mismo contenido, la raíz de documentos se compartió accidentalmente durante la configuración. Vaya a Domains, edite la entrada y corrija la ruta de la raíz de documentos al directorio dedicado.

Escalando más allá de una sola cuenta de cPanel

Cuando supera una sola cuenta de cPanel — ya sea en términos de número de dominios, volumen de tráfico o requisitos de aislamiento de recursos — las opciones de arquitectura divergen:

• Múltiples cuentas de cPanel en un VPS a través de WHM: Cada cuenta tiene sus propios límites de recursos, raíces de documentos y usuarios de base de datos. Ideal para agencias que gestionan sitios de clientes.
• Servidor dedicado con WHM/cPanel: Aislamiento completo de hardware, sin efectos de vecino ruidoso, y la capacidad de personalizar la configuración de LiteSpeed o Apache a nivel de servidor. Los servidores dedicados de AlexHost admiten acceso root completo a WHM.
• Múltiples instancias VPS: Cada VPS ejecuta un entorno de cPanel independiente. Útil cuando los sitios tienen diferentes requisitos de seguridad o cumplimiento.

Para la mayoría de las implementaciones pequeñas y medianas, una sola cuenta de VPS Hosting con cPanel que aloja 5–20 dominios es la arquitectura más rentable. El almacenamiento NVMe garantiza que incluso las operaciones de alta E/S como las consultas de base de datos y el almacenamiento en caché de opcodes PHP sigan siendo rápidas en todos los dominios alojados.

Lista de verificación técnica de puntos clave

Antes de considerar un dominio completamente operativo en cPanel, verifique cada elemento:

• El registro A de DNS apunta a la IP correcta del servidor y se ha propagado (verifique con dig example.com A o un verificador de DNS en línea).
• La raíz de documentos es un directorio dedicado, no compartido con el dominio principal.
• Los archivos están extraídos en el nivel de directorio correcto — index.php debe estar directamente dentro de la raíz de documentos, no dentro de un subdirectorio.
• Los permisos de archivo están configurados en 755 para directorios y 644 para archivos.
• Las credenciales de la base de datos (nombre completo con prefijo, nombre de usuario, contraseña, host localhost) están registradas y probadas.
• El certificado SSL está activo y cubre tanto example.com como www.example.com.
• La renovación de AutoSSL o del certificado manual está confirmada — los certificados de Let’s Encrypt vencen cada 90 días.
• .htaccess contiene una regla de redirección HTTPS válida si desea aplicar SSL.
• El alojamiento de correo electrónico para el nuevo dominio está configurado si es necesario — la sección Email Accounts de cPanel, o una solución de alojamiento de correo electrónico dedicada si necesita funciones avanzadas de entregabilidad.

Preguntas frecuentes

¿Agregar un dominio en cPanel configura automáticamente el DNS?

Solo si su dominio usa los servidores de nombres de cPanel. Si el dominio está registrado en otro lugar y usa servidores de nombres externos, debe agregar manualmente el registro A en su registrador o proveedor de DNS apuntando a la IP de su servidor. cPanel crea el archivo de zona internamente, pero los resolutores externos no lo usarán a menos que el dominio delegue a los servidores de nombres de cPanel.

¿Cuántos dominios puedo agregar a una sola cuenta de cPanel?

El límite se establece en WHM bajo la configuración de la cuenta. En un VPS con acceso root, puede configurarlo como ilimitado. En planes de alojamiento compartido gestionado, el límite depende del nivel del paquete. No hay un límite técnico fijo en cPanel en sí — el límite práctico es la capacidad de recursos del servidor.

¿Cuál es la diferencia entre el asistente de base de datos MySQL y MySQL Databases en cPanel?

El Asistente le guía a través de la creación de la base de datos, la creación del usuario y la asignación de privilegios en un flujo lineal de tres pasos — ideal para configuraciones rápidas. La interfaz MySQL Databases le brinda control granular sobre múltiples usuarios, asignaciones de privilegios individuales y herramientas de reparación/optimización de bases de datos. Para entornos de producción con requisitos de seguridad, use la interfaz manual.

¿Por qué mi dominio muestra una página predeterminada de cPanel después de ser agregado?

La página predeterminada de cPanel (cgi-sys/defaultwebpage.cgi) aparece cuando la raíz de documentos está vacía. Cargue y extraiga los archivos de su sitio, o coloque un archivo index.html en la raíz de documentos para reemplazarla inmediatamente.

¿Puedo agregar un dominio a cPanel sin acceso root al servidor?

Sí. Las cuentas de usuario estándar de cPanel (sin root) pueden agregar dominios hasta el límite establecido por el proveedor de alojamiento. El acceso root solo es necesario para cambiar los límites a nivel de cuenta, instalar software a nivel de servidor o modificar configuraciones fuera del directorio de inicio del usuario de cPanel.