管理后台使用指南

本文档介绍如何使用 Vibany 管理后台进行系统监控和日常运营。

访问管理后台

URL 地址

https://yourdomain.com/admin

权限要求

只有管理员账号可以访问管理后台。管理员在 .env.local 中配置：

ADMIN_USER_IDS=user_xxx,user_yyy
ADMIN_USER_EMAILS=admin@yourdomain.com

管理后台功能概览

1. 仪表板 (Dashboard)

访问路径：/admin/dashboard

功能：

查看系统核心指标
今日/本周/本月统计数据
用户增长趋势
收入趋势

核心指标：

总用户数
今日新增用户
今日订单数
今日收入（积分）
活跃用户数
生成图片数量

2. 用户管理

访问路径：/admin/users

功能：

查看所有用户列表
搜索用户（邮箱、用户名）
查看用户详情
调整用户积分
查看用户历史记录

操作：

查看详情：点击用户行查看详细信息
调整积分：点击 "调整积分" 按钮
查看历史：查看用户的生成历史

3. 订单管理

访问路径：/admin/orders

功能：

查看所有订单
筛选订单（状态、支付方式）
搜索订单
手动标记支付
处理退款

订单状态：

PENDING：待支付
SUCCESS：支付成功
FAILED：支付失败
REFUND：已退款

4. 邀请码管理

访问路径：/admin/invitations

功能：

查看所有邀请码
创建新邀请码
禁用邀请码
查看邀请统计

邀请码类型：

points：奖励积分
cash：奖励现金
both：两者都奖励

5. 黑名单管理

访问路径：/admin/blocklists

功能：

查看黑名单列表
添加黑名单
删除黑名单
启用/禁用黑名单

黑名单类型：

email：完整邮箱地址
domain：整个域名
ip：IP 地址

6. 图片备份管理

访问路径：/admin/backup

功能：

创建备份任务
查看备份历史
查看备份详情
修复卡住的备份

备份参数：

日期范围
批处理大小
模拟运行（测试模式）
跳过已备份检查

常见运营任务

给用户充值积分

进入 /admin/users
搜索目标用户
点击 "调整积分"
输入积分数量（正数为充值，负数为扣除）
填写调整原因
确认提交

创建邀请码

进入 /admin/invitations
点击 "创建邀请码"
设置参数：
- 邀请类型（points/cash/both）
- 分成比例
- 最大使用次数
- 过期时间（可选）
提交生成邀请码

处理退款

进入 /admin/orders
找到需要退款的订单
确认订单状态为 SUCCESS
点击 "退款"
确认退款金额
提交退款申请

添加黑名单

进入 /admin/blocklists
点击 "添加黑名单"
选择类型（email/domain/ip）
输入匹配模式
添加描述（可选）
提交

数据分析

用户增长分析

在 Dashboard 查看：

新用户注册趋势
用户留存率
用户活跃度分布

收入分析

查看指标：

每日/每周/每月收入
支付方式占比
平均订单金额
付费转化率

使用分析

监控数据：

图片生成数量
各模型使用频率
用户生成频次
高峰使用时段

系统监控

健康检查

访问健康检查端点：

GET https://yourdomain.com/api/health

预期响应：

{
  "status": "ok",
  "database": "connected",
  "timestamp": "2024-01-01T00:00:00Z"
}

日志查看

Vercel 部署：

在 Vercel Dashboard → Functions 查看日志

VPS 部署：

# 查看 PM2 日志
pm2 logs image-render

# 查看最新 100 行
pm2 logs image-render --lines 100

错误监控

查看错误日志：

# Vercel
vercel logs --json

# VPS
pm2 logs image-render --err

日常维护任务

每日检查清单

查看 Dashboard 核心指标
检查待支付订单
查看用户反馈
检查系统日志是否有错误

每周检查清单

分析用户增长趋势
检查收入数据
查看模型使用情况
备份重要数据

每月检查清单

财务报表
用户活跃度分析
系统性能检查
更新依赖包

故障排除

无法访问 Admin 后台

检查：

是否已登录
账号是否在管理员列表
检查 .env.local 配置

数据加载缓慢

优化：

检查数据库连接
查看是否有慢查询
考虑添加索引

统计数据不准确

原因：

缓存问题
时区问题
数据统计逻辑错误

解决：

清除缓存
检查时区配置
核对数据库原始数据

安全注意事项

保护管理员账号：使用强密码，启用 2FA
定期更换密钥：API Key、数据库密码等
操作审计：重要操作记录日志
访问限制：限制 Admin 后台访问 IP（可选）
数据备份：定期备份数据库