共享主机（cPanel）部署

Store Console 更倾向于 VPS（Docker 或 LEMP），但也可以在合适的共享主机上运行。共享主机意味着没有根访问权限，通常使用 MySQL 而非 PostgreSQL，没有 Redis，以及没有长时间运行的进程——本页面详细说明了具体的变化。

最低主机能力

• PHP 8.4 及标准 Laravel 扩展（大多数 cPanel PHP 选择器包含这些扩展）
• MySQL 8.0+ 或 MariaDB 10.6+（在可用的情况下优先使用 PostgreSQL）
• Cron 作业（至少每分钟一次）
• 强烈建议为 composer 和 artisan 提供 SSH 访问

步骤 1：上传并指向文档根目录

在 public_html 外上传并解压您的授权 zip 文件，然后在 cPanel → 域中将（子）域的文档根指向应用的 public/ 目录。切勿暴露应用根目录。

步骤 2：为共享主机配置 .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password

QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null

这些驱动程序是一流的：队列、缓存和会话表在默认迁移中提供，因此不需要 Redis。

步骤 3：迁移和构建

php artisan migrate --seed
npm run build   # or build locally and upload public/build

步骤 4：Cron 条目（替代 Horizon 和 systemd）

在 cPanel → Cron 作业中添加两个 cron 作业：

* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55

第二个条目每分钟处理一次所有队列并退出，这在共享主机的进程限制下是安全的。共享主机上不使用 Horizon 及其仪表板。

降级内容 — 及其方式

• AI 语义功能（向量搜索，嵌入）需要 PostgreSQL + pgvector — 在 MySQL 上，它们会干净地关闭，而 AI 聊天、生成和报告工具仍会通过您配置的提供商继续工作
• 实时聊天 & 通知 在 VPS 上使用 Reverb/WebSockets — 如果没有，UI 会自动回退到定期轮询（BROADCAST_CONNECTION=null）
• 后台作业 的运行时间比专用工作者晚最多一分钟 — 对于邮件、发票和报告是可以接受的；重负载商店应迁移到 VPS

何时升级到 VPS

当您启用 POS 或配送调度（延迟敏感）、依赖 AI 搜索或每分钟处理超过几个订单时，请迁移到 VPS。您的数据可以通过标准数据库转储迁移 — 无需重新安装。