prowlarr

🔍 一站式索引聚合搜索管理工具

集成 Prowlarr API 的专业资源索引管理方案,支持跨站搜索、健康监控及自动化同步,为媒体库管理提供高效可靠的源头保障。

收藏
6.2k
安装
2.5k
版本
v1.0.0
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

Prowlarr Skill 是一款专为资源索引管理设计的自动化工具,通过封装 Prowlarr API 提供统一的命令行操作界面。用户可通过简单的指令跨多个索引器执行精准搜索,涵盖 Torrent 和 Usenet 双协议资源,支持按电影、电视、音频、书籍等分类筛选,并能通过 TVDB 或 IMDB ID 进行精确匹配查询。

核心用法围绕资源搜索与索引器管理展开。基础搜索支持关键词模糊匹配,配合 --torrents--usenet 参数可限定协议类型;高级场景下,结合分类 ID(如 2000 代表电影、5000 代表电视)可实现精细过滤。对于剧集和电影,分别提供 tv-searchmovie-search 子命令,支持通过外部元数据 ID 精确查找特定季集或影片。索引器管理方面,支持查看状态统计、健康检查、启用/禁用配置,并能一键同步至 Sonarr、Radarr 等关联应用,实现媒体库管理链条的自动化衔接。

显著优点体现在操作的标准化与安全性。该 Skill 采用 Bash 脚本实现,严格遵循安全编码规范,使用 set -euo pipefail 确保健壮性,通过 URI 编码和参数校验有效防止注入攻击。所有敏感操作(如删除索引器)均需显式执行,且 API Key 通过独立配置文件管理,避免硬编码风险。功能覆盖全面,从资源检索到索引器健康监控,再到与 *arr 生态系统的同步,形成完整的管理闭环。

潜在局限性主要在于部署门槛。用户需自行搭建并维护 Prowlarr 实例,配置 URL 和 API Key 后方可使用,对新手存在学习成本。此外,作为 T3 级社区来源,虽代码质量达到 A 级安全标准,但缺乏官方商业支持,长期维护依赖社区贡献。功能上专注于索引管理层,不直接提供下载能力,需配合下载客户端使用。

适合的目标群体包括自建媒体服务器(HTPC)用户、*arr 系列工具的重度使用者,以及需要批量管理索引器的高级玩家。对于经常跨站搜索特定资源、需要监控索引器健康状态或希望自动化同步配置的用户尤为实用。

使用风险相对可控,但仍需注意:delete 命令会永久移除 Prowlarr 中的索引器配置(非本地文件),操作不可逆;配置文件的权限应设为 600 防止 API Key 泄露;访问不可信的第三方 Prowlarr 实例可能导致安全风险。性能方面,搜索速度受限于索引器响应时间和网络状况,大规模查询可能存在延迟。

安全解读

核心用法

Prowlarr Skill 是一款面向自托管媒体库用户的命令行工具,通过 Bash 脚本封装 Prowlarr 的 REST API,实现索引器统一管理。核心功能包括:

  • 智能搜索:支持关键词搜索(search)、TVDB ID 精准剧集搜索(tv-search)、IMDB ID 电影搜索(movie-search),可按类别(2000=电影、5000=剧集等)、协议(torrent/usenet)过滤
  • 索引器运维:列出索引器、查看状态统计、批量健康检测、启用/禁用/删除索引器
  • 生态同步:一键将索引器配置同步至 Sonarr/Radarr/Lidarr 等关联应用

显著优点

1. 零依赖安全架构:仅依赖系统标准工具 curl 与 jq,无第三方包管理风险,供应链攻击面趋近于零
2. 配置与代码分离:API 密钥通过本地 JSON 文件读取,无硬编码敏感信息,符合安全最佳实践

3. 功能精准匹配:声明功能与实际行为完全一致,无隐藏网络调用或数据收集

4. 轻量透明:319 行代码/4 个文件,结构清晰易于人工审计

潜在局限

  • 来源可信度 T3:开发者 jmagar 为个人 GitHub 账号,非知名组织或基金会背书,需关注后续更新
  • TLS 配置依赖用户:API 通信加密质量取决于用户配置的 URL 协议(HTTP vs HTTPS),工具本身不强制校验
  • 平台限制:Bash 脚本环境,Windows 需 WSL 或 Git Bash 支持
  • 无交互式界面:纯命令行操作,对非技术用户有一定门槛

适合人群

  • 已部署 Prowlarr + *arr 全家桶的自托管媒体库用户
  • 偏好 CLI 工作流、追求极简依赖的技术用户
  • 重视供应链安全、希望避免 Node/Python 依赖树的场景

常规风险

  • API 密钥泄露:若配置 HTTP 而非 HTTPS 地址,密钥可能在传输中被截获(OBS-001)
  • 个人开发者维护风险:代码虽安全透明,但长期维护稳定性不及知名组织项目
  • 配置误操作delete/disable 等管理命令无二次确认,误执行可能影响下载流程

安全评估结论

安全等级 A(80 分),静态分析 85 分、动态行为 80 分、依赖审计 95 分、网络分析 75 分、隐私合规 85 分、威胁情报 70 分。符合 GDPR 数据最小化原则,无硬编码密钥,通过所有关键合规检查。建议在生产环境使用前验证 TLS 配置,并订阅仓库 Release 通知以便审查更新。

prowlarr 内容

scripts文件夹
手动下载zip · 5.1 kB
prowlarr-api.shtext/x-shellscript
请选择文件