clawarr-suite

核心用法

ClawARR Suite 是一款面向自托管媒体自动化生态的综合性管理工具，通过24个Bash脚本实现对*arr全家桶（Sonarr、Radarr、Lidarr、Readarr、Prowlarr、Bazarr）、Plex媒体服务器、Tautulli分析、SABnzbd下载器及配套服务的统一管控。核心工作流包括：① setup.sh自动发现服务并配置API密钥；② library.sh深度挖掘库统计与质量分析；③ manage.sh执行内容增删与监控；④ analytics.sh生成Plex观看行为洞察；⑤ dashboard.sh输出自包含HTML可视化面板；⑥ trackers.sh打通Trakt/Simkl/Letterboxd跨平台观影同步。

显著优点

生态完整性：覆盖从内容获取（Prowlarr索引器）、下载（SABnzbd）、整理（*arr系列）、字幕（Bazarr）、通知（Notifiarr）到展示（Plex/Kometa）的全链路，并集成Maintainerr自动清理、Recyclarr质量配置同步、Unpackerr自动解压等进阶工具。

运维效率：一键生成库健康报告、质量升级候选识别、磁盘使用分析、缺失内容追踪；支持Overseerr请求审批工作流自动化；HTML仪表板零依赖部署，适合家庭NAS场景。

数据可移植性：Trakt/Retraktarr双向同步实现观影记录云端备份，Letterboxd CSV导出满足影评社交需求，打破平台锁定。

兼容性设计：Bash 3.2兼容确保macOS原生支持，Docker/SSH混合架构适配Synology/Unraid等主流NAS平台。

潜在局限

环境依赖：需预配置15+服务的API密钥与网络可达性，初次部署门槛较高；SSH访问Docker容器要求特定权限模型。

功能边界：作为封装层而非原生API替代，复杂场景（如自定义质量配置逻辑）仍需直接操作*arr界面；Bash脚本性能在超大规模库（10万+条目）下可能成为瓶颈。

外部服务耦合：Trakt/Simkl集成依赖OAuth流程与第三方服务可用性，令牌过期需手动重新授权。

目标群体

• 家庭NAS/Homelab用户运行*arr媒体栈
• 追求"基础设施即代码"的自动化运维爱好者
• 需要跨平台观影记录同步的影视收藏者
• 小型媒体共享社群的管理员

使用风险

配置泄露风险：环境变量存储API密钥，若.env文件权限设置不当或误提交至版本控制将导致服务暴露。

误操作风险：manage.sh remove、、maintainerr.sh run`等命令涉及不可逆删除，虽存在确认机制但批量操作时仍需谨慎。

网络暴露风险：脚本默认使用HTTP连接本地服务，若*arr实例配置为远程访问且未启用HTTPS，存在中间人攻击面。

依赖稳定性：*arr系列API版本迭代可能导致脚本兼容性问题，需关注版本兼容性矩阵。