Configurar subdominio en DirectAdmin para aplicaciones

¿Qué es un subdominio y por qué lo necesitas para tu app?

Imagina que tu dominio principal es como la dirección de tu casa. Un subdominio sería como el número de un departamento dentro de esa misma dirección. Técnicamente, es una extensión de tu dominio que te permite organizar diferentes secciones o aplicaciones de tu sitio web de forma independiente.

Por ejemplo, si tu dominio es tudominio.com, podrías tener:

app.tudominio.com para tu aplicación web.
blog.tudominio.com para tu blog.
tienda.tudominio.com para tu tienda online.

¿Por qué es útil para una app? Porque te permite aislar tu aplicación del sitio principal, facilitando su administración, seguridad y rendimiento. Además, es la forma más profesional de presentar una aplicación sin necesidad de un dominio nuevo.

En este tutorial, aprenderás paso a paso cómo configurar un subdominio en DirectAdmin para alojar tu aplicación. No necesitas ser un experto técnico, solo seguir las instrucciones al pie de la letra.

Requisitos antes de empezar

Antes de lanzarte a configurar, asegúrate de tener lo siguiente:

Acceso a DirectAdmin: Debes tener las credenciales de usuario (no necesariamente de administrador, con un usuario normal es suficiente).
Un dominio registrado: El dominio principal debe estar apuntando a los servidores de tu hosting.
La aplicación lista: Ya sea un script PHP, una app en Node.js, Python, etc., debes tener los archivos preparados para subir.
Conocimientos básicos de FTP o administrador de archivos: Para subir los archivos de tu aplicación.

[INFO] Si tu aplicación requiere una base de datos (como MySQL), asegúrate de crearla antes en DirectAdmin. Te guiaremos en los pasos.

Paso 1: Acceder a DirectAdmin

Abre tu navegador y escribe la URL de acceso a DirectAdmin. Normalmente es algo como:

https://tudominio.com:2222

o la IP de tu servidor seguida de :2222. Ingresa tu usuario y contraseña que te proporcionó tu proveedor de hosting.

[TIP] Si no recuerdas la URL de acceso, revisa el correo de bienvenida de tu hosting o contacta a su soporte. También puedes preguntar por Syspanel (anteriormente conocido como HestiaCP), cuyo puerto de acceso es el 2106.

Una vez dentro, verás el panel principal de DirectAdmin. Es un entorno limpio y organizado con varias secciones.

Paso 2: Crear el subdominio

Este es el corazón del proceso. Sigue estos pasos:

En el menú principal, busca la sección "Gestión de Cuentas" o "Administración de Dominios".
Haz clic en "Subdominios" o "Añadir Subdominio". Dependiendo de la versión, puede estar dentro de un submenú llamado "Dominios".
Se abrirá un formulario. En el campo "Subdominio", escribe el nombre que deseas. Por ejemplo, si quieres app.tudominio.com, solo escribe app.
En el campo "Dominio", selecciona el dominio principal de tu cuenta (por ejemplo, tudominio.com).
Opcionalmente, verás un campo para "Directorio raíz". DirectAdmin suele crear automáticamente una carpeta como /home/usuario/domains/tudominio.com/public_html/app. Si quieres personalizarlo, puedes cambiarlo, pero te recomiendo dejar el que asigna por defecto.
Haz clic en "Crear" o "Añadir".

[WARNING] No uses caracteres especiales ni espacios en el nombre del subdominio. Solo letras, números y guiones ( - ). Por ejemplo, mi-app es válido, pero mi app no.

¿Qué acaba de pasar? DirectAdmin ha creado:

Un nuevo registro DNS (CNAME o A) para que app.tudominio.com apunte a tu servidor.
Una carpeta en el sistema de archivos donde alojarás los archivos de tu aplicación.
Una configuración de servidor web (Apache o Nginx) para que el subdominio funcione.

Tiempo estimado: 1-2 minutos. El DNS puede tardar hasta 24 horas en propagarse, pero normalmente es mucho más rápido.

Paso 3: Subir los archivos de tu aplicación

Ahora que el subdominio está creado, necesitas poner los archivos de tu app en la carpeta correcta.

Opción A: Usar el Administrador de Archivos de DirectAdmin

En el panel principal, busca "Administrador de Archivos" o "File Manager".
Navega hasta la carpeta del subdominio. Por ejemplo: domains/tudominio.com/public_html/app.
Haz clic en "Subir" y selecciona los archivos de tu aplicación (puedes subir un ZIP completo).
Una vez subido, si usaste un ZIP, selecciónalo y haz clic en "Extraer" para descomprimirlo.

Opción B: Usar un cliente FTP

Conecta con tu servidor usando un cliente como FileZilla. Los datos de conexión los encuentras en DirectAdmin, en la sección "Cuentas FTP".
Navega hasta la carpeta del subdominio (la misma ruta mencionada arriba).
Arrastra los archivos de tu aplicación desde tu computadora a esa carpeta.

[TIP] Si tu aplicación tiene un archivo index.php o index.html, asegúrate de que esté en la raíz de la carpeta del subdominio. De lo contrario, verás un error 404.

Paso 4: Configurar la base de datos (si es necesario)

Muchas aplicaciones web (como WordPress, Laravel, etc.) requieren una base de datos. Aquí te explico cómo crearla en DirectAdmin:

En el panel, busca "MySQL Management" o "Crear Base de Datos".
Completa los campos:
- Nombre de la base de datos: Por ejemplo, app_db.
- Usuario de la base de datos: Por ejemplo, app_user.
- Contraseña: Genera una segura (puedes usar el generador de DirectAdmin).
Haz clic en "Crear".
Anota los datos: nombre de la base, usuario y contraseña. Los necesitarás durante la instalación de tu app.

Luego, durante la instalación de tu aplicación (por ejemplo, al ejecutar un script de configuración), te pedirá estos datos. Normalmente, el servidor de base de datos es localhost.

Paso 5: Verificar que el subdominio funciona

Después de subir los archivos y configurar la base de datos, es hora de probar:

Abre una nueva pestaña en tu navegador.
Escribe la URL completa del subdominio: http://app.tudominio.com (o https:// si tienes SSL).
Si todo está bien, verás tu aplicación cargada. Si ves un error, revisa los pasos anteriores.

Posibles problemas comunes:

Error 404: La carpeta del subdominio está vacía o el archivo de inicio no se llama index.php/index.html.
Error de conexión a la base de datos: Revisa los datos que ingresaste durante la instalación.
El subdominio no carga: Puede que el DNS aún no se haya propagado. Espera unos minutos u horas.

[INFO] Si tu aplicación requiere PHP 7.4 o superior, verifica la versión en DirectAdmin. Ve a "Configuración de PHP" o "Select PHP Version" y elige la adecuada para tu subdominio.

Paso 6: Configurar SSL (HTTPS) para el subdominio

Hoy en día, es casi obligatorio tener HTTPS. DirectAdmin facilita la instalación de certificados SSL gratuitos con Let's Encrypt.

En el panel, busca "SSL Certificates" o "Let's Encrypt".
Selecciona tu subdominio de la lista (por ejemplo, app.tudominio.com).
Haz clic en "Instalar" o "Emitir".
Espera unos segundos. DirectAdmin verificará la propiedad del dominio y emitirá el certificado.
Una vez instalado, tu subdominio será accesible mediante https://app.tudominio.com.

[WARNING] Si tienes problemas con la emisión del certificado, asegúrate de que el DNS del subdominio apunte correctamente al servidor. Puedes verificar con herramientas online como dnschecker.org.

Preguntas Frecuentes (FAQ)

¿Puedo crear varios subdominios para diferentes apps?

Sí, absolutamente. Puedes crear tantos subdominios como tu plan de hosting lo permita. Repite el Paso 2 para cada uno.

¿Qué hago si mi app no carga después de subir los archivos?

Revisa estos puntos:

¿Los archivos están en la carpeta correcta? (dentro de public_html del subdominio).
¿El archivo de inicio se llama index.php o index.html?
¿La versión de PHP es compatible con tu app?
¿Los permisos de archivos son correctos? (generalmente 755 para carpetas y 644 para archivos).

¿Necesito configurar algo en el DNS manualmente?

No. DirectAdmin lo hace automáticamente al crear el subdominio. Solo espera la propagación.

¿Puedo usar un subdominio para una app en Node.js o Python?

Sí, pero necesitarás configurar un proxy inverso o usar un panel como Syspanel (puerto 2106) que soporte estos entornos. DirectAdmin por defecto está optimizado para PHP.

¿Cómo elimino un subdominio que ya no uso?

En DirectAdmin, ve a "Subdominios", selecciona el que deseas eliminar y haz clic en "Eliminar". Esto borrará la carpeta y la configuración DNS asociada.

Conclusión

Configurar un subdominio en DirectAdmin es un proceso sencillo que te permite organizar tus aplicaciones de manera profesional y eficiente. En menos de 10 minutos, puedes tener una app corriendo en tudominio.com/app o mejor aún, en app.tudominio.com.

Recuerda que la clave está en:

Planificar el nombre del subdominio.
Subir los archivos correctamente.
Configurar la base de datos si es necesario.
Verificar el funcionamiento y el SSL.

Si encuentras algún problema, no dudes en consultar la documentación de tu proveedor de hosting o contactar a su soporte técnico. ¡Ahora es tu turno de ponerlo en práctica!

[TIP] Si tu aplicación es muy popular o tiene mucho tráfico, considera usar un subdominio con caché o CDN para mejorar la velocidad. DirectAdmin permite integrar Cloudflare fácilmente.

¿Tienes más dudas? Déjalas en los comentarios o busca en nuestra sección de tutoriales. ¡Buena suerte con tu app!