cyfershepard/jellystat

Jellystat 技术文档

镜像概述

Jellystat是一款免费开源的Jellyfin统计应用，专为Jellyfin媒体服务器设计，提供全面的使用数据统计与监控功能。该项目目前仍在开发阶段，可能存在部分功能不稳定的情况。

核心功能与特性

当前功能

• 会话监控与日志记录
• 所有媒体库和用户的统计数据
• 观看历史记录
• 用户概览与活动追踪
• 观看统计分析
• 数据备份与恢复
• 媒体库项目自动同步
• Jellyfin统计插件集成

待开发功能

• 响应式UI设计
• 代码优化
• 安全测试
• 更多数据验证与错误处理
• 多服务器支持
• 其他功能持续开发中

使用场景与适用范围

适用于需要监控和分析Jellyfin媒体服务器使用情况的场景，包括但不限于：

• 家庭媒体中心管理员监控用户活动
• 分析媒体内容观看频率与偏好
• 跟踪服务器资源使用情况
• 备份重要统计数据以防丢失

使用方法与配置说明

Docker部署示例

docker-compose配置

yaml
version: '3'
services:
  jellystat-db:
    image: 'postgres:15.2'
    shm_size: 1gb
    container_name: jellystat-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: postgres  # PostgreSQL数据库用户名
      POSTGRES_PASSWORD: mypassword  # PostgreSQL数据库密码
    volumes:
      - 'postgres-data:/var/lib/postgresql/data'  # 持久化数据库数据
  jellystat:
    image: 'cyfershepard/jellystat:latest'
    container_name: jellystat
    restart: unless-stopped
    environment:
      POSTGRES_USER: postgres  # 数据库用户名（需与jellystat-db一致）
      POSTGRES_PASSWORD: mypassword  # 数据库密码（需与jellystat-db一致）
      POSTGRES_IP: jellystat-db  # 数据库服务IP或容器名
      POSTGRES_PORT: 5432  # 数据库端口
      JWT_SECRET: my-secret-jwt-key  # JWT密钥，建议使用随机字符串
      TZ: mytimezone  # 时区，如Asia/Shanghai
    volumes:
      - 'jellystat-backup-data:/app/backend/backup-data'  # 持久化备份数据
    ports:
      - '3000:3000'  # 映射Web访问端口
    depends_on:
      - jellystat-db  # 依赖数据库服务启动
networks:
  default: null
volumes:
  postgres-data: null  # 数据库数据卷
  jellystat-backup-data: null  # 备份数据卷
logging:
  driver: json-file
  options:
    max-file: '5'  # 最大日志文件数
    max-size: 10m  # 单日志文件大小上限

环境变量说明

截图

!https://raw.githubusercontent.com/CyferShepard/Jellystat/main/screenshots/Home.PNG !https://raw.githubusercontent.com/CyferShepard/Jellystat/main/screenshots/Users.PNG !https://raw.githubusercontent.com/CyferShepard/Jellystat/main/screenshots/Activity.PNG !https://raw.githubusercontent.com/CyferShepard/Jellystat/main/screenshots/Libraries.PNG

支持与反馈

• 问题报告和功能请求可通过https://github.com/CyferShepard/Jellystat/issues%E6%8F%90%E4%BA%A4%E3%80%82

API文档

待完善