💡 NEXT 版 是 EmbyPulse-pro 的安全分支，解锁pro全部功能。 NEXT版基于原作者泄露的pro版 1.3.55-beta 修改而来，修复了所有重大安全问题，兼容直接从原作者版升级。但由于原作者代码质量非常差，仍需要大量重构修改，为尊重原作者的劳动成果和避免其他问题。不再维护时会开源。会制作迁移工具到其他面板。
- 全局搜索：本地库 + 影巢资源一键切换搜索
- TMDB 联动：自动匹配海报、背景图、简介信息
- 一键转存：支持直接转存到 115 网盘指定目录
- 拼音穿透：本地搜索支持拼音首字母快速定位
- 并发检测：实时监控多设备并发播放，自定义阈值
- 违规拦截：自动识别异常账号，支持警告/封禁/踢下线
- VIP 豁免：VIP 用户可跳过风控检测
- 执法记录：完整的封禁/解封操作日志追溯
- 每日签到：随机积分奖励，激励用户活跃
- 积分商城：兑换账号续期、邀请码等
- 消费扣费：求片扣费、自定义消费场景
- 多种风格：动漫风、幽默风、简约风等预设模板
- 完全自定义：支持所有变量字段自由组合
- 随机文案：同类型通知多条模板随机切换
- TMDB 热门：自动同步 TMDB 热门/高分电影、剧集
- 正在热播：追踪正在连载中的剧集
- 自动更新：定时同步，保持合集新鲜度
- 播放要求：设置每月最低播放时长/天数
- 自动处理：不达标自动警告或禁用账号
- VIP 豁免：VIP 用户可豁免保号规则
- 邮箱验证：注册时邮箱验证码确认
- 密码重置：通过邮件重置密码
- 系统通知：重要事件邮件推送
- 智能扫描：识别重复的电影/剧集资源
- 多维对比：分辨率、码率、编码、HDR 等
- 推荐删除：自动标记低质量资源
- 实时并发播放监控，IP 归属地精确显示
- 资源概览：电影、剧集、单集总数统计
- 播放趋势：ECharts 动态图表，按天/周/月分析
- 系统状态：CPU、内存、存储实时监控
- 全库扫描：智能比对 Emby 库存与 TMDB 数据
- 精准定位：识别已上线但库内缺失的集数
- MoviePilot 联动：一键搜索，智能匹配版本
- 下载截胡：推送整季包时自动剔除已有集数
- 状态同步：入库后自动核销，焦点唤醒刷新
- 全球热播剧集更新时间表
- 红绿灯状态：🟢 已入库 / 🔴 缺失
- 一键跳转播放或复制搜索指令
- 用户提交电影/剧集/季度请求
- 完整状态链路：待处理 → 已下载 → 已入库 / 已拒绝
- 入库自动闭环，通知用户
- 机器人协同：Telegram 求片交互
- 账号信息、到期时间、VIP 标识
- 用户画像：成就勋章、观影偏好分析
- 行为追溯：播放历史、活跃趋势
- 用户画像：深夜修仙、全平台制霸等趣味成就
- 入驻溯源：精确显示账号注册天数
- 画质审计：4K/HDR/杜比视界占比分析
- 低质筛选：自动标记 SD/480P 资源
- 多维报表：日报、周报、月报、年度总结
- 精美主题：黑金、赛博、极光、落日等风格
- 一键生成长图，支持 Telegram 自动推送
- 生成邀请链接，设置有效期
- 用户自助注册，无需管理员干预
- 账号自动到期、批量续期管理
- 实时推送：播放开始/停止、入库通知
- 风控告警：并发违规、异常登录提醒
- 交互指令：
/stats统计、/search搜片、/check诊断 - 客户端拦截：自动踢出黑名单客户端
- 任务管理：可视化管理 Emby 计划任务
- 实时日志：网页端查看系统日志
- 数据库工具：完整性检测、一键修复、备份恢复
- 系统诊断：配置检查、连接测试
- 全站用户播放流水记录
- IP 归属地精确查询（IPv4/IPv6）
- 用户头像、设备信息展示
Pro 版内置多个功能插件：
| 插件 | 功能 | 说明 |
|---|---|---|
| 影巢资源 | 资源搜索 + 115 转存 | 全局搜索集成，一键转存 |
| 115网盘 | 链接自动转存 | 管理员发送链接自动转存 |
| 保号规则 | 播放时长达标检测 | Pro 专享 |
| 通知模板 | 自定义通知风格 | 动漫风、幽默风等 |
| 智能合集 | TMDB 热门合集 | Pro 专享 |
本仓库镜像通过 GitHub Actions 自动构建并发布到 GHCR（GitHub Container Registry），支持
linux/amd64与linux/arm64。
镜像地址：
| 镜像 | 说明 |
|---|---|
ghcr.io/amlkiller/emby-pulse:latest |
本仓库（amlkiller）最新稳定版 |
ghcr.io/amlkiller/emby-pulse:1.5.0 |
锁定具体版本 |
zeyu8023/embypulse-pro:latest |
上游官方镜像 |
EmbyPulse-next物理隔离了两个端口，分别承载不同角色：
| 端口 | 角色 | 说明 |
|---|---|---|
10307 |
管理端口（admin portal） | 主仪表盘、运维工具、所有管理 API |
10308 |
用户端口（user portal） | 仅对邀请/求片等公开页面开放，物理隔离 |
如只对外开放注册 / 求片，只暴露 10308 即可，10307 留在内网，安全性更高。
仓库根目录已提供完整 docker-compose.yml 模板，直接修改卷路径与环境变量即可：
version: '3.8'
services:
embypulse-pro:
image: ghcr.io/amlkiller/emby-pulse:latest
container_name: embypulse-pro
restart: unless-stopped
ports:
- "10307:10307" # 管理端口（建议仅内网暴露）
- "10308:10308" # 用户端口（可对外）
volumes:
- ./config:/workspace/config # 配置文件目录
- ./data:/workspace/data # 数据库与持久化目录
# - /path/to/emby/data:/emby-data # API 模式下可不挂载数据库
environment:
- TZ=Asia/Shanghai
- EMBY_HOST=http://192.168.x.x:8096 # 必填：用于登录校验 Emby 管理员账号
# - PORT=10307 # 管理端口（默认 10307）
# - REQUEST_PORT=10308 # 用户端口（默认 10308）
# - DB_PATH=/emby-data/playback_reporting.db # 本地模式必填
# - CORS_ORIGINS=https://your.domain # 不设置默认拒绝跨域
# - FORCE_MIGRATE=1 # 强制迁移系统数据库
# 推荐使用 env_file 注入 EMBY_API_KEY / TG_BOT_TOKEN / TMDB_API_KEY / WEBHOOK_TOKEN
# env_file:
# - ./.env
⚠️ 反向代理 / CSRF 必读：1.4.x 起所有 POST/PUT/DELETE/PATCH 请求都会进行严格的同源校验 （app/core/csrf_middleware.py）。如果你通过 Nginx / Caddy / Traefik 反代访问，必须 让反代下发以下头部，否则浏览器的Origin/Referer会与容器内部base_url不一致， 提交任何表单都会收到403 CSRF 验证失败：Origin 不匹配：
X-Forwarded-Proto：http或https（必须与浏览器栏一致）X-Forwarded-Host：用户访问的真实域名（可含端口）X-Forwarded-Port：非默认端口时务必下发示例（Nginx）：
proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Port $server_port;直连访问（
http://ip:10307、http://ip:10308）无需任何额外配置。
| 变量 | 说明 | 默认值 | 必填 |
|---|---|---|---|
TZ |
时区设置 | Asia/Shanghai |
推荐 |
PORT |
管理端口 | 10307 |
可选 |
REQUEST_PORT |
用户端口 | 10308 |
可选 |
DB_PATH |
Playback Reporting 数据库路径 | - | 本地模式必填 |
EMBY_HOST |
Emby 服务器 URL（可后台填写） | - | 推荐 |
EMBY_API_KEY |
Emby API Key（敏感字段，建议环境变量） | - | 推荐 |
SECRET_KEY |
会话加密密钥（未设置时自动生成） | - | 可选 |
CORS_ORIGINS |
允许跨域来源，逗号分隔；未设置即拒绝所有跨域 | - | 可选 |
FORCE_MIGRATE |
强制迁移系统数据库 | 0 |
可选 |
AUTO_MIGRATE_DB |
启动时自动迁移 | 0 |
可选 |
🔐 安全提示：
EMBY_API_KEY、TG_BOT_TOKEN等敏感字段优先从环境变量读取；若通过环境变量设置，将自动从磁盘配置文件中清除。
方式一：使用 ports 映射（推荐）
ports:
- "8080:10307" # 主机 8080 → 容器 10307（管理）
- "8081:10308" # 主机 8081 → 容器 10308（用户）方式二：使用 network_mode: host
network_mode: host # 直接使用主机网络，无需端口映射
# 此时服务监听 PORT / REQUEST_PORT 指定的端口| 模式 | 配置 | 适用场景 |
|---|---|---|
| API 模式 | 不设置 DB_PATH |
极空间、云服务器、无法挂载数据库 |
| 本地模式 | 设置 DB_PATH |
本地 Docker、可挂载 Emby 数据目录 |
当系统数据库结构发生变化时，可通过设置 FORCE_MIGRATE=1 强制执行数据库迁移：
environment:
- FORCE_MIGRATE=1 # 启动时强制迁移
⚠️ 迁移会自动备份原数据库，但建议在操作前手动备份data/目录
| 配置项 | 说明 |
|---|---|
emby_host |
Emby 服务器地址 |
emby_api_key |
Emby API Key |
webhook_token |
Webhook 安全校验令牌 |
emby_public_url |
对外访问 Emby 的公网地址 |
推荐在 Emby Webhook 插件中使用 Header 传递令牌：
| 配置项 | 值 |
|---|---|
| URL | https://你的域名/api/v1/webhook |
| Header | X-Webhook-Token: 你的 webhook_token |
如果插件或环境不方便配置 Header，也兼容 URL 参数方式：
https://你的域名/api/v1/webhook?token=你的 webhook_token
| 配置项 | 说明 |
|---|---|
hdhive_api_key |
影巢 API Key，从 hdhive.com 获取 |
| 配置项 | 说明 |
|---|---|
risk_max_concurrent |
最大并发数限制 |
risk_action |
违规处理方式：warn_only / warn_user / auto_ban |
risk_vip_exempt |
VIP 用户豁免开关 |
| 配置项 | 说明 |
|---|---|
tg_bot_token |
Telegram Bot Token |
tg_chat_id |
推送目标聊天 ID |
proxy_url |
网络代理（可选） |
| 配置项 | 说明 |
|---|---|
tmdb_api_key |
TMDB API Key，用于缺集扫描、合集同步 |
| 配置项 | 说明 |
|---|---|
moviepilot_url |
MoviePilot 服务地址 |
moviepilot_token |
MoviePilot API Token |
| 配置项 | 说明 |
|---|---|
client_type |
下载器类型：qb / tr |
client_url |
下载器地址 |
client_user |
下载器账号 |
client_pass |
下载器密码 |
A: 是的。无论使用本地模式还是 API 模式，Emby 都必须安装此官方插件以生成播放历史数据。
A:
- 本地模式：直接读取数据库文件，性能最高，适合能挂载目录的 Docker 环境
- API 模式：通过 API 穿透查询，部署最简单，适合无法直接映射文件的环境
A: Pro 版独占影巢资源集成、风险管控、积分系统、自定义通知模板、智能合集、保号规则、邮件系统等功能。
A: 登录 hdhive.com 后，进入个人设置 > API 管理创建。
A: 不会。风控仅检测异常行为，正常使用不受影响。VIP 用户可设置豁免。
A: 系统工具页面底部有 Debug 模式开关，开启后可查看详细请求日志。
A: 管理端口（10307）承载所有运维 API 与 Cookie 会话，对外暴露风险大；用户端口（10308）只挂载邀请注册、求片等公开页面，物理隔离后即使被扫描也无法触达管理面。
A: 反代未把浏览器看到的真实域名/协议传到容器内部。请在 Nginx / Caddy / Traefik
等反向代理上下发 X-Forwarded-Proto、X-Forwarded-Host（非默认端口再加
X-Forwarded-Port）。中间件位于 app/core/csrf_middleware.py，会用这三个头
组合出"合法源"用来对比 Origin / Referer，缺一不可。
# 1. 安装锁定依赖（推荐使用 uv）
uv sync --locked
# 2. 复制并填写环境变量
cp .env.example .env
# 3. 启动
uv run python run.py
# 或：uv run uvicorn app.main:app --host 0.0.0.0 --port 10307运行测试：
uv run pytest tests/ -vWindows 控制台输出含 Emoji，建议设置
PYTHONIOENCODING=utf-8以避免 GBK 编码错误。
如果您觉得 EmbyPulse-next 好用，欢迎赞赏支持作者的持续迭代！
本项目基于 MIT 许可证开源，附加条款：
- 二次开发必须保持开源
- 需保留原项目版权声明
- 禁止闭源封装或商业销售