Pular para o conteúdo principal

Problemas de Domínio e DNS

Subdomínio Mostra "404 Not Found"​

Problema: Acessar tenant.seusite.com mostra um erro 404.

Soluções:

Apache​

  1. Verifique se ServerAlias *.seusite.com está na configuração do virtual host
  2. Certifique-se de que mod_rewrite está habilitado: sudo a2enmod rewrite
  3. Reinicie o Apache: sudo systemctl restart apache2

Nginx​

  1. Verifique se server_name seusite.com *.seusite.com; está no bloco server
  2. Teste a configuração: sudo nginx -t
  3. Reinicie: sudo systemctl restart nginx

cPanel​

  1. Verifique se o subdomínio wildcard existe em cPanel → Domains
  2. Certifique-se de que aponta para o diretório correto

DNS​

  1. Verifique se o registro DNS wildcard existe: *.seusite.com → IP do seu servidor
  2. Verifique a propagação em dnschecker.org
  3. Aguarde até 48 horas para propagação completa

Subdomínio Mostra Site Errado / Página Padrão​

Problema: Subdomínios mostram a página padrão do provedor de hospedagem em vez do CRM.

Soluções:

  1. O subdomínio wildcard está apontando para o diretório errado
  2. No cPanel: Edite o subdomínio wildcard para apontar para o diretório raiz do Perfex CRM
  3. No Apache/Nginx: Certifique-se de que DocumentRoot (Apache) ou root (Nginx) aponta para sua instalação do Perfex

Domínio Personalizado Não Funciona​

Problema: O domínio personalizado de um tenant não mostra o CRM.

Soluções:

  1. Verifique o DNS: Use dnschecker.org para verificar se o domínio aponta para o IP do seu servidor
  2. Verifique o servidor web: Certifique-se de que seu Apache/Nginx está configurado para aceitar o domínio
  3. Verifique o módulo: Verifique se o domínio personalizado está inserido corretamente nas configurações do tenant
  4. Aguarde a propagação: Alterações de DNS podem levar até 48 horas

Apache — Adicionar suporte a domínio personalizado:​

<VirtualHost *:80>
  ServerName seusite.com
  ServerAlias *.seusite.com
  ServerAlias dominio-do-tenant.com # Adicione cada domínio personalizado
  DocumentRoot /var/www/html/perfex
</VirtualHost>

Ou use um virtual host catch-all que aceita QUALQUER domínio:

<VirtualHost *:80>
  ServerName seusite.com
  ServerAlias *
  DocumentRoot /var/www/html/perfex
</VirtualHost>

Nginx — Adicionar suporte a domínio personalizado:​

server {
  listen 80 default_server;
  server_name seusite.com *.seusite.com;
  # Adicione _ para capturar TODOS os domínios:
  server_name _;
  root /var/www/html/perfex;
}

Problemas com Certificado SSL​

Aviso "Your connection is not private"​

Problema: Navegador mostra um aviso de segurança ao acessar um subdomínio ou domínio personalizado.

Soluções:

  1. Para subdomínios: Instale um certificado SSL wildcard ou use Let's Encrypt
  2. Para domínios personalizados: Cada domínio personalizado precisa de seu próprio certificado SSL
  3. Solução rápida: Use Cloudflare (plano gratuito) — fornece SSL para todos os domínios

Certificado SSL Expirado​

Problema: O SSL estava funcionando mas agora mostra aviso de expiração.

Soluções:

  1. Let's Encrypt: Verifique a renovação automática: sudo certbot renew --dry-run
  2. cPanel: Execute o AutoSSL em cPanel → SSL/TLS Status
  3. Certificado manual: Compre e instale um novo certificado

Erro "ERR_TOO_MANY_REDIRECTS"​

Problema: O navegador mostra um erro de loop de redirecionamento.

Soluções:

  1. Conflito Cloudflare + SSL do servidor: Defina o modo SSL do Cloudflare para "Full" (não "Flexible") se seu servidor tem seu próprio SSL
  2. Verifique o .htaccess: Procure regras de redirecionamento conflitantes
  3. Limpe cookies do navegador: Às vezes cookies antigos causam loops de redirecionamento
  4. Verifique o modo da landing page: Tente alternar entre os modos "proxy" e "redirection" nas Configurações da Landing Page

Tenant Recebe "403 Forbidden"​

Problema: Tenant consegue acessar a URL mas vê um erro "403 Forbidden".

Soluções:

  1. Verifique permissões do diretório: chmod 755 no diretório do Perfex
  2. Verifique permissões de arquivos: chmod 644 em arquivos PHP
  3. Verifique o .htaccess para quaisquer restrições de IP
  4. Se usando Apache, certifique-se de que AllowOverride All está definido no virtual host
dica

Ainda com problemas de DNS? Certifique-se de aguardar o tempo completo de propagação (até 48 horas) antes de concluir que há um problema. Use dnschecker.org para monitorar a propagação em tempo real.