服务器要求
本页列出了您的 Web 服务器运行 LeadHub 所需的一切。不用担心 — 这些都不需要任何技术专业知识。如果您使用的是标准共享主机账户（cPanel、Plesk、DirectAdmin），此列表中的几乎所有内容几乎肯定已经就位。本指南将向您展示如何确切地进行检查。
快速概览
| 要求 | 最低配置 | 备注 |
|---|---|---|
| PHP | 8.3 或更高 | 8.2 将无法运行 |
| 数据库 | MySQL 8.0+ 或 MariaDB 10.4+ | 两者均可 |
| Web 服务器 | Apache 或 Nginx | 两者均可 |
| 磁盘空间 | ~500 MB | 用于文件 + 数据库 |
| 内存 | 最低 512 MB | 可在共享主机上运行 |
| SSH / 终端 | 不需要 | 一切都在浏览器中完成 |
| Redis | 不需要 | 完全不需要 |
| Composer | 不需要 | 已在 zip 包中预编译 |
| Node.js / npm | 不需要 | 已在 zip 包中预编译 |
| Supervisor | 不需要 | cron.php 处理一切 |
PHP 版本 — 8.3 或更高
LeadHub 需要 PHP 8.3 或更新版本。PHP 8.2 将无法运行。PHP 8.4 受支持。
可以将 PHP 想象成汽车引擎 — 它是实际运行应用程序代码的组件。大多数现代主机账户提供多个 PHP 版本，并允许您在无需任何技术知识的情况下在它们之间切换。
如何在 cPanel 中检查和更改 PHP 版本
- 登录您的 cPanel 账户。
- 查找 "MultiPHP Manager" 图标（通常在"Software"部分）。
- 点击它。
- 在列表中找到您的域名。
- 查看旁边显示的 PHP 版本。
- 如果显示低于 PHP 8.3 的版本（例如 7.4、8.0、8.1 或 8.2），点击下拉菜单并将其更改为 PHP 8.3（或 8.4，如果可用）。
- 点击 Apply。
就是这样。更改立即生效。
如何在 Plesk 中检查 PHP 版本
- 登录 Plesk。
- 点击 Websites & Domains。
- 找到您的域名并点击 PHP Settings（或在域名行中查找"PHP version"）。
- 从下拉菜单中选择 PHP 8.3 或 8.4，然后点击 OK。
如何在 DirectAdmin 中检查 PHP 版本
- 登录 DirectAdmin。
- 转到 Domain Setup，然后选择您的域名。
- 查找"PHP Version"选项并选择 8.3 或更高版本。
数据库 — MySQL 8.0+ 或 MariaDB 10.4+
LeadHub 将所有数据（潜在客户、设置、用户、自动化等）存储在 MySQL 数据库中。可以将数据库想象成存放所有信息的文件柜。
- MySQL 8.0 或更新版本 — 完全支持
- MariaDB 10.4 或更新版本 — 完全支持（MariaDB 是 MySQL 的直接替代品；许多共享主机默认使用它）
您无需在运行安装程序之前配置数据库。安装向导将逐步引导您创建连接。
Web 服务器 — Apache 或 Nginx
您的主机提供商会自动运行其中一个。您无需自行安装或配置任何内容。
- Apache（cPanel 共享主机上最常见）— 运行完美。LeadHub 包含一个预配置的
.htaccess文件，可自动处理所有必要的 URL 重写。 - Nginx（常见于 VPS 和 一些托管主机）— 运行完美。您的主机提供商管理 Nginx 配置。
必需的 PHP 扩展
PHP 扩展是赋予 PHP 额外功能的小型附加组件。可以将它们想象成手机上的应用程序 — 手机没有某些应用也能正常工作，但某些功能需要安装特定的应用。
安装向导会自动检查所有必需的扩展是否存在，并为每个扩展显示清晰的绿色勾号或红色警告。以下是每个扩展的简要说明：
| 扩展 | 功能说明 |
|---|---|
| pdo | 主"数据库连接"系统 — 使 PHP 能够与数据库通信 |
| pdo_mysql | 该数据库连接的 MySQL 特定部分 — 使 LeadHub 能够与您的 MySQL/MariaDB 数据库通信 |
| mbstring | 处理多字节文本 — 对于正确显示非英语语言的名称、电子邮件和内容至关重要 |
| openssl | 处理加密和安全 — 用于加密密码、生成安全令牌和建立 HTTPS 连接 |
| tokenizer | 帮助 PHP 读取和解析自身的代码 — 驱动 LeadHub 的 Laravel 框架所必需 |
| xml | 允许 PHP 读写 XML 数据 — 在与某些外部服务和 API 通信时使用 |
| ctype | 检查文本是否仅包含特定类型的字符 — 用于输入验证 |
| json | 允许 PHP 处理 JSON 数据 — JSON 是 Web 服务用来传输数据的通用语言 |
| bcmath | 处理非常精确的数学计算 — 用于需要十进制精度的潜在客户评分计算 |
| fileinfo | 检测文件的实际类型 — 当用户上传标志、导入文件等时使用 |
| curl | 允许 PHP 发出出站 Web 请求 — 用于连接 Facebook Lead Ads、Google Ads、webhooks 和所有外部集成 |
| zip | 允许 PHP 创建和打开 ZIP 压缩包 — 用于批量导出和文件导入 |
| gd | 图像处理库 — 用于调整上传图像（如标志和头像）的大小 |
所有这些扩展在绝大多数共享主机账户上默认启用。如果缺少任何扩展，您可以通过主机控制面板启用它们。
如何在 cPanel 中启用 PHP 扩展
- 登录 cPanel。
- 在 Software 部分查找 "Select PHP Version"。（这与 MultiPHP Manager 不同 — 这个控制哪些扩展处于活动状态。）
- 点击它。
- 确保顶部显示正确的 PHP 版本（例如 PHP 8.3）。
- 您将看到一长串复选框 — 每个可用扩展一个。
- 找到您需要的扩展（例如
gd或curl）并勾选复选框。 - 点击 Save。
该扩展现在立即生效。
可写目录
LeadHub 需要能够将文件写入某些文件夹：一个用于存储上传的文件、缓存数据、日志和会话数据；另一个用于缓存配置文件。
这些目录（及其中的所有文件夹）需要具有写入权限：
storage/storage/app/storage/app/public/storage/framework/storage/framework/cache/storage/framework/sessions/storage/framework/views/storage/logs/bootstrap/cache/
实际上，设置这些权限是您在安装过程中使用主机文件管理器执行一次的操作。安装向导指南详细介绍了具体步骤。
电子邮件 — 任何 SMTP 提供商
LeadHub 可以使用任何标准 SMTP 电子邮件服务发送电子邮件（邀请邮件、潜在客户通知、自动化邮件等）。SMTP 是所有电子邮件服务器用来发送邮件的标准技术。
您无需在安装期间配置电子邮件。 安装完成后，您可以在管理面板的设置 → 电子邮件中配置。您将输入 SMTP 主机、端口、用户名和密码 — 这些信息都由您的电子邮件提供商提供。
兼容的电子邮件提供商包括（但不限于）：
- Gmail / Google Workspace
- Outlook / Microsoft 365
- Amazon SES
- Mailgun
- SendGrid
- Brevo（前身为 Sendinblue）
- Postmark
- 任何其他标准 SMTP 服务
SSL / HTTPS
强烈建议使用 HTTPS，对于专业安装来说几乎是必需的。LeadHub 处理密码、个人数据和 API 凭据 — 所有这些都应通过加密连接传输。
大多数主机提供商通过 Let's Encrypt 提供免费 SSL 证书，可以在 cPanel 或 Plesk 仪表板中一键启用。在控制面板中查找"SSL/TLS"或"Let's Encrypt"。在开始安装之前启用它，以便您的 LeadHub URL 从第一天起就使用 https://。
磁盘空间
LeadHub 本身（所有应用程序文件、vendor/ 文件夹和编译后的资源）占用约 250 MB 到 350 MB 的磁盘空间。我们建议至少有 500 MB 可用空间，以便舒适地容纳应用程序文件、数据库、上传的文件（标志、导入）和日志文件。
内存 (RAM)
LeadHub 在典型的共享主机方案上运行良好。在大多数方案中您不需要担心内存。作为参考：
- 512 MB RAM — 最低配置，适用于小型安装
- 1 GB RAM — 适合约 20 人的团队和中等潜在客户量
- 2 GB+ RAM — 推荐用于每天数千条潜在客户的高量安装
如果您的共享主机方案指定了 PHP 内存限制，LeadHub 在每个请求 256 MB 的情况下运行良好，这是大多数共享主机的默认值。您可以在 cPanel 中通过转到 Select PHP Version 并在 PHP 选项列表中查找 memory_limit 来检查您的 PHP 内存限制。
您不需要的内容
这一点很重要，需要提前了解。与某些平台不同，LeadHub 专门设计为无需以下任何内容即可运行：
- 无需 SSH / 终端访问 — 您永远不需要通过命令行登录服务器
- 无需 artisan 命令 — 永远不需要运行任何
php artisan命令 - 无需 Composer — 包含所有依赖项的
vendor/文件夹已包含在下载包中 - 无需 Node.js 或 npm — 所有 JavaScript 和 CSS 资源已预编译并包含在包中
- 无需 Redis — LeadHub 默认使用基于文件的缓存和会话，可在任何共享主机上运行
- 无需 Supervisor — 后台作业处理和计划任务完全由
cron.php处理，它作为标准主机 cron 作业运行 - 无需 root / 服务器管理员访问 — 标准 Web 主机用户权限即可满足
快速检查清单
在开始安装之前使用此清单：
- PHP 8.3 或更高版本已为我的域 名激活
- MySQL 8.0+ 或 MariaDB 10.4+ 数据库可用（cPanel 提供此功能）
- Apache（带 mod_rewrite）或 Nginx 是我的 Web 服务器
- 我至少有 500 MB 的可用磁盘空间
- 我有 FTP 客户端或可以使用 cPanel 文件管理器上传文件
- 我有一个 SMTP 电子邮件账户准备就绪（可在安装后配置）
- SSL 证书已在我的域名上激活（强烈建议）
如果以上全部确认，您就可以开始安装了。请继续阅读安装向导指南。