什么是Admirarr
Admirarr 是一款专为自托管媒体服务器栈设计的命令行工具，旨在简化 Jellyfin、Plex 与 *Arr（Radarr、Sonarr 等）生态系统的管理流程。它以单一二进制文件的形式提供，支持 26 个命令，覆盖从服务监控到内容添加的全链路操作。无论你是使用 Docker Compose、Kubernetes 还是直接部署，Admirarr 都能自动检测你的媒体服务器类型（优先识别 Jellyfin，其次为 Plex），并通过 HTTP 接口统一管理后端服务。其设计哲学强调简洁性与可操作性：所有输出默认为结构化的 JSON 格式，便于脚本集成；同时，交互式模式则让新手也能轻松完成复杂任务，如添加电影或配置索引器。 该工具的核心优势在于将分散在多个 Web UI 中的功能整合到一个统一的 CLI 中，避免了频繁切换不同管理界面的繁琐。例如，你可以通过一个 `admirarr status` 命令快速查看所有服务的运行状态、磁盘使用情况、队列进度以及容器健康度；而 `doctor` 命令则能执行超过 30 项诊断检查，并尝试自动修复常见问题，剩余问题则可交由 AI 助手进一步处理。此外，Admirarr 还支持对下载客户端（如 qBittorrent）、索引器（Prowlarr）、质量配置文件（Recyclarr）等进行细粒度控制，确保整个媒体流水线高效运转。 值得一提的是，Admirarr 不仅适用于技术娴熟的用户，也充分考虑了普通家庭用户的易用性。它内置完整的设置向导（setup），可在 12 个步骤内完成从零开始的部署；对于高级用户，则提供了丰富的自动化选项，比如通过 `recyclarr sync` 批量更新质量策略，或通过 `migrate` 生成标准化的 Docker Compose 文件。整个项目完全开源，社区活跃，持续迭代新功能与优化体验。
核心功能特点
- 一键式媒体服务器栈状态概览：实时展示 Jellyfin/Plex、Radarr/Sonarr、qBittorrent 等服务运行状态、队列进度与磁盘占用情况
- 智能诊断与自动修复：执行 34 项健康检查，涵盖数据库连接、API 响应、索引器连通性等关键指标，并提供部分问题的自动解决方案
- 全链路内容管理：支持搜索、添加电影/剧集、查看缺失条目、追踪下载进度及导入队列，实现从请求到入库的端到端操作
- 灵活的部署适配：自动识别 Jellyfin 或 Plex 为主服务器，兼容 Docker 与非容器化部署方式，无需手动配置
- 安全可靠的交互设计：所有破坏性操作均需用户确认，绝不擅自删除文件或修改 *Arr 数据库，保障数据安全
适用场景
Admirarr 特别适合那些搭建了自己的家庭媒体中心、希望摆脱多个独立 Web 界面切换困扰的用户。当你需要快速了解整个媒体服务器栈的整体健康状况时，只需运行 `admirarr status` 即可获得一张清晰的仪表盘视图，包括各服务的在线状态、当前正在处理的下载任务、媒体库扫描进度以及存储空间余量。这对于定期维护或排查故障尤其有用，比如发现某个 Radarr 实例无响应后，可以立即用 `restart radarr` 恢复服务，再通过 `doctor` 验证是否彻底解决。 在日常内容添加方面，Admirarr 大幅提升了效率。传统上，用户必须先在 Prowlarr 中搜索种子，再到 Radarr 手动添加，过程繁琐且容易出错。现在，通过 `add-movie “Inception”` 命令，系统会先调用 Prowlarr 进行全局搜索，列出匹配结果供你选择，然后自动提交至 Radarr 并返回任务 ID。整个过程无需离开终端，配合 `downloads` 和 `queue` 命令还能实时监控后续流转状态，形成闭环管理。 对于追求自动化运维的技术爱好者，Admirarr 提供了强大的脚本集成能力。所有命令均默认输出 JSON，方便与其他工具链结合。例如，你可以编写定时任务每天凌晨执行 `health` 检查，若发现异常则触发邮件告警；或者利用 `recyclarr sync` 每周自动同步最新的质量配置文件，确保 Radarr/Sonarr 始终采用最优设置。这种高度可定制的特性使其成为构建个人媒体自动化系统的理想基础设施。