JudoChinX/rangarr

这是什么？

核心功能

• 01用一个服务统一管理 Radarr、Sonarr、Lidarr、Readarr、Whisparr v2 和 v3。
• 02在全局范围内分配搜索名额，并在各实例之间交替发起请求。
• 03缺失项搜索和升级搜索使用独立的执行计划。
• 04Sonarr 与 Whisparr v2 支持按季打包搜索，仍在播出的季回退为单集搜索。
• 05找出未达到自定义格式分数目标的条目，弥补 Cutoff Unmet 接口的遗漏。
• 06可按标签过滤搜索范围，并限制在指定的活动时段内运行。

适用场景

• 在大型 Radarr 和 Sonarr 资料库中，避免共享索引器被大量搜索请求压垮。
• 高频查找缺失内容，同时降低升级检查的频率。
• 将自动搜索限制在夜间时段，避开索引器的高峰负载。
• 与现有的 *arr 容器一起在 Docker Compose 中部署。

快速上手

1. 1

   从仓库下载示例 config.yaml 和 compose.yaml，重命名并设置文件权限

2. 2

   在 config.yaml 中填写你的 *arr API 密钥和主机名

   nano config.yaml
3. 3

   使用 Docker Compose 启动 Rangarr（在日志正常之前保持 dry_run: true）

   docker compose up -d

使用前须知

• !你需要已有的 Radarr、Sonarr、Lidarr、Readarr 或 Whisparr 实例及其 API 密钥。
• !配置工作量较大，需要手写 config.yaml 或设置大量环境变量。

收录于专题

标签

常见问题

rangarr 是什么？

在 Radarr、Sonarr、Lidarr、Readarr 和 Whisparr 之间错峰、交替执行自动搜索的编排服务，减轻索引器和 API 压力。 Rangarr 是一个轻量级编排服务，用于协调多个 *arr 实例的自动媒体搜索，支持 Radarr、Sonarr、Lidarr、Readarr 以及 Whisparr v2 和 v3。它不会让各实例同时发起搜索，而是统一分配搜索名额，在实例之间及共享的索引器之间交替请求，并错开时间间隔，避免索引器和 API 限额被打满。

rangarr 可以免费使用吗？用的什么许可证？

rangarr 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

rangarr 还在维护吗？

活跃维护中。rangarr 最近一次提交是在 2026年10月10日。

rangarr 适合用来做什么？

在大型 Radarr 和 Sonarr 资料库中，避免共享索引器被大量搜索请求压垮。 高频查找缺失内容，同时降低升级检查的频率。 将自动搜索限制在夜间时段，避开索引器的高峰负载。 与现有的 *arr 容器一起在 Docker Compose 中部署。

rangarr 怎么安装和运行？

从仓库下载示例 config.yaml 和 compose.yaml，重命名并设置文件权限 在 config.yaml 中填写你的 *arr API 密钥和主机名: nano config.yaml 使用 Docker Compose 启动 Rangarr（在日志正常之前保持 dry_run: true）: docker compose up -d

在哪里获取 rangarr？

源代码和安装说明在 GitHub 上：https://github.com/JudoChinX/rangarr