jorenn92/maintainerr

Maintainerr 镜像文档

镜像概述

Maintainerr 是一款专注于媒体管理的工具，旨在简化服务器媒体维护工作。它能够帮助用户识别并处理那些占用宝贵存储空间却从未被观看的媒体内容，特别适合解决以下问题：

• 服务器管理繁琐，需手动清理闲置媒体
• 大量媒体内容长期未被观看，浪费存储空间
• 用户频繁请求媒体后却不再使用，导致资源闲置

如果您遇到上述任何问题，Maintainerr 将成为您的一站式解决方案，高效管理那些占用空间的影视内容。

核心功能与特性

• 自定义规则配置：基于 Plex、Overseerr、Radarr 和 Sonarr 的多种参数设置清理规则，满足个性化需求
• 手动媒体管理：支持手动将媒体添加到集合，处理规则未覆盖的特殊项目
• 媒体排除功能：可选择性排除特定媒体，即使其匹配规则也不会被处理
• Plex 首页集合展示：在 Plex 首页显示"即将移除"集合，可自定义展示时长，提醒用户查看
• 手动 Plex 集合支持：若不希望自动管理 Plex 集合，可使用手动集合模式
• 多平台集成操作：支持从 *arr 应用（Radarr/Sonarr）中移除或取消监控媒体、清除 Overseerr 中的请求记录、直接从磁盘删除文件

支持的应用

目前，Maintainerr 支持从以下应用获取规则参数：

• Plex
• Overseerr
• Radarr
• Sonarr

使用场景

Maintainerr 适用于以下用户和场景：

• 服务器管理员需要自动化清理未使用媒体，减少手动维护工作
• 拥有大量媒体库但存储空间有限，需释放闲置内容占用的空间
• 多用户环境中，用户请求媒体后长期未观看，导致资源浪费
• 使用 Plex、Overseerr、Radarr 或 Sonarr 管理媒体库的用户，需要统一管理媒体生命周期

安装与使用方法

镜像获取

Docker 镜像可通过以下仓库获取：

• Docker Hub: jorenn92/maintainerr
• GitHub Container Registry: ghcr.io/jorenn92/maintainerr

基本要求

• 持久化存储：需挂载 /opt/data 目录以保存配置数据
• 权限：确保挂载目录可被 UID/GID 1000:1000 读写（可通过 user 参数指定）
• 网络：暴露端口 6246 以访问 Web 界面

Docker 运行示例

yaml
docker run -d \
--name maintainerr \
-e TZ=Asia/Shanghai \
-v ./data:/opt/data \
-u 1000:1000 \
-p 6246:6246 \
--restart unless-stopped \
ghcr.io/jorenn92/maintainerr:latest

Docker Compose 配置示例

yaml
version: '3'

services:
    maintainerr:
        image: jorenn92/maintainerr:latest  # 或 ghcr.io/jorenn92/maintainerr:latest
        container_name: maintainerr
        user: 1000:1000
        volumes:
          - type: bind
            source: ./data
            target: /opt/data
        environment:
          - TZ=Asia/Shanghai
          # - DEBUG=true  # 取消注释以启用调试日志
        ports:
          - 6246:6246
        restart: unless-stopped

环境变量说明

相关链接

• GitHub 仓库：https://github.com/jorenn92/Maintainerr
• 官方文档：[***]

鸣谢

Maintainerr 深受 Overseerr 的启发，部分代码直接参考自该项目。特别感谢 Overseerr 团队开发并维护了如此优秀的应用！

您可以通过 https://github.com/sct/overseerr 支持他们。