跳到主要内容

共享主机指南（cPanel、Plesk、DirectAdmin）

LeadHub 从一开始就是为在共享主机上运行而设计的。您不需要 VPS、专用服务器、SSH 访问或任何命令行知识。如果您能上传文件并填写网页表单，就能安装和运行 LeadHub。

您不需要的​

  • 无需 SSH / 终端 / 命令行
  • 无需 artisan 命令
  • 无需 Composer — 所有依赖项在 vendor/ 中
  • 无需 Node.js 或 npm
  • 无需 Redis
  • 无需 Supervisor — cron.php 处理一切
  • 无需 root 访问

您需要的​

  • PHP 8.3 或更高
  • MySQL 数据库
  • 能够添加 cron 作业
  • 约 500 MB 磁盘空间
  • 启用 mod_rewrite 的 Apache

选项 A — 附加域（推荐）​

步骤 1：创建附加域​

在 cPanel 中：

  1. 点击 Addon Domains。
  2. Document Root： 改为 public_html/leadhub/public
  3. 点击 Add Domain。

步骤 2：上传文件​

public_html/
  leadhub/
    app/
    public/          ← 附加域指向这里
    storage/
    vendor/
    cron.php

步骤 3-5：数据库、权限、安装​

创建 MySQL 数据库，将 storage 和 bootstrap/cache 设为 755，然后访问 /install。

选项 B — 直接安装到 public_html/​

将 leadhub/public/ 中的所有内容移到 public_html/。index.php 会自动检测。

设置 Cron 作业 — 关键​

这是安装后最重要的步骤。

在 cPanel 中​

php /home/yourusername/public_html/leadhub/cron.php >> /dev/null 2>&1

所有时间字段设为 *（每分钟）。

在 Plesk 中​

php /var/www/vhosts/yourdomain.com/leadhub/cron.php >> /dev/null 2>&1

在 DirectAdmin 中​

php /home/yourusername/domains/yourdomain.com/leadhub/cron.php >> /dev/null 2>&1

常见 PHP 路径​

/usr/local/bin/php、/usr/bin/php、/opt/cpanel/ea-php83/root/usr/bin/php

Web Cron 替代方案​

在 .env 中添加 CRON_SECRET=您的随机密钥：

https://yourdomain.com/cron.php?token=您的随机密钥

权限参考​

文件夹权限原因
storage/755会话、日志、缓存
bootstrap/cache/755编译配置
public/755Web 文件
PHP 文件644可读
.env640 或 644敏感文件

PHP 版本选择​

cPanel： Software → MultiPHP Manager → PHP 8.3 → Apply。 Plesk： Websites & Domains → PHP Settings → PHP 8.3 → OK。 DirectAdmin： Domain Setup → PHP Version → 8.3。

故障排除​

问题原因解决方案
空白页PHP 版本不对切换到 PHP 8.3
404 错误文件位置不对检查文件位置和 .htaccess
403 错误权限不对设为 755
Cron 不运行路径不对检查完整路径
自动化不触发Cron 未配置检查 cron 作业
邮件不发送未配置设置 → 电子邮件
数据库连接失败凭据不对检查凭据
显示已安装installed.lock 存在从 storage/ 删除