跳到主要内容

共享主机指南

本指南介绍如何在典型的 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