jolanl/kirby

🌟 Kirby：自动化媒体清理工具

Kirby是一款强大的集中式删除与排除管理器，专为复杂的家庭媒体环境设计。它原生支持与Plex、Jellyfin、Radarr、Sonarr和qBittorrent集成，无需手动操作即可帮助你控制存储容量。

GitHub：https://github.com/JolanLar/kirby

✨ 核心功能

• 自动删除队列：跟踪未观看或较旧的媒体，当达到指定存储阈值时智能清理。
• 智能屏蔽（自动排除）：原生记录媒体库的删除历史，若某部电影或剧集达到自定义的删除次数阈值，Kirby会自动将其锁定到排除列表，防止未来重复删除。
• 收藏检测：自动识别Plex和Jellyfin用户收藏的媒体并排除在删除范围外，支持按用户定位、跨服务器聚合及单个项目的“忽略”覆盖。
• 多服务器支持：轻松切换Plex和Jellyfin阵列的路径与存储映射。
• 动态前端：基于React & Vite + Tailwind构建，提供原生搜索、过滤和快速分页功能。

📌 使用场景

1. 家庭媒体服务器用户：需要自动管理存储空间，避免因媒体文件过多导致存储溢出。
2. 多服务器媒体环境：需统一管理不同服务中的媒体删除规则与排除列表。
3. 追求高效运维的用户：希望减少手动清理媒体的时间，通过自动化规则保持存储健康。

🐳 Docker部署

运行Kirby最简便的方式是使用Docker Compose。

Docker Compose配置

yaml
services:
  kirby:
    image: jolanl/kirby:latest
    container_name: kirby
    restart: unless-stopped
    ports:
      - "4000:4000"
    volumes:
      - ./config:/app/backend/data
    environment:
      - TZ=Europe/Paris

部署步骤

1. 启动容器
   执行以下命令部署：

   bash
   docker-compose up -d
   

2. 访问界面
   Kirby将在 http://localhost:4000 可用。