跳到主要内容

📥 安装

PulseHub 通过基于浏览器的向导分两步完成安装。无需编译任何内容，也不需要命令行访问。

步骤 1 — 上传文件​

  1. 下载 pulsehub-php.tar.gz 并在本地解压。您将获得一个名为 pulsehub-php/ 的文件夹。
  2. 将该文件夹的内容（不是文件夹本身）上传到您的 Web 根目录。在大多数共享主机上是 public_html/ 或 www/。在 VPS 上是您的虚拟主机指向的位置（例如 /var/www/pulsehub/）。

上传后，您的 Web 根目录应如下所示：

public_html/
├── index.php
├── .htaccess
├── cron.php
├── install/
├── app/
├── public/
├── config/        ← 此时为空，安装过程中创建
└── data/

子目录安装： 如果您希望 PulseHub 位于 https://yourdomain.com/support/ 而不是根目录，请将文件上传到 public_html/support/。.htaccess 文件会自动处理路径。

步骤 2 — 运行数据库安装程序​

打开浏览器并导航到：

https://yourdomain.com/install/

安装程序 — 第 1 步：数据库设置​

填写您的 MySQL 凭据：

字段描述
Database Host通常是 localhost。在某些主机上是 IP 地址 — 请查看主机文档。
Port默认为 3306。仅在主机使用非标准端口时更改。
Database NamePulseHub 应使用的数据库名称。如果您的 MySQL 用户具有 CREATE DATABASE 权限，将自动创建。
Database User对上述数据库具有完全访问权限的 MySQL 用户名。
Database Password该用户的密码。

点击 Connect & Create Tables →

安装程序 — 第 2 步：管理员账户​

字段描述
Workspace Name您的组织名称，显示在侧边栏中。
Your Name第一个管理员用户的显示名称。
Email Address用于登录。必须是有效的电子邮件格式。
Password最少 8 个字符。以 bcrypt 哈希存储 — 永远不以明文存储。
Confirm Password必须完全匹配。

点击 Create Account & Finish →

步骤 3 — 登录​

在成功页面点击 Go to PulseHub →，或导航到 https://yourdomain.com/。输入您刚刚创建的电子邮件和密码。

安装后：锁定安装程序​

当 config/database.php 存在时，安装程序会自动停用。作为额外的预防措施，您可以在设置完成后使用主机面板的文件管理器或 FTP 客户端完全删除 install/ 目录。

验证安装成功​

登录后您应该看到：

  • 侧边栏包含 Inbox、Contacts、Channels、Automations、Analytics、Settings
  • 侧边栏底部显示您的工作区名称和您的名字
  • 收件箱显示"Select a conversation"（空的 — 还没有消息）

Nginx 安装（仅限 VPS — 共享主机请跳过）​

共享主机用户： 您的主机已处理 Web 服务器配置。本节仅适用于运行 Nginx 的 VPS 或独立服务器。您可以完全跳过。

如果您运行 Nginx + PHP-FPM，请复制提供的示例配置：

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/pulsehub;
    index index.php;

    location ~ ^/(config|app|data)/ {
        deny all;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

然后启用站点并重新加载 Nginx（VPS 终端）：

sudo ln -s /etc/nginx/sites-available/pulsehub /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx