ninthwalker/plexreport

plexReport Docker镜像

镜像概述

本镜像为bstascavage原始plexReport（https://github.com/bstascavage/plexReport%EF%BC%89%E7%9A%84Docker%E5%8C%96%E7%89%88%E6%9C%AC%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%94%9F%E6%88%90Plex%E5%AA%92%E4%BD%93%E5%BA%93%E6%96%B0%E5%A2%9E%E5%86%85%E5%AE%B9%E7%9A%84%E9%82%AE%E4%BB%B6%E6%91%98%E8%A6%81%E5%B9%B6%E5%8F%91%E9%80%81%E7%BB%99%E7%94%A8%E6%88%B7%E3%80%82

核心功能

• 生成Plex新增电影、剧集的邮件通知
• 支持Gmail作为邮件发送客户端
• 适配unRAID及其他Linux平台
• 可配置邮件内容格式、接收者列表
• 提供命令行选项调整通知细节（如详细模式、测试邮件等）

使用场景

• unRAID或Linux环境下的Plex服务器管理员，定期向用户推送新增媒体内容通知
• 测试邮件发送配置是否正确
• 自定义邮件格式以满足特定展示需求

配置说明

前提条件

1. 已部署Plex服务器
2. 电影分区使用themoviedb作为代理，剧集分区使用thetvdb.org作为代理
3. 拥有Gmail账号（仅支持Gmail作为邮件提供商）

安装（unRAID）

1. 推荐方式：从unRAID的Community Applications「APPS」板块安装
2. 手动方式：添加模板仓库到unRAID：https://github.com/ninthwalker/docker-templates/
3. 安装后执行初始设置（仅需一次）：

   bash
   docker exec -it plexReport ./initial_setup.sh
   

   按照提示完成配置。

运行命令

在unRAID中运行：

bash
docker exec plexReport plexreport [-options]

可编辑/config/config.yaml（及可选的email_body.erb）调整设置，参考/config/config.yaml.example。

定时任务（unRAID 6+）

1. 编辑plexreport appdata目录下的plexreport_schedule.cron设置定时时间
2. 复制文件到/boot/config/plugins/dynamix/
3. 立即生效：执行update_cron（无需重启unRAID）
   参考cron格式帮助：[***]

配置文件细节

• email_body.erb：可通过CSS/HTML修改邮件外观
• email：设置邮件标题（必填）、语言（ISO 639-1代码，默认en）
• plex：设置服务器IP（默认localhost）、API密钥（必填）、需报告的分区（可选）
• mail：设置SMTP地址（如smtp.gmail.com，必填）、端口（如587，必填）、发送者账号/密码（必填）、显示名称（必填）、主题（必填）、额外接收者（可选）

命令行选项

• -n, --no-plex-email：不向Plex好友发送邮件
• -l, --add-library-names：在影视名称前添加库名
• -t, --test-email：仅向Plex所有者发送测试邮件
• -d, --detailed-email：发送包含评分、演员等详细信息的邮件

效果示例

• 新增剧集：!alt tag
• 新增季数：!alt tag
• 新增电影：!alt tag
• 新增电影（详细视图）：!alt tag