跳到主要内容

📋 系统要求

服务器要求

最低配置

组件最低版本推荐
PHP7.48.1+
MySQL5.78.0
MariaDB10.310.6+
RAM512 MB1 GB+
磁盘200 MB1 GB+

Web 服务器

Apache(共享主机最常见)

  • 必须启用 mod_rewrite
  • 必须启用 .htaccess 支持(AllowOverride All

Nginx(仅限 VPS)

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

必需的 PHP 扩展

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

扩展用途
pdo数据库抽象基础
pdo_mysqlMySQL 数据库驱动
jsonJSON 编解码
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 调用:

提供商目标地址
WhatsAppgraph.facebook.com
Twilioapi.twilio.com
Telegramapi.telegram.org
Viberchatapi.viber.com
Instagram/Facebookgraph.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 端点。