Unpackerr Docker 镜像文档

!Unpackerr Logo

镜像概述

Unpackerr 是一款运行在下载主机或种子箱上的守护进程工具，主要用于监控已完成的下载任务并自动解压文件，以便 Lidarr、Radarr、Readarr 和 Sonarr（合称 Starr 应用）能够顺利导入媒体文件。对于因 RAR 文件卡在活动队列而导致的导入问题，Unpackerr 可提供直接解决方案。此外，它也支持独立运行模式，通过监控指定文件夹自动解压其中的压缩文件。

核心功能与特性

支持的压缩格式

• 基础格式：TAR、RAR、ZIP、7-ZIP、GZIP、TAR.GZ、TAR.BZIP
• 特殊格式：加密 RAR 和 7-ZIP 归档、ISO 光盘镜像
• 递归解压：支持多层文件夹内的归档文件，以及归档文件中嵌套的其他归档文件

核心能力

• 自动监控下载目录，检测完成的下载任务并触发解压
• 与 Starr 应用深度集成，解决媒体文件导入前的解压依赖问题
• 支持独立运行模式，适用于无 Starr 应用的场景

使用场景与适用范围

典型使用场景

1. Starr 应用辅助工具
   解决 Lidarr/Radarr/Readarr/Sonarr 因压缩文件（如 RAR）未解压而无法导入媒体的问题，确保下载完成后自动解压并触发应用导入流程。

2. 独立文件夹监控解压
   配置后可监控指定下载目录，自动解压所有新增的压缩文件，适用于无需媒体管理应用的简单解压需求。

适用用户

• 使用 Starr 系列媒体管理应用的用户
• 需要自动化解压下载文件的个人或家庭用户
• 种子箱或下载服务器管理员

使用方法与配置说明

Docker 快速启动

基础 docker run 命令

docker run -d \
  --name=unpackerr \
  --restart=unless-stopped \
  -v /path/to/your/downloads:/downloads \  # 挂载下载目录（需解压文件所在目录）
  -v /path/to/unpackerr/config:/config \   # 挂载配置文件目录（持久化配置）
  -e TZ=Asia/Shanghai \                    # 设置时区（可选）
  unpackerr/unpackerr

Docker Compose 配置示例

version: "3"
services:
  unpackerr:
    image: unpackerr/unpackerr
    container_name: unpackerr
    restart: unless-stopped
    volumes:
      - /path/to/your/downloads:/downloads  # 下载目录挂载
      - /path/to/unpackerr/config:/config   # 配置文件目录挂载
    environment:
      - TZ=Asia/Shanghai                    # 时区设置
      # 其他配置参数可通过环境变量或配置文件设置，详见下方说明

配置方式

Unpackerr 支持通过两种方式配置：

1. 环境变量：适合简单配置，如设置监控目录、Starr 应用地址等
2. 配置文件：适合复杂场景，配置文件路径为 /config/unpackerr.conf（需挂载 /config 目录以持久化）

关键配置参数（示例）

• UNPACKERR_WATCH_DIRS：独立模式下的监控目录列表（如 /downloads）
• SONARR_URL：Sonarr 应用地址（如 [***]）
• SONARR_API_KEY：Sonarr API 密钥
• UNPACKERR_DELETE_AFTER：解压后是否删除原压缩文件（true/false）

详细配置参数及说明请参考 官方文档。

致谢

以下服务提供商为项目提供了免费支持，涵盖存储、构建、分发及文档等关键环节，特此致谢：

• PackageCloud.io：包管理与分发
• GitHub：代码托管与版本控制
• Docker Cloud：容器镜像构建与分发
• Go Lift：开发支持
• CloudFlare：文档与网站加速

许可证

本项目采用 MIT 许可证 开源。