Emby-Pulse（映迹） ： Emby 服务器自动化助手

项目地址：zeyu8023/emby-pulse

项目介绍

EmbyPulse（映迹）是专为 Emby 服主打造的现代化“第二控制台”。它不仅提供了极致的数据可视化大盘，还深度集成了用户管理、追剧日历、缺集自动补货、求片流转及媒体报告生成等核心运维功能。

核心革新：本系统独家支持“API 穿透”与“数据库直读”双擎路由。这意味着您无需强制挂载 Emby 的数据库文件，仅凭 API Key 即可点亮全站统计，完美适配极空间、群晖、云服务器等各种复杂部署环境。

功能特性

• 双擎数据路由：API 模式 / SQLite 模式一键切换，部署环境更自由
• 全面运维面板：播放统计、用户管理、请求系统、任务与缺集全链路
• 自动化闭环：缺集补货 + 求片流转 + 入库反馈一气呵成
• 视觉化报表：日报、周报、月报、年度总结一键生成长图
• 机器人协同：Telegram 交互、推送与实时告警

界面预览

安装部署

version: '3.8'
services:
  emby-pulse:
    image: zeyu8023/emby-stats:latest
    container_name: emby-pulse
    restart: unless-stopped
    network_mode: host #默认端口号为10307
    volumes:
      - ./config:/app/config
      - /path/to/emby/data:/emby-data # API 模式下可不挂载数据库
    environment:
      - TZ=Asia/Shanghai
      - DB_PATH=/emby-data/playback_reporting.db #API模式下可以不写，本地模式必填   
     - EMBY_HOST=http://127.0.0.1:8096  #重要！必填，否则无法登录！账号密码为你emby管理员账号密码
     - EMBY_API_KEY=xxxxxxxxxxxxxxxxxxxxx #选填，后续可以前往后台设置中添加

配置说明

以下为部署后建议优先检查的核心配置项：

Emby 基础配置

• emby_host：Emby 服务器地址，例如 http://127.0.0.1:8096
• emby_api_key：Emby 后台生成的 API Key
• webhook_token：Webhook 安全校验令牌，需与 Emby Webhook 地址中的 token 保持一致
• emby_public_url：对外访问 Emby 的公网地址，用于生成跳转链接

播放统计配置

• playback_data_mode：播放数据模式，支持 sqlite 或 api
• DB_PATH：本地模式下 Playback Reporting 数据库文件路径
• hidden_users：需要在大盘中隐藏的用户 ID 列表

🧩 两种模式如何选择（小白必看）

API 模式（推荐：不方便挂载数据库时）

• 适合：极空间、群晖、云服务器、容器里拿不到数据库文件的环境
• 优点：部署最省心，只要填 EMBY_API_KEY 即可启动
• 注意：需要安装 Emby 官方 Playback Reporting 插件（两种模式都需要）

本地数据库模式（推荐：可挂载数据库时）

• 适合：本地 Docker 或能挂载 Emby 数据目录的 NAS
• 优点：查询性能更高，统计更及时
• 注意：必须正确填写 DB_PATH，且容器内要能访问该文件

说明：

• sqlite 模式直接读取数据库文件，性能更高，适合本地 Docker 挂载场景
• api 模式通过 Emby 插件接口穿透查询，部署最轻量，适合无法挂载数据库的环境

Telegram 配置

• tg_bot_token：Telegram Bot Token
• tg_chat_id：接收主动通知的目标聊天 ID
• proxy_url：Telegram 网络代理，可选

支持能力：

• 播放开始 / 停止推送
• 入库通知推送
• 报表推送
• 机器人指令交互

注意事项

1.Emby必须安装 Playback Reporting 插件！

无论使用本地模式还是 API 模式，Emby 都必须安装此官方插件以生成历史播放流水。

2.Emby-Pulse管理员账户，即emby管理员账户