服务器要求
安装 FeedbackPulse SaaS 之前，请确保您的服务器满足所有以下要求。
必需软件
| 软件 | 最低版本 | 推荐版本 | 备注 |
|---|---|---|---|
| PHP | 8.4 | 8.4+ | 需要以下扩展（见下文） |
| MySQL | 8.0 | 8.0+ | 或 MariaDB 10.6+ |
| Web 服务器 | Apache 2.4+ 或 Nginx 1.18+ | Nginx | Apache 需要 mod_rewrite |
| Composer | 2.0+ | 最新版 | PHP 依赖管理器（或上传预构建的 vendor/） |
| Node.js | 不需要 | — | 资源文件已预编译 |
共享主机？ 如果您无法运行
composer install，请从下载包中上传整个vendor/文件夹。Web 安装程序会检查vendor/autoload.php是否存在，缺失时将阻止安装。
必需 PHP 扩展
以下 PHP 扩展必须已安装并启用：
| 扩展 | 用途 | 检查命令 |
|---|---|---|
pdo_mysql | MySQL 数据库连接 | php -m | grep pdo_mysql |
mbstring | 多字节字符串处理 | php -m | grep mbstring |
openssl | 加密和 HTTPS | php -m | grep openssl |
tokenizer | PHP 代码解析 | php -m | grep tokenizer |
xml | XML 解析 | php -m | grep xml |
ctype | 字符类型检查 | php -m | grep ctype |
json | JSON 编解码 | php -m | grep json |
bcmath | 任意精度数学运算 | php -m | grep bcmath |
fileinfo | 文件类型检测 | php -m | grep fileinfo |
curl | HTTP 请求（支付、AI、webhook） | php -m | grep curl |
gd 或 imagick | 图片处理 | php -m | grep gd |
zip | 备份压缩 | php -m | grep zip |
在 Ubuntu/Debian 上安装 PHP 扩展
sudo apt update
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath \
php8.4-curl php8.4-gd php8.4-zip php8.4-fileinfo php8.4-tokenizer
在 CentOS/RHEL 上安装 PHP 扩展
sudo dnf install php-mysqlnd php-mbstring php-xml php-bcmath \
php-curl php-gd php-zip php-fileinfo
在 Windows（XAMPP/Laragon）上
大多数扩展已预安装，编辑 php.ini 并取消注释以下行：
extension=pdo_mysql
extension=mbstring
extension=openssl
extension=curl
extension=gd
extension=zip
extension=fileinfo
extension=bcmath
提示： Laragon 默认启用所有扩展，只需确保您使用的是 PHP 8.4+。
目录权限
Web 服务器（Apache/Nginx）用户必须对以下目录拥有写入权限：
| 目录 | 权限 | 用途 |
|---|---|---|
storage/ | 775 | 日志、缓存、Session、上传文件 |
storage/app/public/ | 775 | 公开文件上传（Logo、照片） |
storage/framework/cache/ | 775 | 应用缓存 |
storage/framework/sessions/ | 775 | Session 文件 |
storage/framework/views/ | 775 | 编译后的 Blade 模板 |
storage/logs/ | 775 | 应用日志 |
bootstrap/cache/ | 775 | 框架启动缓存 |
.env | 644 | 环境配置文件（由安装程序创建） |
设置权限（Linux）
cd /var/www/feedbackpulse-saas
# 设置 Web 服务器用户为所有者
sudo chown -R www-data:www-data storage bootstrap/cache
# 设置目录权限
sudo chmod -R 775 storage bootstrap/cache
安全提示： 切勿将权限设置为
777，请使用775并配合正确的用户/组所有权。
网络要求
| 要求 | 用途 | 是否必需 |
|---|---|---|
| 域名 | 平台 URL | 是 |
| SSL 证书 | HTTPS 加密 | 强烈推荐 |
| 通配符 DNS（可选） | 租户子域名（*.yourdomain.com） | 可选 |
| 出站 HTTPS（端口 443） | Stripe、PayPal、OpenAI、OAuth API | 是（用于集成） |
| 出站 SMTP（端口 587/465） | 发送邮件 | 是 |
推荐服务器配置
| 租户数量 | CPU | 内存 | 磁盘 | 备注 |
|---|---|---|---|---|
| 1-10 | 1 vCPU | 1 GB | 20 GB | 共享主机可能适用 |
| 10-100 | 2 vCPU | 2 GB | 40 GB | 推荐 VPS |
| 100-1,000 | 4 vCPU | 4 GB | 80 GB | 考虑使用 Redis 作为缓存/队列 |
| 1,000+ | 8+ vCPU | 8+ GB | 160+ GB | 必须使用 Redis，推荐队列工作进程 |
支持的主机环境
完全支持
- VPS 提供商： DigitalOcean、Linode、Vultr、AWS EC2、Hetzner
- 托管服务器： Laravel Forge、Ploi、RunCloud、ServerPilot
- 共享主机： cPanel、Plesk、DirectAdmin、CyberPanel、HestiaCP、CloudPanel、AAPanel
- 本地开发： Laragon（Windows）、Valet（macOS）、Sail（Docker）
共享主机？ FeedbackPulse SaaS 与共享主机 100% 兼容 — 即使
exec()被禁用且不支持软链接。请参阅专门的共享主机指南获取分步说明。
部分支持（有限制）
- 托管 WordPress 主机： 通常无法使用（无 PHP CLI 访问权限，Cron 受限）
不支持
- 静态主机： Netlify、Vercel、GitHub Pages（FeedbackPulse 是 PHP 应用，非静态站点）
- 无服务器： AWS Lambda、Cloudflare Workers（需要持久化文件系统）
验证服务器
运行以下命令一次性检查所有要求：
php -v # 必须是 8.4+
php -m # 检查所有扩展
mysql --version # 必须是 8.0+（或 MariaDB 10.6+）
composer --version # 必须是 2.0+
ls -la storage/ # 检查权限
或者直接访问 https://yourdomain.com/install — Web 安装程序内置了自动环境检查功能，会精确告诉您缺少哪些内容。
下一步
所有要求 均已满足？请继续：
- 安装指南 — 完整的分步配置