Decluttarr高级配置:如何通过正则表达式精准过滤需要保留的下载项

📅 2026/8/10 19:24:05
Decluttarr高级配置:如何通过正则表达式精准过滤需要保留的下载项
Decluttarr高级配置如何通过正则表达式精准过滤需要保留的下载项【免费下载链接】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/decluttarrDecluttarr是一款强大的下载队列管理工具能够监控Radarr、Sonarr、Lidarr等下载队列自动移除停滞或不再需要的下载项。本文将详细介绍如何通过正则表达式和高级配置精准控制哪些下载项应该保留帮助用户优化下载管理效率。为什么需要精准过滤下载项在使用*arr系列工具如Radarr、Sonarr时用户经常会遇到以下问题某些特殊格式的文件如压缩包被误判为不良文件特定标签或分类的下载项需要永久保留自定义错误消息的下载项需要特殊处理私人 tracker 资源需要区别于公共资源处理通过Decluttarr的高级配置功能这些问题都可以通过灵活的规则设置来解决。核心配置文件解析Decluttarr的所有过滤规则都通过配置文件进行管理主要配置文件为config/config_example.yaml。该文件包含了全局设置、作业默认值和具体作业配置三个核心部分。全局规则设置在配置文件的general部分用户可以设置影响所有作业的全局规则general: # private_tracker_handling: obsolete_tag # remove, skip, obsolete_tag. Optional. Default: remove # public_tracker_handling: remove # remove, skip, obsolete_tag. Optional. Default: remove # obsolete_tag: Obsolete # optional. Default: Obsolete # protected_tag: Keep # optional. Default: Keep这些设置控制私有/公共 tracker 资源的处理方式以及用于标记的特殊标签名称。作业默认值配置job_defaults部分定义了所有作业的通用默认值job_defaults: max_strikes: 3 min_days_between_searches: 7 max_concurrent_searches: 3这些参数可以在具体作业配置中被覆盖。实用过滤规则配置实例1. 保留压缩包文件keep_archives在remove_bad_files作业中可以通过keep_archives参数保留压缩包文件jobs: remove_bad_files: keep_archives: true # 保留压缩包文件启用此选项后Decluttarr会自动保留常见的压缩格式文件如.zip、.rar、.7z等。这项配置对应的代码逻辑在src/jobs/remove_bad_files.py中实现if self.job.keep_archives: # 保留压缩包文件的逻辑2. 基于标签的过滤target_tagsremove_done_seeding作业支持通过target_tags参数指定只处理带有特定标签的下载项jobs: remove_done_seeding: target_tags: - Obsolete # 只处理带有Obsolete标签的项这项功能在src/jobs/remove_done_seeding.py中实现通过检查下载项的标签是否与目标标签列表匹配来决定是否处理。3. 基于分类的过滤target_categories除了标签还可以通过target_categories参数基于下载分类进行过滤jobs: remove_done_seeding: target_categories: - autobrr # 只处理autobrr分类的下载项标签和分类过滤可以组合使用提供更精确的控制。4. 错误消息模式匹配message_patternsremove_failed_imports作业使用message_patterns参数通过正则表达式匹配错误消息jobs: remove_failed_imports: message_patterns: - Not a Custom Format upgrade for existing* - Not an upgrade for existing* - *Found potentially dangerous file with extension* - Invalid video file* - No files found are eligible for import*这些模式使用通配符*来匹配不同的错误消息。在代码实现中src/jobs/remove_failed_imports.py这些模式被用于检查下载项的错误信息决定是否需要移除。创建自定义正则表达式规则Decluttarr的message_patterns支持完整的正则表达式语法这意味着用户可以创建非常精确的匹配规则。以下是一些实用的正则表达式示例匹配特定分辨率的视频文件message_patterns: - .*(1080p|2160p).* # 匹配包含1080p或2160p的文件排除特定关键词的文件message_patterns: - ^(?!.*sample).*$ # 排除包含sample关键词的文件匹配特定发布组的文件message_patterns: - .*(YTS|EZTV).* # 匹配YTS或EZTV发布组的文件规则优先级与组合策略当多个规则同时应用时Decluttarr遵循以下优先级原则显式保护标签protected_tag优先级最高作业级别的规则如target_tags、target_categories次之全局规则如private_tracker_handling作为基础规则建议的规则组合策略使用protected_tag标记需要永久保留的下载项为不同类型的下载项创建专用标签如Keep-Archive、Keep-Seeding对不同的作业使用不同的过滤规则避免规则冲突测试与验证配置配置完成后建议通过以下步骤验证规则是否生效将general部分的test_run设置为truegeneral: test_run: true这将启用测试模式Decluttarr会记录操作但不会实际删除文件。检查日志文件确认过滤规则按预期工作测试满意后将test_run设置为false启用实际操作常见问题与解决方案Q: 如何确保重要文件不会被误删A: 使用protected_tag参数为重要文件添加保护标签如Keep。相关代码在src/settings/_jobs.py中处理。Q: 正则表达式不生效怎么办A: 检查是否正确使用了正则表达式语法特别是特殊字符是否需要转义。可以使用在线正则测试工具验证表达式。Q: 如何为不同的*arr实例设置不同的规则A: 在instances部分为每个实例单独配置参数实现精细化管理。通过本文介绍的配置方法用户可以充分利用Decluttarr的强大过滤功能实现下载项的精准管理。无论是简单的标签过滤还是复杂的正则表达式匹配Decluttarr都能满足您的个性化需求让下载管理更加高效和智能。【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考