运维手册
默认安装目录：/opt/voms。
服务管理
bash
# 查看状态
systemctl status voms-server --no-pager
systemctl status voms-worker-consumer --no-pager
systemctl status voms-worker-scheduler --no-pager
# 启停服务
systemctl start voms-server voms-worker-consumer voms-worker-scheduler
systemctl stop voms-server voms-worker-consumer voms-worker-scheduler
# 重启关键服务
systemctl restart voms-server voms-worker-consumer voms-worker-scheduler健康检查
bash
# 后端健康
curl -s http://localhost:8181/api/v1/public/system/health | jq .
# Caddy 健康（静态页）
curl -i http://localhost/
# 依赖服务健康
systemctl status postgresql --no-pager
systemctl status redis --no-pager
systemctl status nats --no-pager
curl -s http://localhost:8222/healthz日志管理
bash
# systemd 日志
journalctl -u voms-server -f
journalctl -u voms-worker-consumer -f
journalctl -u voms-worker-scheduler -f
# 应用文件日志（默认）
tail -f /opt/voms/logs/app.log配置管理
生产配置文件：/opt/voms/configs/config.production.json
变更流程：
- 备份当前配置：
bash
cp /opt/voms/configs/config.production.json /opt/voms/configs/config.production.json.bak- 修改配置：
bash
vim /opt/voms/configs/config.production.json- 重启生效：
bash
systemctl restart voms-server voms-worker-consumer voms-worker-scheduler数据库与缓存运维
bash
# PostgreSQL 登录（示例）
sudo -u postgres psql
# Redis 检查
redis-cli ping
# NATS 监控
curl -s http://localhost:8222/varz | jq .
curl -s http://localhost:8222/jsz | jq .重新部署 / 升级
OTA 自动更新
VOMS 后端支持 OTA 自动更新，正常运行时无需手动操作。查看 OTA 状态：
bash
# 查看最近更新日志
journalctl -u voms-server --no-pager -n 50 | grep -i -E "update|ota|version"
# 确认当前版本
curl -s http://localhost:8181/api/v1/public/system/health | jq .
# 检查备份文件（OTA 更新后会生成）
ls -la /opt/voms/bin/server.bak如果 OTA 更新后出现问题，可快速回滚：
bash
sudo systemctl stop voms-server
sudo cp /opt/voms/bin/server.bak /opt/voms/bin/server
sudo systemctl start voms-server详见 OTA 自动更新。
手动重新部署
bash
cd /opt/voms-release
sudo ./voms-deploy --force重新部署或升级时需使用 --force flag，绕过 .deploy.lock 锁文件检查，强制重新执行部署流程，覆盖二进制、配置与 systemd 单元。
反馈管理
用户提交的反馈通过 BanyanHub SDK 同步到中央平台。管理员通过 BanyanHub Dashboard 查看和管理反馈。
bash
# 检查反馈相关日志
journalctl -u voms-server --no-pager -n 50 | grep -i feedback详见 反馈系统。
日常巡检建议
- 每日：健康检查 + systemd 状态 + 错误日志
- 每周：数据库备份与恢复演练
- 每次发布后：回归登录、活动报名、签到、通知等核心链路