管理后台

管理后台提供完整的系统管理功能，包括用户管理、内容审核、数据统计等。

访问后台

入口

  • 点击头像菜单 →「管理后台」
  • 或直接访问 /admin

权限要求

只有管理员角色才能访问后台。

仪表盘

数据概览

  • 用户总数
  • 图片总数
  • 今日新增
  • 存储使用量

趋势图表

  • 用户增长趋势
  • 上传趋势
  • 活跃度趋势

快速操作

  • 审核待处理
  • 系统通知
  • 快捷入口

用户管理

用户列表

操作说明
查看查看用户详情
编辑修改用户信息
启用/禁用控制账号状态
删除删除用户
分配角色设置用户角色

搜索筛选

  • 用户名搜索
  • 邮箱搜索
  • 状态筛选
  • 注册时间

批量操作

  • 批量启用
  • 批量禁用
  • 批量删除

图片管理

图片列表

显示所有图片，支持：

  • 标题搜索
  • 状态筛选（待审核/已通过/已拒绝）
  • 用户筛选
  • 时间筛选

图片审核

单张审核

  1. 点击图片查看详情
  2. 选择「通过」或「拒绝」
  3. 拒绝需填写原因

批量审核

  1. 勾选多张图片
  2. 点击「批量审核」
  3. 选择通过或拒绝

图片删除

  • 单张删除 - 移动到回收站
  • 批量删除 - 批量移动到回收站
  • 永久删除 - 在回收站中彻底删除

评论管理

评论列表

  • 查看所有评论
  • 查看评论图片
  • 查看评论者

评论审核

  • 通过评论
  • 拒绝评论
  • 批量审核

评论删除

  • 单条删除
  • 批量删除

权限管理

系统使用 RBAC（基于角色的访问控制）。

角色管理

默认角色

角色权限
超级管理员全部权限
管理员管理功能
审核员内容审核
普通用户基础功能

自定义角色

  1. 点击「创建角色」
  2. 设置角色名称
  3. 分配权限
  4. 保存

权限分配

权限树示例：
├── 用户管理
│   ├── 查看用户列表
│   ├── 编辑用户
│   ├── 删除用户
│   └── 分配角色
├── 图片管理
│   ├── 查看图片列表
│   ├── 审核图片
│   └── 删除图片
├── 评论管理
│   ├── 查看评论
│   ├── 审核评论
│   └── 删除评论
└── 系统设置
    ├── 基本设置
    └── 安全设置

用户角色分配

  1. 在用户管理中找到用户
  2. 点击「分配角色」
  3. 选择角色
  4. 保存

系统设置

系统设置采用数据库驱动的配置管理，支持在线修改配置项，无需修改代码文件。

配置分组

系统设置分为 5 个配置分组：

分组说明
系统设置站点基本信息、SEO配置
上传设置文件上传限制、缩略图配置
安全设置限流、CSRF、XSS等安全功能
性能设置缓存、APM监控配置
功能开关注册、评论、审核等功能开关

系统设置 (system)

站点信息

配置项说明默认值
site_name站点名称逍遥图库系统
site_version系统版本1.1.0

SEO配置

配置项说明默认值
site_description站点描述(SEO)专业的在线图片管理与分享平台
site_keywords站点关键词(SEO)图库,图片管理,相册,图片分享
site_author站点作者-
og_imageOG默认分享图片/static/images/og-default.png
site_logo站点Logo图片/static/images/logo.png

提示: og_image 和 site_logo 支持图片上传，点击"选择图片上传"按钮即可上传新图片。

上传设置 (upload)

配置项说明默认值
upload_max_size单文件最大大小(MB)10
upload_allowed_extensions允许的文件扩展名jpg,jpeg,png,gif,webp,bmp
upload_max_width图片最大宽度(px)8000
upload_max_height图片最大高度(px)8000
thumbnail_width缩略图宽度(px)300
thumbnail_height缩略图高度(px)300
thumbnail_quality缩略图质量(1-100)85

安全设置 (security)

访问频率限制

配置项说明默认值
rate_limit_enabled启用访问频率限制关闭
rate_limit_default_max默认每分钟最大请求数120
rate_limit_default_duration默认限流时间窗口(秒)60
rate_limit_upload_max上传接口每分钟最大请求数10
rate_limit_login_max登录接口每分钟最大请求数10
rate_limit_register_max注册接口每小时最大请求数3
rate_limit_admin_max管理接口每分钟最大请求数300
rate_limit_system_upload_max系统图片上传每分钟最大请求数30

安全防护

配置项说明默认值
csrf_enabled启用CSRF防护关闭
xss_filter_enabled启用XSS过滤关闭
配置项说明默认值
cookie_secureCookie仅HTTPS传输关闭
cookie_httponlyCookie禁止JS访问开启
session_lifetimeSession有效期(秒)7200

注意: 安全功能默认关闭，生产环境建议根据需要开启。

性能设置 (performance)

配置项说明默认值
apm_enabled启用性能监控(APM)开启
apm_slow_threshold慢请求阈值(ms)1000
cache_enabled启用缓存开启
cache_ttl默认缓存时间(秒)3600

功能开关 (feature)

配置项说明默认值
enable_register允许用户注册开启
enable_comment允许评论功能开启
enable_review启用内容审核关闭
enable_watermark启用自动水印关闭(待开发)

配置生效

  • 大部分配置修改后立即生效
  • 部分配置需要清除缓存后生效（点击"清除缓存"按钮）
  • 模板相关配置可能需要清除模板缓存

数据统计

用户统计

  • 注册数量趋势
  • 活跃用户数
  • 用户地域分布

内容统计

  • 上传数量趋势
  • 热门图片
  • 热门标签

访问统计

  • 页面浏览量（PV）
  • 独立访客数（UV）
  • 热门页面

回收站管理

查看回收站

管理员可以查看所有用户的回收站内容。

批量清理

  • 清空指定用户的回收站
  • 清空所有回收站
  • 手动触发自动清理

系统日志

操作日志

记录管理员的所有操作：

  • 用户管理操作
  • 内容审核操作
  • 系统设置修改

访问日志

  • 访问 IP
  • 访问时间
  • 请求路径
  • 响应状态

错误日志

  • 系统错误
  • 异常信息
  • 堆栈跟踪

API 接口

获取仪表盘数据

GET /api/admin/dashboard
Authorization: Bearer {token}

用户管理

# 获取用户列表
GET /api/admin/users?page=1&limit=20

# 启用/禁用用户
PUT /api/admin/users/{id}/status
{
    "status": 1
}

# 删除用户
DELETE /api/admin/users/{id}

图片审核

# 获取待审核图片
GET /api/admin/photos?status=pending

# 审核图片
PUT /api/admin/photos/{id}/audit
{
    "status": "approved",
    "reason": ""
}

# 批量审核
POST /api/admin/photos/batch-audit
{
    "ids": [1, 2, 3],
    "status": "approved"
}

评论管理

# 获取评论列表
GET /api/admin/comments?page=1&limit=20

# 删除评论
DELETE /api/admin/comments/{id}

# 批量删除
POST /api/admin/comments/batch-delete
{
    "ids": [1, 2, 3]
}

最佳实践

日常维护

  1. 定期检查待审核内容
  2. 监控系统日志
  3. 备份重要数据
  4. 更新系统版本

安全建议

  1. 使用强密码
  2. 定期更换密码
  3. 限制管理员数量
  4. 记录操作日志

性能优化

  1. 定期清理日志
  2. 清理回收站
  3. 优化数据库
  4. 检查存储空间

下一步