概述

系统核心基于 Swoole 运行，需使用 Supervisor 进程管理器进行常驻守护，确保服务异常退出时能够自动重启。

---

步骤一：确认 PHP 命令行版本与扩展

1. 进入宝塔面板【网站】页面上方，点击【PHP 命令行版本】；
2. 确保选中的版本为 PHP-8.0（与站点运行版本保持严格一致）；
3. 在终端执行 php --ri ebaozu_loader，确保商业核心扩展已成功加载。

---

步骤二：添加守护进程

1. 打开宝塔面板【软件商店 -> 已安装 -> Supervisor 管理器 -> 设置】；
2. 点击【添加守护进程】，填写以下参数：

配置项	填写内容	说明
名称	ebaozu_swoole	进程名称（仅限英文与下划线）
启动用户	www	必须以 www 用户身份运行
运行目录	/www/wwwroot/你的项目目录	选中系统根目录
启动命令	php think swoole	核心 Swoole 启动指令
进程数量	1	保持默认 1 个进程

3. 点击【确定】保存并添加守护进程。

---

步骤三：启动与状态检查

1. 在 Supervisor 进程列表中，点击【启动】按钮；
2. 观察进程状态是否变为绿色的 RUNNING；
3. 若状态显示异常或反复重启（FATAL / BACKOFF），点击右侧【日志】查看报错信息，常见原因：
   • ebaozu_loader extension is required：PHP 8.0 未成功加载核心加载器扩展，请核对 php.ini 末尾是否追加了 extension=ebaozu_loader.so；
   • license file not found or unreadable：授权文件缺失或权限不足，确保 config/ebaozu/license.key 存在且权限为 600、属主为 www:www；
   • Call to undefined function proc_open()：PHP-8.0【禁用函数】中尚未删除 proc_open；
   • 端口占用：20698 端口已被其他进程占用，可通过 netstat -tunlp | grep 20698 查验。
4. (可选) 初次验证亦可在终端前台运行排查：su - www -s /bin/bash -c "cd /www/wwwroot/你的项目目录 && php think swoole"。