Repolode
提交项目
av1155

av1155/houndarr

自托管工具，为 Radarr、Sonarr 等 *arr 应用慢速、有节制地搜索缺失和未达标的媒体。

在 GitHub 查看官网
Star
307
Fork
4
未关闭 Issue
12
最近提交
前天

这是什么？

Houndarr 是面向 *arr 媒体栈的自动化搜索工具。Radarr、Sonarr、Lidarr、Readarr 和 Whisparr 主要监听 RSS 上的新资源，不会主动回头搜索库中已缺失或未达到质量截止线的内容；而内置的“全部搜索”会一次性发出大量请求，容易超出索引器的 API 限制。

Houndarr 以小批量方式逐步处理积压内容，周期之间有休眠间隔，并支持单项冷却时间和每个实例的每小时 API 上限。下载队列满时可自动跳过本轮，也可以限定搜索只在指定时段进行。它以单个 Docker 容器运行，提供基于 FastAPI 和 HTMX 的网页界面，包括实时仪表盘、可筛选的日志查看器，并支持连接多个实例。

除了向已配置的 *arr 实例发送只读请求和搜索命令外，Houndarr 不会与其他服务通信。它不管理下载客户端，也不直接对接 Prowlarr 或索引器，实例 API 密钥以加密形式存储。

核心功能

  • 01覆盖 Radarr、Sonarr、Lidarr、Readarr 和 Whisparr 的缺失、未达截止线及可升级内容搜索
  • 02小批量、可配置的搜索，支持周期休眠、单项冷却和每小时 API 上限
  • 03下载队列满时自动跳过，并可为每个实例设置允许搜索的时间段
  • 04每个实例可选择随机或按时间顺序搜索
  • 05网页仪表盘支持立即运行，日志可筛选和导出
  • 06以单个 Docker 容器运行，并提供 Helm Chart

适用场景

  • 在不触发索引器频率限制的前提下，逐步处理大量缺失的电影或剧集
  • 在设定的时间段内（如夜间）运行达标升级搜索
  • 通过一个仪表盘监控多个 Sonarr 和 Radarr 实例

快速上手

  1. 1

    创建包含 Houndarr 服务定义的 docker-compose.yml 文件

  2. 2

    使用 Docker Compose 启动 Houndarr

    docker compose up -d
  3. 3

    打开 http://<your-host>:8877 网页界面并创建管理员账户

使用前须知

  • 需要运行 Docker，并连接到你现有的 Radarr、Sonarr、Lidarr、Readarr 或 Whisparr 实例。
  • 采用 AGPL-3.0 许可证，这是一种 copyleft 许可证，分发或网络托管修改版本时需要公开源代码。

收录于专题

自托管应用

标签

#media-automation#self-hosted#sonarr#radarr#docker#fastapi#htmx#python

常见问题

houndarr 是什么？
自托管工具，为 Radarr、Sonarr 等 *arr 应用慢速、有节制地搜索缺失和未达标的媒体。 Houndarr 是面向 *arr 媒体栈的自动化搜索工具。Radarr、Sonarr、Lidarr、Readarr 和 Whisparr 主要监听 RSS 上的新资源，不会主动回头搜索库中已缺失或未达到质量截止线的内容；而内置的“全部搜索”会一次性发出大量请求，容易超出索引器的 API 限制。
houndarr 可以免费使用吗？用的什么许可证？
houndarr 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
houndarr 还在维护吗？
活跃维护中。houndarr 最近一次提交是在 2026年11月5日。
houndarr 适合用来做什么？
在不触发索引器频率限制的前提下，逐步处理大量缺失的电影或剧集 在设定的时间段内（如夜间）运行达标升级搜索 通过一个仪表盘监控多个 Sonarr 和 Radarr 实例
houndarr 怎么安装和运行？
创建包含 Houndarr 服务定义的 docker-compose.yml 文件 使用 Docker Compose 启动 Houndarr: docker compose up -d 打开 http://<your-host>:8877 网页界面并创建管理员账户
在哪里获取 houndarr？
源代码和安装说明在 GitHub 上：https://github.com/av1155/houndarr

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目