跳到主要内容

共享主机指南

本指南介绍如何在典型的 cPanel 共享主机账户上安装 LeadHub。无需 SSH、终端或 root 权限。

您将使用的工具​

  • cPanel 文件管理器（或 FTP）
  • cPanel MySQL 数据库
  • cPanel 定时任务
  • Web 浏览器

第 1 步 — 创建数据库​

  1. 在 cPanel 中，点击 MySQL 数据库。
  2. 创建一个新数据库，例如 username_leadhub。
  3. 创建一个新的数据库用户，例如 username_lhuser，并设置强密码。
  4. 将用户添加到数据库并授予所有权限。
  5. 记录：数据库名称、用户名、密码和主机（通常为 localhost）。

第 2 步 — 上传文件​

方式 A — 文件管理器：

  1. 前往 cPanel → 文件管理器。
  2. 导航到 public_html/（如果希望将 LeadHub 安装在子目录中，请导航至相应目录）。
  3. 点击上传并上传 LeadHub ZIP 文件。
  4. 上传后，右键点击 ZIP → 解压至 public_html/。

方式 B — FTP：

  1. 使用 FileZilla 或任何 FTP 客户端。
  2. 使用您的 FTP 凭据连接到主机。
  3. 将解压后的 LeadHub 文件夹中的所有文件直接上传至 public_html/。

⚠️ 确保 index.php 直接位于 public_html/ 中——不要放在子文件夹内。

第 3 步 — 设置权限​

在 cPanel 文件管理器中：

  1. 选择 storage/ 文件夹 → 右键点击 → 更改权限 → 设为 755，勾选递归进入子目录。
  2. 对 bootstrap/cache/ 执行相同操作。

第 4 步 — 运行安装程序​

打开浏览器并访问：

https://yourdomain.com/install

按照安装指南完成向导。

第 5 步 — 设置定时任务​

  1. 在 cPanel 中，点击定时任务。
  2. 在添加新定时任务下，将常用设置设为"每分钟（* * * * *）"。
  3. 在命令字段中输入： 
    /usr/bin/php /home/yourusername/public_html/cron.php >> /dev/null 2>&1

    请将 yourusername 替换为您实际的 cPanel 用户名，如果 LeadHub 安装在子目录中，请相应调整路径。

  4. 点击添加新定时任务。

第 6 步 — 验证定时任务是否运行​

等待 2-3 分钟后，在 LeadHub 超级管理员面板中前往系统健康。队列状态应显示绿色。如果显示"队列未运行"，请重新检查 cron 路径。

在子目录中安装​

如果您希望 LeadHub 运行在 yourdomain.com/leadhub/ 而非根目录：

  1. 将文件上传至 public_html/leadhub/。
  2. 在安装过程中，将应用 URL 设为 https://yourdomain.com/leadhub。
  3. cron 路径变为 /home/yourusername/public_html/leadhub/cron.php。

子域名安装​

要在 app.yourdomain.com 上安装 LeadHub：

  1. 在 cPanel → 域名（或子域名）中，创建 app.yourdomain.com，指向例如 public_html/leadhub/。
  2. 将文件上传至 public_html/leadhub/。
  3. 将应用 URL 设为 https://app.yourdomain.com。

PHP 版本检查​

如果您的 cPanel 提供 MultiPHP Manager：

  1. 前往 MultiPHP Manager。
  2. 找到您的域名/子域名。
  3. 选择 PHP 8.4（或最高可用的 8.x 版本）。
  4. 保存。

常见 cPanel 问题​

问题解决方案
.htaccess 不生效通过 cPanel → Apache 处理程序启用 mod_rewrite，或联系主机商
500 内部服务器错误在文件管理器中检查 storage/logs/laravel.log
PHP 扩展缺失cPanel → 选择 PHP 版本 → 启用缺失的扩展
队列未运行验证 cron 路径——使用系统健康中显示的精确路径
文件权限被拒绝将 storage/ 和 bootstrap/cache/ 递归设置为 755