跳到主要内容

安装向导

LeadHub 完全通过您的网页浏览器安装。没有命令行，没有终端，没有 SSH。您上传文件，打开一个 URL，然后按照五个简单步骤操作。本指南将引导您完成从头到尾的整个过程。

总时间：约 10-20 分钟。

开始之前​

确保您的服务器满足服务器要求指南中列出的要求。特别确认：

  • PHP 8.3 或更高版本已为您的域名激活
  • 您有可用的 MySQL 数据库（或 MariaDB）— 或者您可以创建一个（说明如下）
  • 您的 storage/ 和 bootstrap/cache/ 目录具有写入权限
  • 您有大约 500 MB 的可用磁盘空间

步骤 1 — 上传 LeadHub 文件到您的服务器​

下载安装包​

购买 LeadHub 后，从您的购买确认邮件或 Envato 下载页面下载 ZIP 安装包。文件名类似 leadhub-v1.0.0.zip。

ZIP 包内含 LeadHub 所需的一切 — 包括 vendor/ 文件夹、预编译的 CSS 和 JavaScript，以及安装程序本身。

通过 cPanel 文件管理器上传（最简单的方法）​

  1. 登录您的 cPanel 账户。
  2. 点击 Files 部分的 File Manager。
  3. 导航到您要安装 LeadHub 的文件夹。通常是：
    • public_html/（主域名）
    • 子目录如 public_html/leadhub/
    • 专用的附加域文件夹（推荐 — 参见共享主机指南）
  4. 点击工具栏中的 Upload。
  5. 上传 leadhub-v1.0.0.zip 文件。
  6. 上传完成后，右键点击 ZIP 文件并选择 Extract。
  7. 解压到正确的文件夹。

通过 FTP 上传​

  1. 使用 FTP 凭据连接到服务器。
  2. 导航到服务器上的目标文件夹。
  3. 将解压后的 leadhub 文件夹拖到服务器文件夹。
  4. 等待所有文件上传完成（5-15 分钟）。

提示： 通过文件管理器上传 ZIP 文件并在服务器上解压比通过 FTP 上传数千个单独文件要快得多。

步骤 2 — 设置文件权限​

将以下文件夹设置为 755 权限：

在 cPanel 文件管理器中：​

  1. 打开 File Manager 并导航到 LeadHub 文件夹。
  2. 右键点击 storage 文件夹 → Change Permissions。
  3. 设置为 755 并勾选 "Recurse into subdirectories"。
  4. 点击 Change Permissions。
  5. 对 bootstrap/cache 文件夹重复此操作（设置为 755）。

步骤 3 — 在浏览器中打开安装程序​

https://yourdomain.com/install

如果出现 404 错误： 检查文件位置和 public/.htaccess 是否正确上传。

如果出现空白页： 在 cPanel → MultiPHP Manager 中检查 PHP 版本。

安装程序步骤 1 — 欢迎和要求检查​

自动检查：

  • PHP 版本 — 必须为 8.3 或更高
  • PHP 扩展 — 检查所有 13 个必需扩展
  • 目录权限 — 检查 storage/ 和 bootstrap/cache/ 是否可写

全部显示绿色勾号后，点击 "Next: Database"。

安装程序步骤 2 — 数据库配置​

字段输入内容
Database Host通常为 localhost 或 127.0.0.1
Port通常为 3306
Database Name您创建的 MySQL 数据库名称
Database Username您创建的 MySQL 用户名
Database Password该 MySQL 用户的密码

在 cPanel 中创建 MySQL 数据库​

  1. 在 cPanel 中，找到 MySQL Databases。
  2. 在"Create New Database"下输入名称 → Create Database。
  3. 在"MySQL Users"→"Add New User"下创建用户名和密码 → Create User。
  4. 在"Add User to Database"下选择用户和数据库 → Add。
  5. 勾选 "All Privileges" → Make Changes。

安装程序步骤 3 — 管理员账户​

字段输入内容
Your Name您的全名
Email Address您的电子邮件（将作为登录用户名）
Password强密码（至少 8 个字符）
Confirm Password再次输入相同的密码
Workspace Name您的组织名称

工作区是您在 LeadHub 中的组织账户。您将被设置为拥有完全超级管理员权限的所有者。

点击 "Next: License"。

安装程序步骤 4 — 许可证​

查找您的购买代码：

  1. 登录 Envato Market / CodeCanyon 账户。
  2. 个人资料 → Downloads。
  3. 找到 LeadHub → "Download" → "License certificate & purchase code"。
  4. 复制购买代码。

粘贴并点击 "Next: Finish"。您可以跳过此步骤，稍后添加许可证。

安装程序步骤 5 — 完成​

点击 "Install LeadHub"。安装程序将自动执行：

  1. 写入配置文件（.env）
  2. 运行数据库迁移
  3. 填充初始数据（角色和权限）
  4. 创建管理员账户
  5. 创建工作区
  6. 链接存储文件夹
  7. 缓存配置

耗时约 30-90 秒。完成后将重定向到 /admin。

安装完成。

安装后检查清单​

1. 设置 Cron 作业（关键）​

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

必须每分钟运行一次。参见共享主机指南。

2. 配置电子邮件​

管理面板中的设置 → 电子邮件。

3. 上传标志和品牌设置​

设置 → 品牌。

4. 创建第一个管道​

侧边栏中的 Pipelines。

5. 连接第一个潜在客户来源​

侧边栏中的 Lead Sources。

如何重新运行安装程序​

从 storage/ 删除 installed.lock 文件，然后重新访问 /install。

警告： 请先备份数据库，因为 .env 将被覆盖。

故障排除​

问题可能原因解决方案
访问 /install 时出现"Page not found"文件位置不正确或 mod_rewrite 未启用检查文件位置和 public/.htaccess
空白页PHP 错误或版本不正确在 cPanel MultiPHP Manager 中切换到 PHP 8.3
步骤 2 出现"Cannot connect to database"数据库凭据错误检查名称（含 cPanel 前缀）、用户名和密码
扩展出现红色警告PHP 扩展未启用cPanel → Select PHP Version，启用缺失的扩展
"storage is not writable"警告权限设置不正确在文件管理器中将 storage/ 递归设置为 755
安装程序卡在"Installing..."PHP 内存限制过低刷新页面；检查 PHP 内存限制（至少 128 MB）
重定向到 /admin 但无法登录会话未保存检查 storage/framework/sessions/ 是否存在且可写
"installation failed"错误数据库连接丢失检查凭据和 .env 的写入权限