Decluttarr部署攻略：Docker容器化安装与系统服务配置最佳实践

Decluttarr部署攻略：Docker容器化安装与系统服务配置最佳实践

【免费下载链接】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是一款功能强大的下载队列管理工具，能够监控Radarr、Sonarr、Lidarr、Readarr和Whisparr的下载队列，自动移除停滞或不再需要的下载任务。本文将详细介绍如何通过Docker容器化方式快速部署Decluttarr，并提供系统服务配置的最佳实践，帮助新手用户轻松上手。

一、Decluttarr简介与核心优势

Decluttarr作为一款自动化下载管理工具，主要解决媒体服务器中常见的下载任务堆积问题。其核心功能包括：

• 自动识别并移除停滞的下载任务
• 清理不再需要的已完成下载
• 支持多平台媒体服务器监控（Radarr/Sonarr等）
• 灵活的配置选项满足个性化需求

通过Docker容器化部署，用户可以获得：

• 简化的安装流程，避免依赖冲突
• 隔离的运行环境，提高系统安全性
• 便捷的版本管理和更新机制
• 跨平台的一致运行体验

二、Docker环境准备

在开始部署Decluttarr之前，请确保您的系统已安装Docker和Docker Compose。如果尚未安装，可以通过以下命令快速部署：

# 安装Docker sudo apt-get update && sudo apt-get install -y docker.io docker-compose # 启动Docker服务并设置开机自启 sudo systemctl enable --now docker

三、Docker容器化安装步骤

3.1 推荐方案：Docker Compose + 配置文件

这种方式使用独立的配置文件管理设置，便于维护和版本控制，是官方推荐的部署方式。

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/de/decluttarr cd decluttarr

2. 创建配置文件

   # 复制示例配置文件并修改 cp config/config_example.yaml config/config.yaml # 使用文本编辑器编辑配置 nano config/config.yaml

3. 创建Docker Compose文件在项目根目录创建docker-compose.yml文件，内容如下：

   services: decluttarr: build: context: . dockerfile: docker/Dockerfile container_name: decluttarr volumes: - ./config/config.yaml:/app/config/config.yaml restart: unless-stopped environment: - TZ=Asia/Shanghai

4. 启动容器

   docker-compose up -d

3.2 备选方案：仅使用Docker Compose配置

如果您偏好将所有设置都放在Docker Compose文件中，可以使用这种方式：

1. 创建Docker Compose文件

   services: decluttarr: build: context: . dockerfile: docker/Dockerfile container_name: decluttarr restart: unless-stopped environment: - TZ=Asia/Shanghai - RADARR__ENABLED=true - RADARR__URL=http://radarr:7878 - RADARR__API_KEY=your_api_key_here # 添加其他必要的环境变量配置

2. 启动容器

   docker-compose up -d

四、配置文件详解

Decluttarr的配置文件config/config.yaml是整个系统的核心，包含了所有的监控规则和行为设置。主要配置项包括：

4.1 基本设置

general: dry_run: false # 测试模式，不实际删除文件 log_level: info # 日志级别 interval: 300 # 检查间隔(秒)

4.2 媒体服务器配置

radarr: enabled: true url: http://radarr:7878 api_key: your_api_key timeout: 30 # 其他特定设置...

4.3 清理规则配置

jobs: remove_stalled: enabled: true threshold: 86400 # 停滞阈值(秒) remove_completed: enabled: true keep_ratio: 1.0 # 保留做种率 # 其他清理规则...

五、系统服务配置最佳实践

5.1 Docker容器自动启动

确保Decluttarr在系统重启后能自动启动：

# 设置容器自动重启 docker update --restart unless-stopped decluttarr

5.2 日志管理

为了更好地跟踪系统运行状态，建议配置日志轮转：

1. 创建日志轮转配置文件：

   sudo nano /etc/logrotate.d/decluttarr

2. 添加以下内容：

   /var/lib/docker/containers/*/decluttarr-*.log { daily rotate 7 compress delaycompress missingok copytruncate }

5.3 监控与维护

定期检查容器运行状态：

# 查看容器状态 docker ps | grep decluttarr # 查看日志 docker logs -f decluttarr # 更新容器 docker-compose pull && docker-compose up -d

六、常见问题解决

6.1 配置文件不生效

确保Docker Compose中正确挂载了配置文件：

volumes: - ./config/config.yaml:/app/config/config.yaml

6.2 媒体服务器连接失败

检查网络连通性和API密钥：

# 测试Radarr连接 curl http://radarr:7878/api/system/status -H "X-Api-Key: your_api_key"

6.3 容器启动后立即退出

查看日志获取详细错误信息：

docker logs decluttarr

七、总结

通过Docker容器化部署Decluttarr，不仅简化了安装流程，还确保了系统环境的一致性和安全性。推荐使用"Docker Compose + 配置文件"的方式进行部署，既保持了配置的灵活性，又便于后期维护。合理配置系统服务和监控机制，可以确保Decluttarr长期稳定运行，为您的媒体服务器提供高效的下载队列管理服务。

Decluttarr的配置文件路径为config/config.yaml，Docker构建文件位于docker/Dockerfile，您可以根据实际需求进行个性化调整。

【免费下载链接】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