Subdominios automáticos en ISPmanager

ISPmanager puede crear automáticamente subdominios para un dominio existente, sin necesidad de editar la configuración manualmente. Un subdominio se activa en el momento en que creas el directorio correspondiente en el lugar correcto.

Habilitar los subdominios automáticos

Ve a Dominios WWW, abre las propiedades del dominio que quieres configurar y, en la sección Subdominios automáticos, selecciona el modo de funcionamiento.

Modo: «Directorio separado»

Cada subdominio tiene su propia carpeta independiente, completamente aislada de los archivos del dominio principal.

Ejemplo:

• El dominio principal example.com se encuentra en www/example.com
• Quieres crear domain.example.com

Coloca los archivos del subdominio aquí:

www/domain.example.com

Modo: «Subdirectorio del dominio WWW»

Los archivos del subdominio se encuentran dentro de la carpeta del dominio principal y son accesibles tanto a través de la URL del subdominio como mediante una ruta del dominio principal.

Ejemplo:

• El dominio principal example.com se encuentra en www/example.com
• Quieres crear domain.example.com

Coloca los archivos del subdominio aquí:

www/example.com/domain

Los mismos archivos también estarán disponibles en example.com/domain.

Cómo funciona internamente

Los subdominios automáticos funcionan gracias al módulo de Apache mod_vhost_alias, que debe estar habilitado en la configuración de ISPmanager. También puedes usar la opción ForceAutoSubdomain en el archivo de configuración del panel.

Al habilitar los subdominios automáticos, ISPmanager realiza automáticamente los siguientes cambios:

• Para el modo «Directorio separado», se añade esta directiva a la configuración del virtual host:

VirtualDocumentRoot /home/username/data/www/%0

• Para el modo «Subdirectorio del dominio WWW»:

VirtualDocumentRoot /home/username/data/www/example.com/%1

• Se añade una entrada wildcard *.example.com a la directiva ServerAlias
• Se añade un registro DNS de tipo A con wildcard * para el dominio, apuntando a su dirección IP

Resolución de problemas & FAQ

¿Dónde debo colocar los archivos del subdominio?

Depende del modo elegido:

• «Directorio separado» → www/nombre.completo.subdominio
• «Subdirectorio del dominio WWW» → www/nombre-dominio/nombre-subdominio

He habilitado los subdominios automáticos pero el dominio no resuelve

La propagación DNS lleva tiempo — en algunos casos hasta 24–48 horas. Comprueba también que tu dominio esté delegado a los mismos servidores de nombres que utiliza ISPmanager.

Tras habilitar los subdominios automáticos, otros subdominios empezaron a devolver errores 404

Al habilitar los subdominios automáticos, se añade una entrada wildcard *.example.com a la configuración de Apache, lo que provoca que todas las solicitudes se enruten a través de ese dominio. Para solucionarlo, ve al campo Alias e indica explícitamente solo los subdominios que realmente necesitas.

Los registros DNS que apuntan a otras direcciones IP dejaron de funcionar

Un registro wildcard * en la configuración DNS tiene prioridad sobre las entradas más específicas. Tus opciones son: deshabilitar los subdominios automáticos o añadir manualmente todos los registros de tipo A necesarios en la configuración DNS.

Los subdominios www no funcionan (p. ej. www.example.com o www.domain.example.com)

Las variantes www requieren configurar enlaces simbólicos (symlinks) de forma manual.

Para el modo «Directorio separado», crea los symlinks dentro del directorio www:

lrwxr-xr-x  www.example.com -> example.com
lrwxr-xr-x  www.domain.example.com -> domain.example.com

Para el modo «Subdirectorio del dominio WWW», crea los symlinks dentro del directorio propio del dominio:

lrwxr-xr-x  www -> .
lrwxr-xr-x  www.domain -> domain

Usa el comando ln -s para crearlos:

ln -s domain www.domain
ln -s . www