📋 系统要求
服务器要求
最低配置
| 组件 | 最低版本 | 推荐 |
|---|---|---|
| PHP | 7.4 | 8.1+ |
| 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 调用:
| 提供商 | 目标地址 |
|---|---|
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 端点。