arr-all

🎬 一站式媒体库管理终端

OpenClaw官方出品的*arr媒体管理统一CLI工具,安全整合Radarr/Sonarr/Lidarr三大服务,实现电影、剧集、音乐的一站式搜索添加与监控。

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

使用说明

核心用法

arr-all 是一款面向媒体收藏爱好者的统一命令行管理工具,将 Radarr(电影)、Sonarr(电视剧)、Lidarr(音乐)三大 *arr 系列应用整合为单一入口。用户通过 arr-all <type> <action>> 的简洁语法即可完成跨平台的媒体搜索、添加、监控和删除操作。核心工作流包括:使用 search 查找目标内容获取 ID,通过 add 将内容加入对应服务,借助 calendar 查看即将发布的媒体,以及利用 health 监控各服务运行状态。工具支持统一配置文件管理多服务凭证,也兼容传统独立配置,降低了多实例部署的维护成本。

显著优点

一体化体验:告别在三个独立界面间切换的繁琐,单命令即可完成跨平台操作,显著提升媒体管理效率。智能搜索聚合arr-all search 可同时在三大库中检索,快速定位用户所需内容。灵活的监控策略:针对电视剧支持按季监控、最新集追踪等精细控制;音乐库支持整碟或精选集添加。日历整合视图:将电影上映、剧集更新、专辑发布统一呈现,便于规划观看/收听计划。健康状态巡检:一键检查所有服务连接状态、磁盘空间和队列积压,及时发现潜在问题。

潜在缺点与局限性

本地部署依赖:必须自行搭建 Radarr/Sonarr/Lidarr 服务集群,对新手有一定门槛。无远程访问能力:仅支持调用用户配置的本地服务 URL,无法直接对接云端托管实例。功能深度受限:相比各服务的原生 Web UI,部分高级功能(如自定义格式、质量配置微调)可能无法覆盖。Bash 环境绑定:依赖 curl/jq 等 Unix 工具链,Windows 用户需借助 WSL 或 Git Bash 运行。

适合的目标群体

NAS/Homelab 玩家:已部署 arr 套件的媒体库管理员,追求高效自动化运维。命令行爱好者:偏好终端工作流、追求操作效率的技术用户。多服务管理者:同时维护电影、剧集、音乐三类库的重度收藏者。自动化集成需求者*:希望将媒体管理纳入脚本工作流或 CI/CD 管道的开发者。

使用风险

配置泄露风险:API 密钥以明文存储于本地 JSON 文件,需确保 ~/.openclaw/credentials// 目录权限严格限制(建议 700)。服务可用性依赖:工具本身不提供服务高可用保障,后端 arr 服务宕机将直接导致操作失败。网络配置复杂性:若服务部署于 Docker 或远程主机,URL 配置错误可能导致连接超时,需正确理解容器网络或反向代理设置。版本兼容性arr 应用 API 升级可能引入破坏性变更,需关注技能版本更新。

安全解读

核心用法

arr-all 是一个统一的命令行接口,将 Radarr(电影)、Sonarr(剧集)、Lidarr(音乐)三大 *arr 系列媒体管理工具整合为单一 CLI 工具。用户通过 arr-all <type> <action> 的固定格式执行操作:

基础操作search(搜索)、add(添加)、exists(检查存在)、remove(删除)、config(配置管理)
跨类型功能calendar(查看即将发布内容)、health(健康状态)、status(连接状态)、全局搜索

各类型特性

  • Movie:支持收藏集添加
  • TV:灵活的监控策略(latest/all/none/指定季)、季管理
  • Music:支持整张唱片添加、专辑监控

配置采用 JSON 文件驱动,优先使用统一配置 ~/.openclaw/credentials/arr-all/config.json,兼容旧版独立配置路径。

显著优点

1. 统一体验:告别三个独立 CLI 的学习成本,一套命令语法管理三种媒体类型
2. 跨类型视图calendar 命令聚合展示三库即将发布内容,search 全局检索避免重复查询

3. 健康监控:单命令检查所有服务状态,适合自动化运维和定时任务

4. 监控策略灵活:TV 支持细粒度到季的监控控制,Music 支持唱片集批量操作

5. 纯 Bash 实现:仅依赖系统标准工具(curl、jq),无第三方包,部署极简

潜在局限

  • 本地服务依赖:必须与用户自托管的 *arr 实例通信,无法独立运行
  • 无交互式界面:纯 CLI 设计,不支持 TUI 或图形化浏览
  • API 密钥管理:需手动配置 JSON 文件,无内置配置向导或密钥加密
  • 网络超时缺省:curl 未默认设置超时,网络异常时可能挂起(建议按报告添加参数)

适合人群

  • 已自建 Radarr/Sonarr/Lidarr 服务的媒体库管理者
  • 偏好命令行效率、需要脚本自动化的高级用户
  • 希望在终端快速增删查改、查看发布日历的 *arr 重度用户

常规风险

  • 配置文件权限:API 密钥以明文存储于用户目录,若权限设置不当(全局可读)存在泄露风险
  • 临时文件安全:日历聚合使用 /tmp/ 下的 PID 命名文件,虽无敏感数据,但建议改用 mktemp
  • URL 配置信任:工具完全信任用户配置的本地 URL,若误配指向恶意服务可能遭受中间人攻击
  • 无输入长度限制:搜索查询虽经 URL 编码,但无长度/字符白名单校验,极端输入可能影响稳定性

安全评级依据

根据 CLS-Certify 报告:静态分析 88 分(无危险函数)、动态分析 82 分(纯本地 API)、依赖审计 95 分(零第三方依赖)、网络分析 80 分(仅本地通信)。符合 GDPR 数据最小化原则,无硬编码密钥、无隐蔽外传。主要扣分项为临时文件命名规范和缺少超时设置,均属可改善的建议性项。

arr-all 内容

hooks文件夹
scripts文件夹
lib文件夹
手动下载zip · 12.7 kB
health-check.shtext/x-shellscript
请选择文件