grantemsley/unrarall

unrarall Docker镜像文档

镜像概述

unrarall是一个用于自动提取RAR文件的Docker镜像。它监控指定目录（及其子目录）中的RAR文件，自动执行提取操作，并可根据配置清理源文件。该镜像旨在提供比手动处理更高效、更可靠的RAR文件提取解决方案，适用于需要自动化处理压缩文件的场景。

核心功能与特性

• 自动提取：递归处理指定目录及其子目录中的所有RAR文件
• 清理控制：通过环境变量配置提取后是否删除RAR文件
• 检查间隔：可自定义两次检查RAR文件的时间间隔（秒）
• 多后端支持：兼容不同的解压后端（具体参数通过--help查看）
• SFV校验：支持自动执行SFV文件校验（需配置相应参数）
• 钩子扩展：支持自定义钩子实现额外文件清理需求（详见HACKING文档）

使用场景

• 下载目录自动化处理：监控下载文件夹，自动提取新下载的RAR压缩包
• 服务器文件管理：在服务器环境中自动处理上传的RAR文件
• 批量解压任务：对包含多个RAR文件的目录进行批量提取与清理
• 自动化工作流：集成到文件处理流水线，实现RAR文件的自动解压环节

配置说明

目录挂载

必须将需要监控的目录挂载到容器的/input路径：

bash
-v /本地待监控目录:/input

环境变量

使用方法

基本使用示例（Docker Run）

监控本地/data/downloads目录，提取后删除RAR文件，每60秒检查一次：

bash
docker run -d \
  -v /data/downloads:/input \
  -e CLEANMODE=all \
  -e DELAY=60 \
  unrarall

指定输出目录

将提取后的文件保存到自定义目录（需额外挂载输出目录）：

bash
docker run -d \
  -v /data/downloads:/input \
  -v /data/extracted_files:/output \
  -e CLEANMODE=all \
  -e DELAY=30 \
  unrarall --output /output

查看帮助信息

获取完整参数说明：

bash
docker run --rm unrarall -h

致谢

该镜像的名称和核心理念来源于"jeremy"，相关参考：http://askubuntu.com/questions/7059/script-app-to-unrar-files-and-only-delete-the-archives-which-were-sucessfully