Problemas de Dominio y DNS
El Subdominio Muestra "404 Not Found"
Problema: Al visitar tenant.yoursite.com se muestra un error 404.
Soluciones:
Apache
- Verifica que
ServerAlias *.yoursite.comesté en la configuración de tu virtual host - Asegúrate de que
mod_rewriteesté habilitado:sudo a2enmod rewrite - Reinicia Apache:
sudo systemctl restart apache2
Nginx
- Verifica que
server_name yoursite.com *.yoursite.com;esté en tu bloque de servidor - Prueba la configuración:
sudo nginx -t - Reinicia:
sudo systemctl restart nginx
cPanel
- Verifica que el subdominio wildcard exista en cPanel → Domains
- Asegúrate de que apunte al directorio correcto
DNS
- Verifica que el registro DNS wildcard exista:
*.yoursite.com → IP de tu servidor - Comprueba la propagación en dnschecker.org
- Espera hasta 48 horas para la propagación completa
El Subdominio Muestra un Sitio Web Incorrecto / Página Predeterminada
Problema: Los subdominios muestran la página predeterminada de tu proveedor de hosting en lugar del CRM.
Soluciones:
- El subdominio wildcard está apuntando al directorio incorrecto
- En cPanel: Edita el subdominio wildcard para que apunte al directorio raíz de Perfex CRM
- En Apache/Nginx: Asegúrate de que
DocumentRoot(Apache) oroot(Nginx) apunte a tu instalación de Perfex
El Dominio Personalizado No Funciona
Problema: El dominio personalizado de un inquilino no muestra su CRM.
Soluciones:
- Verifica el DNS: Usa dnschecker.org para verificar que el dominio apunte a la IP de tu servidor
- Verifica el servidor web: Asegúrate de que tu Apache/Nginx esté configurado para aceptar el dominio
- Verifica el módulo: Comprueba que el dominio personalizado esté correctamente ingresado en la configuración del inquilino
- Espera la propagación: Los cambios de DNS pueden tardar hasta 48 horas
Apache — Agregar soporte de dominio personalizado:
<VirtualHost *:80>
ServerName yoursite.com
ServerAlias *.yoursite.com
ServerAlias tenant-domain.com # Agrega cada dominio personalizado
DocumentRoot /var/www/html/perfex
</VirtualHost>
O usa un virtual host comodín que acepte CUALQUIER dominio:
<VirtualHost *:80>
ServerName yoursite.com
ServerAlias *
DocumentRoot /var/www/html/perfex
</VirtualHost>
Nginx — Agregar soporte de dominio personalizado:
server {
listen 80 default_server;
server_name yoursite.com *.yoursite.com;
# Agrega _ para capturar TODOS los dominios:
server_name _;
root /var/www/html/perfex;
}
Problemas de Certificado SSL
Advertencia "Tu conexión no es privada"
Problema: El navegador muestra una advertencia de seguridad al acceder a un subdominio o dominio personalizado.
Soluciones:
- Para subdominios: Instala un certificado SSL wildcard o usa Let's Encrypt
- Para dominios personalizados: Cada dominio personalizado necesita su propio certificado SSL
- Solución rápida: Usa Cloudflare (plan gratuito) — proporciona SSL para todos los dominios
Certificado SSL Expirado
Problema: El SSL funcionaba pero ahora muestra una advertencia de expiración.
Soluciones:
- Let's Encrypt: Verifica la renovación automática:
sudo certbot renew --dry-run - cPanel: Ejecuta AutoSSL desde cPanel → SSL/TLS Status
- Certificado manual: Compra e instala un nuevo certificado