跳到主要内容

安装指南

这是 FeedbackPulse SaaS 的完整分步安装指南，请仔细按照每一步操作。

安装前检查清单​

开始之前，请确保您已准备好：

  • 满足所有服务器要求的服务器
  • 指向您服务器 IP 地址的域名
  • 服务器的 SSH 访问权限（或用于文件上传的 FTP）
  • MySQL/MariaDB 数据库及凭据
  • SMTP 邮件账户（Gmail、Mailgun、Amazon SES 等）
  • 您的 Envato 购买码（来自 CodeCanyon 订单）

第一步：将文件上传至服务器​

方案 A：使用 SSH（推荐）​

# 连接到服务器
ssh user@your-server-ip

# 进入 Web 目录
cd /var/www

# 上传并解压 ZIP 文件
# （通过 SCP、SFTP 或 wget 从临时链接上传 zip）
unzip feedbackpulse-saas.zip -d feedbackpulse-saas
cd feedbackpulse-saas

方案 B：使用 FTP/SFTP​

  1. 使用 FileZilla、WinSCP 等工具连接到服务器
  2. 导航到 Web 目录（通常是 /var/www/ 或 /home/user/public_html/）
  3. 上传解压后的整个 feedbackpulse-saas 文件夹
  4. 确保 public/ 子目录可被访问

方案 C：使用 cPanel 文件管理器​

  1. 登录 cPanel
  2. 打开文件管理器 → 进入 public_html（或子目录）
  3. 上传 ZIP 文件
  4. 就地解压
  5. 重要： 您需要将文档根目录设置为 public/ 文件夹（参阅 Apache 配置）

第二步：设置文件权限​

cd /var/www/feedbackpulse-saas

# 设置所有者（将 www-data 替换为您的 Web 服务器用户）
# Apache: www-data | Nginx: www-data 或 nginx
sudo chown -R www-data:www-data .

# 设置目录权限
sudo find . -type d -exec chmod 755 {} \;
sudo find . -type f -exec chmod 644 {} \;

# 使 storage 和 cache 可写
sudo chmod -R 775 storage bootstrap/cache

第三步：配置 Web 服务器​

您的 Web 服务器必须指向项目内的 public/ 目录，而不是项目根目录。这是关键的安全要求。

选择您的 Web 服务器：

快速版本：

Apache：

DocumentRoot /var/www/feedbackpulse-saas/public

Nginx：

root /var/www/feedbackpulse-saas/public;

配置完成后，重启 Web 服务器：

# Apache
sudo systemctl restart apache2

# Nginx
sudo systemctl restart nginx

第四步：存储软链接（自动完成）​

Web 安装程序会在最后一步自动尝试创建存储软链接，您无需手动执行任何命令。

  • VPS/独立服务器： 软链接会自动创建，无需任何操作。
  • 共享主机： 如果您的主机禁用了软链接，FeedbackPulse 会使用内置 PHP 回退机制来提供上传文件（Logo、图片）。一切正常运行，无需任何操作。

安装程序完成页面会告知软链接是否已成功创建，或回退机制是否已激活。

第五步：运行 Web 安装程序​

打开浏览器，访问：

https://yourdomain.com/install

安装程序将引导您完成 5 个步骤。详情请参阅 Web 安装程序详解。

快速摘要：

第 1 步：许可证验证​

  • 输入您的 Envato/CodeCanyon 购买码
  • 通过 Envato API 验证您的许可证
  • 如果您不使用 Envato，可能有跳过选项

第 2 步：环境检查​

  • 安装程序会自动检查：
    • 依赖项（vendor/autoload.php 是否存在）
    • PHP 版本（8.2+）
    • 必需的 PHP 扩展
    • 目录权限（storage、bootstrap/cache）
    • 主机环境（检测共享主机，显示兼容性信息）
  • 请在继续之前修复所有未通过的检查项

第 3 步：数据库配置​

  • 输入数据库凭据：
    • 主机： 127.0.0.1（或 localhost）
    • 端口： 3306
    • 数据库名： feedbackpulse（请提前创建！）
    • 用户名： 您的数据库用户名
    • 密码： 您的数据库密码
  • 安装程序将运行所有迁移并填充默认数据

请提前创建数据库：

CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

第 4 步：管理员账户​

  • 创建您的超级管理员账户：
    • 姓名： 您的姓名
    • 邮箱： [email protected]
    • 密码： 强密码（最少 8 位）
  • 这是您用于管理整个平台的账户

第 5 步：邮件配置​

  • 输入 SMTP 详情：
    • 主机： 如 smtp.gmail.com
    • 端口： 587（TLS）或 465（SSL）
    • 用户名： 您的 SMTP 用户名
    • 密码： 您的 SMTP 密码或应用专用密码
    • 加密： TLS（推荐）
    • 发件地址： [email protected]
  • 可以跳过此步骤，稍后在管理员设置中配置

安装完成​

  • 将 Session 和缓存驱动切换为 database（生产环境）
  • 为 Web Cron 端点生成 CRON_TOKEN
  • 创建 storage/installed.lock 文件（防止重复安装）
  • 显示成功页面，包含 Cron 任务设置说明（CLI 和 URL 两种方式）及后续步骤

第六步：配置 Cron 任务​

FeedbackPulse 需要 Cron 任务来执行定时任务，这对以下功能至关重要：

  • 发送邮件摘要（日/周）
  • 处理试用期到期
  • 执行数据保留策略
  • 发送用量警报
  • 运行 AI 异常检测
  • 发送定时报告

方案 1 — CLI 命令（VPS / 独立服务器）：

crontab -e

添加以下行：

* * * * * cd /var/www/feedbackpulse-saas && php artisan schedule:run >> /dev/null 2>&1

方案 2 — URL/wget（共享主机）：

如果您的主机面板仅支持基于 URL 的 Cron，请使用 Web Cron 端点（CRON_TOKEN 在安装时自动生成，显示在完成页面上）：

wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"

提示： 安装程序完成页面显示两种方案，并已预填写您的实际服务器路径和 token，直接复制使用即可！

更多详情，请参阅 Cron 任务与队列工作进程。

第七步：配置 SSL（HTTPS）​

HTTPS 强烈推荐，尤其是 FeedbackPulse 涉及认证和支付数据的处理。

使用 Let's Encrypt（免费）​

# 安装 Certbot
sudo apt install certbot python3-certbot-nginx  # 用于 Nginx
# 或
sudo apt install certbot python3-certbot-apache  # 用于 Apache

# 获取证书
sudo certbot --nginx -d yourdomain.com  # 用于 Nginx
# 或
sudo certbot --apache -d yourdomain.com  # 用于 Apache

Certbot 会自动为 Web 服务器配置 HTTPS 并设置自动续期。

更多详情，请参阅 SSL 证书。

第八步：验证安装​

按照以下检查清单逐项确认：

检查项方式预期结果
落地页加载访问 https://yourdomain.com看到落地页
登录正常访问 https://yourdomain.com/login以超级管理员身份登录
管理面板访问 https://yourdomain.com/admin/dashboard看到管理仪表板
存储链接访问 https://yourdomain.com/storage/无 404 错误
健康检查访问 https://yourdomain.com/up看到"OK"文字
Cron 运行检查 管理员 → 设置无 Cron 警告
邮件正常管理员 → 设置 → 邮件 → 发送测试收到测试邮件

安装后续步骤​

安装完成后：

  1. 查看订阅套餐 — 管理员 → 套餐（编辑定价、限制、功能）
  2. 配置支付网关 — 管理员 → 设置 → 付款（Stripe/PayPal API 密钥）
  3. 自定义落地页 — 管理员 → 落地页
  4. 测试邮件发送 — 管理员 → 设置 → 邮件 → 发送测试邮件
  5. 配置通配符 DNS（可选）— 用于租户子域名，参阅通配符 DNS 配置
  6. 创建第一个租户 — 在无痕窗口中访问 /register 注册

安装问题排查​

问题解决方案
空白白页检查 storage/logs/laravel.log 中的错误，通常是权限问题。
500 服务器错误临时启用调试模式：在 .env 中设置 APP_DEBUG=true，然后查看错误。
"Class not found"（类未找到）确保 vendor/ 目录存在且完整，如需要可从下载包重新上传。
数据库连接被拒绝验证凭据，确保 MySQL 正在运行，检查 localhost 和 127.0.0.1 的差异。
安装程序无法加载确保 Web 根目录指向 public/ 目录。
CSS/JS 无法加载清除浏览器缓存。图片丢失时，共享主机上的回退机制会自动处理。在 VPS 上，以超级管理员身份访问 /update 重新创建软链接。
权限被拒绝重新执行第二步中的 chown 和 chmod 命令。

更多内容，请参阅问题排查。

下一步​