Jellyseerr

核心功能与用法

Jellyseerr 技能为自建媒体服务器用户提供一站式的内容请求管理方案。核心能力包括：

• 智能请求：支持电影/剧集的精准搜索与自动提交，可指定具体季数
• 多渠道通知：Webhook 实时推送或 cron 轮询监测，确保不错过内容可用状态
• 灵活配置：支持自动审批、自定义服务器地址与 API 密钥管理

显著优点

• 生态整合：深度对接 Jellyseerr + *arr 下载生态，实现从请求到观看的闭环
• 轻量部署：纯脚本方案，无需复杂容器配置即可运行
• 权限可控：auto_approve 等配置项让管理员灵活把控请求审核流程

潜在局限与风险

• 依赖外部基础设施：需自建 Jellyseerr 服务器及配套的下载器（Sonarr/Radarr）、存储阵列
• 版权灰色地带：自动化下载涉及版权内容获取，存在法律合规风险
• 暴露面扩大：Webhook 服务需开放端口，若配置不当可能成为攻击入口
• API 密钥泄露风险：配置文件以明文存储密钥，多用户环境需严格权限管控

适合人群

• 已部署 Jellyfin/Plex + *arr 全家桶的进阶家庭影院用户
• 熟悉 Linux 命令行与 crontab 运维的技术爱好者
• 小团队/家庭共享场景的管理员，需集中处理多成员的观影请求

常规风险提示

• 确保 Jellyseerr 服务器使用 HTTPS 与强认证
• Webhook 端口建议限制来源 IP，避免公网裸奔
• 定期检查 ~/.config/jellyseerr/config.json 的权限（建议 600）

核心用法

Jellyseerr 是一款面向自托管媒体服务器（Plex/Jellyfin）用户的自动化资源请求工具。用户通过 CLI 脚本与 Jellyseerr 服务器交互，完成影视内容搜索、请求提交及可用性监控。主要功能模块包括：

• 媒体请求：request_movie.py 与 request_tv.py 支持电影单部请求及电视剧全季/单季请求
• 内容搜索：search.py 提供 Jellyseerr 索引库的实时检索
• 状态追踪：track_requests.py 可查看待处理请求的下载进度
• 自动通知：通过 webhook 服务器或 cron 轮询实现"资源可用即通知"

显著优点

1. 生态整合完善：深度集成 Jellyseerr → Sonarr/Radarr → 下载器 → Plex/Jellyfin 的完整自动化链路
2. 轻量无依赖：仅依赖 Python 标准库与 requests，无额外重型框架
3. 灵活通知机制：同时支持 webhook 即时推送与 cron 定时轮询，适配不同网络环境
4. 配置管理规范：遵循 XDG 规范，配置与缓存分离存储，文件权限 600 保护 API 密钥

潜在局限与风险

| 风险点 | 说明 | 缓解建议 |

|--------|------|---------|

| Webhook 暴露面 | 服务默认绑定 0.0.0.0:8384，全网可达 | 配置防火墙限制来源 IP，或改用 127.0.0.1 + 反向代理 |

| 明文传输 | 本地 webhook 使用 HTTP 无加密 | 内网使用或前置 HTTPS 代理 |

| T3 来源可信度 | 个人开发者维护，无企业背书 | 代码审查后在隔离环境测试 |

| 密钥长期有效 | API key 无自动轮换机制 | 建议每 3-6 个月手动更新 |

适合人群

• 已部署 Jellyseerr + *arr 系列工具的自托管媒体用户
• 熟悉 Linux CLI 与 cron 配置的进阶用户
• 具备基础网络安全意识，能配置防火墙/反向代理的技术爱好者

常规风险总结

该 skill 本身为透明 API 代理，不引入额外恶意行为。主要风险集中于部署配置阶段：Webhook 服务的网络暴露需用户主动加固，API 密钥的安全存储虽已实现文件级保护，但仍需避免配置文件备份泄露。建议生产环境搭配 fail2ban 或云防火墙使用。