运维手册

默认安装目录：/opt/voms。

服务管理

# 查看状态
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

健康检查

# 后端健康
curl -s http://localhost:8181/api/v1/public/system/health | jq .

# Nginx 健康（静态页）
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

日志管理

# 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

变更流程：

1. 备份当前配置：

cp /opt/voms/configs/config.production.json /opt/voms/configs/config.production.json.bak

2. 修改配置：

vim /opt/voms/configs/config.production.json

3. 重启生效：

systemctl restart voms-server voms-worker-consumer voms-worker-scheduler

数据库与缓存运维

# PostgreSQL 登录（示例）
sudo -u postgres psql

# Redis 检查
redis-cli ping

# NATS 监控
curl -s http://localhost:8222/varz | jq .
curl -s http://localhost:8222/jsz | jq .

重新部署 / 升级

cd /opt/voms-release
sudo ./voms-deploy --force

重新部署或升级时需使用 --force flag，绕过 .deploy.lock 锁文件检查，强制重新执行部署流程，覆盖二进制、配置与 systemd 单元。

日常巡检建议

• 每日：健康检查 + systemd 状态 + 错误日志
• 每周：数据库备份与恢复演练
• 每次发布后：回归登录、活动报名、签到、通知等核心链路