企业官网建设流程全解析

Decluttarr快速入门：3分钟配置完成自动移除停滞下载和失败任务

【免费下载链接】decluttarrWatches radarr, sonarr, lidarr, readarr and whisparr download queues and removes downloads if they become stalled or no longer needed.项目地址: https://gitcode.com/gh_mirrors/de/decluttarr

Decluttarr是一款专为*arr系列应用（Radarr、Sonarr、Readarr、Lidarr和Whisparr）设计的自动清理工具，能够智能监控下载队列，自动移除停滞、失败或不再需要的任务，让你的媒体管理系统保持高效运行。

🚀 为什么选择Decluttarr？

在使用*arr系列工具管理媒体下载时，你是否遇到过这些问题：

• 下载任务长时间停滞不动，占用队列资源
• 失败的下载任务堆积，需要手动清理
• 已经删除的媒体项目仍在继续下载
• 种子完成后仍占用磁盘空间

Decluttarr通过自动化处理这些问题，帮助你：

• 保持下载队列整洁高效
• 节省磁盘空间和网络带宽
• 减少手动管理时间
• 提高媒体获取成功率

📋 支持的核心功能

Decluttarr提供多种智能清理功能，可根据你的需求灵活启用：

自动移除问题下载

• 移除不良文件：识别并移除可用性低于100%的种子或包含潜在恶意内容的文件
• 移除失败下载：自动清理标记为"失败"的下载任务
• 移除导入失败项：处理那些下载成功但无法导入到媒体库的文件
• 移除元数据缺失项：清除长时间卡在"获取元数据"状态的任务

智能管理下载状态

• 移除文件缺失项：处理显示"文件缺失"警告的下载
• 移除孤立下载：删除那些所属媒体已从*arr应用中移除的下载任务
• 移除慢速下载：识别并终止速度低于阈值的下载
• 移除停滞下载：清理长时间无连接的停滞任务
• 移除未监控项：删除属于已标记为"未监控"媒体的下载

高级维护功能

• 自动搜索改进版本：定期为未达到质量标准的媒体搜索更好版本
• 自动搜索缺失内容：为标记为"缺失"的媒体自动触发搜索
• 检测文件删除：监控媒体文件系统，当文件被删除时自动更新*arr应用状态

🔧 快速安装指南

Decluttarr提供两种简单的安装方式，选择最适合你的方案：

本地运行方式

1. 克隆仓库

   git clone -b latest https://gitcode.com/gh_mirrors/de/decluttarr

2. 进入项目目录并创建配置文件

   cd decluttarr cp config/config_example.yaml config/config.yaml

3. 编辑配置文件（详见下方配置指南）

   nano config/config.yaml

4. 安装依赖并运行

   pip install -r docker/requirements.txt python3 main.py

Docker运行方式（推荐）

使用Docker Compose是最简单的方式，创建docker-compose.yml文件：

services: decluttarr: image: ghcr.io/manimatter/decluttarr:latest container_name: decluttarr restart: always environment: TZ: Europe/Zurich PUID: 1000 PGID: 1000 volumes: - ./config.yaml:/app/config/config.yaml

启动容器：

docker-compose up -d

⚙️ 3分钟配置指南

Decluttarr的配置文件位于config/config.yaml，只需几个关键步骤即可完成设置：

1. 配置*arr应用实例

添加你使用的*arr应用信息，以Sonarr和Radarr为例：

instances: sonarr: - base_url: "http://sonarr:8989" api_key: "你的Sonarr API密钥" radarr: - base_url: "http://radarr:7878" api_key: "你的Radarr API密钥"

2. 配置下载客户端

如果你使用qBittorrent（推荐），添加以下配置：

download_clients: qbittorrent: - base_url: "http://qbittorrent:8080" api_key: "你的qBittorrent API密钥" name: "qBittorrent"

3. 启用需要的清理任务

选择你需要启用的清理功能：

jobs: remove_stalled: true # 移除停滞下载 remove_failed_downloads: true # 移除失败下载 remove_slow: # 移除慢速下载 min_speed: 100 # 最小速度(KB/s) remove_unmonitored: true # 移除未监控项 remove_orphans: true # 移除孤立下载

4. 基本设置调整

general: log_level: INFO # 日志级别 timer: 10 # 检查间隔(分钟) test_run: false # 测试模式(不实际删除)

💡 使用技巧与最佳实践

安全测试

初次使用时，建议先启用测试模式：

general: test_run: true

这会显示Decluttarr将执行的操作，但不会实际删除任何内容，让你可以安全验证配置是否正确。

关键任务推荐组合

对于大多数用户，我们推荐启用以下任务组合：

• remove_stalled: 清理停滞任务
• remove_failed_downloads: 清理失败下载
• remove_orphans: 清理孤立下载
• remove_unmonitored: 清理未监控项

性能优化

• 根据你的系统资源和网络状况调整timer参数，建议设置为10-30分钟
• 对于慢速网络，可降低remove_slow的min_speed阈值
• 使用log_level: VERBOSE获取详细日志，帮助排查问题

📚 更多资源

• 配置文件示例：config/config_example.yaml
• 源代码目录：src/
• 作业处理逻辑：src/jobs/
• 设置管理：src/settings/

Decluttarr让你的*arr媒体管理系统保持高效、整洁，不再需要手动监控和清理下载队列。只需3分钟配置，即可享受自动化的下载管理体验！

【免费下载链接】decluttarrWatches radarr, sonarr, lidarr, readarr and whisparr download queues and removes downloads if they become stalled or no longer needed.项目地址: https://gitcode.com/gh_mirrors/de/decluttarr