📋 系统要求

服务器要求

最低配置

组件	最低版本	推荐
PHP	8.4	8.4+
MySQL	5.7	8.0
MariaDB	10.3	10.6+
RAM	512 MB	1 GB+
磁盘	200 MB	1 GB+

Web 服务器

Apache（共享主机最常见）

必须启用 mod_rewrite
必须启用 .htaccess 支持（AllowOverride All）

Nginx（仅限 VPS）

参见项目根目录中的 nginx.conf.example 获取即用配置
需要 PHP-FPM

必需的 PHP 扩展

这些在几乎所有主机提供商上默认已启用：

扩展	用途
`pdo`	数据库抽象基础
`pdo_mysql`	MySQL 数据库驱动
`json`	JSON 编解码
`session`	用户会话管理
`openssl`	密码哈希、HMAC 验证
`curl`	外部 API 调用（WhatsApp、Twilio、Telegram 等）
`mbstring`	多字节字符串操作（Unicode 消息内容）

可选扩展

扩展	用途	所需场景
`imap`	轮询邮箱	邮件频道入站

检查服务器上的扩展： 创建一个名为 info.php 的临时文件，内容为 <?php phpinfo(); ?>，上传到 web 根目录并在浏览器中打开。在输出中查找列出的扩展。完成后删除该文件。

网络要求

入站

您的服务器必须可从互联网公开访问，以便频道提供商（WhatsApp、Twilio、Telegram 等）能够向其发送 webhook。

大多数提供商要求带 HTTPS 的域名（WhatsApp 和 Instagram 强制要求 HTTPS）。免费的 Let's Encrypt 证书即可。
Webhook 路径格式为：https://yourdomain.com/webhooks/{channel_type}/{channel_id}

出站

PulseHub 在发送消息时会向提供商 API 发起 HTTPS 调用：

提供商	目标地址
WhatsApp	`graph.facebook.com`
Twilio	`api.twilio.com`
Telegram	`api.telegram.org`
Viber	`chatapi.viber.com`
Instagram/Facebook	`graph.facebook.com`
OpenAI（AI 建议）	`api.openai.com`

数据库要求

PulseHub 在安装向导期间自动创建数据库和所有表。您只需要：

具有 CREATE DATABASE 权限的 MySQL 用户（或预先创建的具有完全权限的空数据库）
字符集：utf8mb4（支持完整的 Unicode/表情符号 — PulseHub 自动设置）

共享主机兼容性

PulseHub 是专为共享主机方案（cPanel、Plesk、DirectAdmin）设计的即插即用解决方案：

无需 SSH 或命令行访问 — 一切通过浏览器完成
无需 Composer、npm、artisan、构建步骤 — 上传文件并运行 Web 安装程序
无需 root 访问权限
兼容您主机提供的 PHP 版本（7.4+）
可通过主机面板的 Cron Jobs 工具中的简单 URL 设置 cron 作业 — 无需 CLI 命令
Cron URL 在安装后和 Settings → Cron Job URL 中显示

共享主机上的邮件入站： imap 扩展在大多数 cPanel/Plesk 主机上可用。如果不可用，请让主机通过托管面板启用它（通常在"Select PHP Version"或"PHP Extensions"下），或使用第三方邮件解析服务（Mailgun Inbound、SendGrid Inbound Parse）直接调用您的 webhook 端点。

服务器要求​

最低配置​

Web 服务器​

必需的 PHP 扩展​

可选扩展​

网络要求​

入站​

出站​

数据库要求​

共享主机兼容性​