维护指南
启动/停止/重载 OpenResty
启动
bash
/usr/local/openresty/nginx/sbin/nginx -c /path/to/nginx.conf停止
bash
/usr/local/openresty/nginx/sbin/nginx -s stop重载配置
修改 nginx.conf 或 Lua 脚本后，执行重载使配置生效：
bash
/usr/local/openresty/nginx/sbin/nginx -s reload重载不会中断正在处理的请求，是生产环境推荐的操作方式。
配置检查
bash
/usr/local/openresty/nginx/sbin/nginx -t查看日志
| 日志文件 | 说明 |
|---|---|
logs/error.log | OpenResty 错误日志 |
logs/access.log | OpenResty 访问日志 |
| PHP-FPM 日志 | PHP 错误日志 |
实时查看
bash
tail -f logs/error.log
tail -f logs/access.log同步配置
以下场景需要将配置同步到 OpenResty 节点：
| 场景 | 同步内容 | 操作方式 |
|---|---|---|
| 新增/编辑模型 | 模型目录 | 后台「推送配置」 |
| 修改路由规则 | 路由表 | 后台「同步配置到全部节点」 |
| 用户订阅/续充 | 用户余额 | 自动同步 |
| 修改 API Key | 密钥列表 | 自动同步 |
| OpenResty 重启后 | 全部配置 | 后台「推送配置」 |
用量同步
平台通过 cron 脚本定期从 OpenResty 拉取用量数据：
bash
# crontab 配置示例，每 5 分钟执行一次
*/5 * * * * php /path/to/command/sync-usage.php脚本功能：
- 遍历所有活跃节点，拉取增量调用记录
- 写入
usage_raw表（去重） - 更新
usage_agg聚合统计 - 从 OpenResty 拉取实时 Token 余额，更新 DB
- 检查自动充值条件并执行
监控与告警
健康检查
通过 /proxy-api/health 端点检查节点健康状态。
常见告警
| 告警 | 可能原因 | 处理方式 |
|---|---|---|
| 节点不可达 | OpenResty 未运行 / 网络故障 | 检查节点状态，启动 OpenResty |
| 502 Bad Gateway | PHP-FPM 未运行 | 启动 PHP-FPM |
| 内存表空间不足 | 配置数据过大 | 检查共享内存大小配置 |
| 自动充值失败 | 用户钱包余额不足 | 通知用户充值 |