跳到主要内容

域名和 DNS 问题

子域名显示"404 Not Found"

问题: 访问 tenant.yoursite.com 显示 404 错误。

解决方案:

Apache

  1. 检查虚拟主机配置中是否有 ServerAlias *.yoursite.com
  2. 确保 mod_rewrite 已启用:sudo a2enmod rewrite
  3. 重启 Apache:sudo systemctl restart apache2

Nginx

  1. 检查服务器块中是否有 server_name yoursite.com *.yoursite.com;
  2. 测试配置:sudo nginx -t
  3. 重启:sudo systemctl restart nginx

cPanel

  1. 验证 cPanel → Domains 中是否存在通配符子域名
  2. 确保它指向正确的目录

DNS

  1. 验证通配符 DNS 记录是否存在:*.yoursite.com → 您的服务器 IP
  2. dnschecker.org 检查传播情况
  3. 等待最多 48 小时完全传播

子域名显示错误的网站 / 默认页面

问题: 子域名显示您的主机提供商的默认页面,而不是 CRM。

解决方案:

  1. 通配符子域名指向了错误的目录
  2. 在 cPanel 中:编辑通配符子域名使其指向您的 Perfex CRM 根目录
  3. 在 Apache/Nginx 中:确保 DocumentRoot(Apache)或 root(Nginx)指向您的 Perfex 安装目录

自定义域名不工作

问题: 租户的自定义域名未显示其 CRM。

解决方案:

  1. 检查 DNS: 使用 dnschecker.org 验证域名是否指向您的服务器 IP
  2. 检查 Web 服务器: 确保 Apache/Nginx 已配置为接受该域名
  3. 检查模块: 验证自定义域名在租户设置中是否正确输入
  4. 等待传播: DNS 更改可能需要最多 48 小时

Apache — 添加自定义域名支持:

<VirtualHost *:80>
ServerName yoursite.com
ServerAlias *.yoursite.com
ServerAlias tenant-domain.com # Add each custom domain
DocumentRoot /var/www/html/perfex
</VirtualHost>

或者 使用通配符虚拟主机接受任何域名:

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

Nginx — 添加自定义域名支持:

server {
listen 80 default_server;
server_name yoursite.com *.yoursite.com;
# Add _ to catch ALL domains:
server_name _;
root /var/www/html/perfex;
}

SSL 证书问题

"Your connection is not private" 警告

问题: 浏览器在访问子域名或自定义域名时显示安全警告。

解决方案:

  1. 对于子域名: 安装通配符 SSL 证书或使用 Let's Encrypt
  2. 对于自定义域名: 每个自定义域名需要自己的 SSL 证书
  3. 快速修复: 使用 Cloudflare(免费计划)——它为所有域名提供 SSL

SSL 证书过期

问题: SSL 之前正常工作,但现在显示过期警告。

解决方案:

  1. Let's Encrypt: 检查自动续期:sudo certbot renew --dry-run
  2. cPanel: 从 cPanel → SSL/TLS Status 运行 AutoSSL
  3. 手动证书: 购买并安装新证书

"ERR_TOO_MANY_REDIRECTS" 错误

问题: 浏览器显示重定向循环错误。

解决方案:

  1. Cloudflare + 服务器 SSL 冲突: 如果您的服务器有自己的 SSL,将 Cloudflare SSL 模式设置为"Full"(而非"Flexible")
  2. 检查 .htaccess: 查找冲突的重定向规则
  3. 清除浏览器 Cookie: 有时旧 Cookie 会导致重定向循环
  4. 检查落地页模式: 尝试在落地页设置中切换"proxy"和"redirection"模式

租户收到"403 Forbidden"

问题: 租户可以访问 URL,但看到"403 Forbidden"错误。

解决方案:

  1. 检查目录权限:对 Perfex 目录使用 chmod 755
  2. 检查文件权限:对 PHP 文件使用 chmod 644
  3. 检查 .htaccess 中是否有任何 IP 限制
  4. 如果使用 Apache,确保虚拟主机中设置了 AllowOverride All
提示

仍有 DNS 问题? 在下结论之前,确保等待完整的传播时间(最多 48 小时)。使用 dnschecker.org 实时监控传播情况。