Configurar subdominio en Syspanel para aplicaciones | Tutorial

¿Quieres montar una aplicación web, un blog con WordPress, o un proyecto propio en tu servidor, pero no quieres mezclarlo con tu web principal? La solución es tan sencilla como crear un subdominio. En Syspanel, gestionar esto es pan comido. Te voy a guiar paso a paso para que configures un subdominio para tu aplicación, sin complicaciones y con todos los trucos para que funcione a la perfección.

¿Qué es un subdominio y por qué usarlo?

Imagina que tu dominio principal es tudominio.com. Un subdominio es como una extensión de ese dominio, pero que apunta a una sección o aplicación diferente. Por ejemplo, app.tudominio.com, blog.tudominio.com o tienda.tudominio.com.

Ventajas de usar subdominios:

Organización: Separas claramente tu web principal de otras aplicaciones (foros, tiendas, herramientas).
Rendimiento: Puedes instalar la aplicación en un directorio específico, evitando conflictos con otros archivos.
Seguridad: Aísla posibles vulnerabilidades de una aplicación del resto de tu sitio.
SEO amigable: Los buscadores entienden que app.tudominio.com es un sitio independiente, pero relacionado con tu marca.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente:

Acceso a Syspanel: Debes poder iniciar sesión en tu panel de control. Normalmente, la dirección es https://tudominio.com:2106 o https://tu-ip:2106. Usa tu usuario y contraseña de administrador.
Un dominio registrado: El dominio principal (ej. tudominio.com) debe estar apuntando a tu servidor (los DNS configurados correctamente).
La aplicación lista: Ten a mano los archivos de tu aplicación (WordPress, Laravel, una app PHP simple, etc.) o al menos saber qué quieres instalar.

[INFO] Syspanel es una herramienta muy potente. Si es tu primera vez, te recomiendo que primero crees un subdominio de prueba para familiarizarte.

Paso 1: Acceder a Syspanel y crear el subdominio

Lo primero es iniciar sesión en tu panel Syspanel. Una vez dentro, busca la sección que se encarga de los dominios. Normalmente está en el menú lateral izquierdo, con un icono de un mundo o un candado.

### Localizando la opción correcta

En el menú lateral, haz clic en WEB.
Se desplegarán varias opciones. Busca Dominios o Añadir dominio. En algunas versiones, esta opción puede llamarse Añadir un nuevo dominio o Crear dominio.

### Rellenando los datos del subdominio

Haz clic en el botón Añadir dominio (o el que corresponda). Se abrirá un formulario. Aquí tienes que ser muy preciso:

Nombre del dominio: Escribe el subdominio completo. Por ejemplo, si quieres que tu aplicación esté en app.midominio.com, escribe exactamente app.midominio.com. No olvides el punto entre el subdominio y el dominio principal.
IP del servidor: Normalmente, Syspanel ya la rellena automáticamente con la IP de tu servidor. Si no, déjala en blanco o pon la IP que aparece en la configuración de tu servidor.
Directorio raíz (Document Root): Esta es la parte más importante. Aquí defines dónde se almacenarán los archivos de tu aplicación. Por defecto, Syspanel sugiere algo como /home/usuario/web/app.midominio.com/public_html. Te recomiendo que no lo cambies a menos que sepas lo que haces. Si lo haces, asegúrate de que la carpeta exista.
Habilitar SSL: Marca esta casilla si quieres que tu subdominio funcione con HTTPS (muy recomendable). Syspanel te permitirá instalar un certificado SSL gratuito de Let's Encrypt más adelante.
Crear base de datos: Si tu aplicación necesita base de datos (como WordPress o Laravel), marca esta opción. Syspanel te pedirá que crees un usuario y contraseña para la base de datos. Anótalos, los necesitarás.

[TIP] Si no estás seguro de si tu aplicación necesita base de datos, busca en su documentación. La mayoría de las aplicaciones web modernas sí la requieren.

Una vez relleno el formulario, haz clic en Guardar o Crear. Syspanel empezará a trabajar: creará la carpeta, configurará el servidor web (Apache o Nginx) y, si marcaste la opción, creará la base de datos.

Paso 2: Configurar los DNS (lo más importante)

Aquí es donde muchos se pierden. Syspanel ha creado el subdominio en el servidor, pero el mundo no sabe que existe. Necesitas decirle a Internet que app.midominio.com vive en tu servidor. Esto se hace a través de los registros DNS.

### ¿Dónde gestionas tus DNS?

Hay dos opciones comunes:

Opción A: DNS gestionados por Syspanel. Si tu dominio usa los nameservers de Syspanel (ej. ns1.syspanel.com, ns2.syspanel.com), entonces puedes añadir el registro directamente desde el panel. Busca la sección DNS o Registros DNS en Syspanel.
Opción B: DNS externos (tu proveedor de dominio). Si tu dominio usa los nameservers de tu registrador (ej. GoDaddy, Namecheap, DonDominio), entonces debes añadir el registro desde el panel de control de tu proveedor.

### Creando el registro A (o CNAME)

Necesitas un registro A (o un CNAME si el subdominio apunta a otro dominio). Para una aplicación, lo más común es un registro A.

Nombre: Escribe solo la parte del subdominio, sin el dominio principal. Por ejemplo, para app.midominio.com, escribe app.
Tipo: Selecciona A.
Valor: La dirección IP de tu servidor. Puedes encontrarla en Syspanel, en la sección Servidor o Configuración, o preguntando a tu proveedor de hosting.
TTL: Déjalo en Automático o 3600 (una hora). Es el tiempo que tardarán los cambios en propagarse.

Guarda el registro. La propagación de DNS puede tardar desde unos minutos hasta 24 horas, aunque normalmente es rápida (menos de una hora).

[WARNING] No intentes acceder a tu subdominio inmediatamente después de crear el registro DNS. Dale tiempo a que se propague. Puedes usar herramientas como whatsmydns.net para verificar si ya es accesible desde diferentes partes del mundo.

Paso 3: Instalar tu aplicación en el subdominio

Una vez que los DNS se han propagado y tu subdominio es accesible (aunque muestre una página en blanco o un error 403), es hora de instalar tu aplicación.

### Subiendo los archivos

Conéctate a tu servidor usando un cliente FTP (como FileZilla) o el gestor de archivos de Syspanel (si está disponible).
Navega hasta el directorio raíz que configuraste en el Paso 1. Por ejemplo: /home/usuario/web/app.midominio.com/public_html.
Sube todos los archivos de tu aplicación a esa carpeta. Si es WordPress, descomprime el zip dentro de esa carpeta.

### Configurando la base de datos (si aplica)

Si tu aplicación necesita base de datos, y marcaste la opción en Syspanel, ya deberías tener una creada. Si no, créala ahora desde el panel (sección Base de datos).

Nombre de la base de datos: Anótalo (suele ser usuario_app o similar).
Usuario de la base de datos: Anótalo.
Contraseña: Anótala.

Durante la instalación de tu aplicación (por ejemplo, el asistente de WordPress), te pedirá estos datos. Introdúcelos.

### Ajustando permisos y configuración

Algunas aplicaciones necesitan permisos de escritura en ciertas carpetas (por ejemplo, wp-content/uploads en WordPress). Puedes configurarlos desde Syspanel o vía FTP (normalmente 755 para carpetas y 644 para archivos).

Además, si tu aplicación tiene un archivo de configuración (como .env en Laravel), asegúrate de que esté correctamente configurado con los datos de la base de datos y la URL del subdominio (ej. https://app.midominio.com).

Paso 4: Habilitar SSL (HTTPS) para tu subdominio

Es fundamental que tu subdominio funcione con HTTPS, tanto para la seguridad de los datos como para el SEO. Syspanel facilita mucho esto.

En el panel Syspanel, ve a la sección WEB y busca tu subdominio en la lista.
Haz clic en el icono de SSL o Certificados (normalmente un candado).
Selecciona Let's Encrypt o SSL gratuito.
Marca la opción Forzar HTTPS (para que todo el tráfico se redirija automáticamente a la versión segura).
Haz clic en Guardar o Instalar. Syspanel se encargará de todo.

[INFO] El certificado SSL de Let's Encrypt se renueva automáticamente cada 90 días. Syspanel lo gestiona por ti, así que no te preocupes.

Solución de problemas comunes (FAQ)

### Mi subdominio no carga, da error 404 o 403

Causa 1: Los DNS no se han propagado. Espera unas horas.
Causa 2: El directorio raíz está vacío. Asegúrate de haber subido los archivos de la aplicación.
Causa 3: Permisos incorrectos. Los archivos deben tener permisos 644 y las carpetas 755.
Causa 4: El archivo index.php o index.html no existe en la raíz.

### No puedo acceder a Syspanel (puerto 2106)

Causa 1: El firewall de tu servidor bloquea el puerto 2106. Contacta a tu proveedor de hosting.
Causa 2: Tu IP ha cambiado. Verifica que estás usando la IP correcta.

### El certificado SSL no se instala

Causa: Los DNS no apuntan correctamente al servidor. Asegúrate de que el registro A esté bien configurado y propagado.
Solución: Espera a que los DNS se propaguen y vuelve a intentar la instalación del SSL.

### Mi aplicación no se conecta a la base de datos

Causa: Los datos de la base de datos (nombre, usuario, contraseña) son incorrectos. Revisa el archivo de configuración de tu aplicación.
Causa: La base de datos no existe o no tiene los permisos adecuados. Verifica desde Syspanel.

Conclusión

Configurar un subdominio para una aplicación en Syspanel es un proceso sencillo que se resume en tres pasos: crear el subdominio en el panel, configurar los DNS (el paso más crítico) e instalar la aplicación. Con un poco de paciencia y siguiendo esta guía, tendrás tu aplicación funcionando en su propio espacio, limpia y organizada.

Recuerda que Syspanel es una herramienta muy potente, pero si te surge cualquier duda, no dudes en consultar la documentación oficial o contactar con el soporte de tu hosting. ¡Ahora ya puedes lanzar ese proyecto que tenías en mente!