Unmanic 库优化工具使用教程

一、项目介绍

Unmanic 是一个轻量级的库管理工具，旨在帮助你优化文件库。它允许你将文件转换为统一格式，基于时间戳管理文件移动，并根据文件大小执行自定义命令。主要功能包括：

• 内置调度器扫描不符合预设规则的文件。
• 文件/目录监控，当文件更改或新文件添加时进行处理。
• 自动转换视频或音频格式（如使用FFmpeg）。
• 根据配置规则移动文件。
• 执行FileBot等自动化重命名任务。
• 基于扩展名或大小运行自定义命令。

Unmanic 可以通过Docker容器部署，支持Linuxserver.io的Ubuntu Focal镜像。

二、项目快速启动

首先，确保你的系统已经安装了Docker。接下来，按照以下步骤部署 Unmanic：

1. 下载并拉取 Unmanic 的 Docker 镜像：

   docker pull unmanic/unmanic
   

2. 运行 Unmanic 容器：

   docker run --name unmanic-instance -v /your/local/path:/data -d unmanic/unmanic
   

   其中 /your/local/path 替换为你希望监控的本地文件夹路径。

3. 检查 Unmanic 是否正在运行：

   docker ps
   

现在，Unmanic 已经在监控指定的目录，并根据配置规则对文件进行操作。

三、应用案例与最佳实践

示例1：视频格式转换

创建一个名为 video-presets.yaml 的文件，配置 FFmpeg 转换规则：

presets:
  video:
    extensions: ['.mp4', '.mkv']
    actions:
      - command: 'ffmpeg -i {filename} -c:v libx265 -crf 22 -preset medium -c:a opus -b:a 96k {new_filename}'
        output_ext: '.hevc.opus'

运行 Unmanic 并应用这个配置：

docker exec -it unmanic-instance unmanic apply --preset-file video-presets.yaml

最佳实践：

• 使用定时任务（如Cron）定期运行 unmanic apply 来保证文件保持最新状态。
• 监控日志输出以调试和了解进程状态。
• 在生产环境中，考虑使用环境变量来动态配置 Unmanic。

四、典型生态项目

Unmanic 可以配合其他开源项目使用，例如：

1. FFmpeg - 用于视频和音频转码。
2. FileBot - 自动化媒体文件管理和重命名。
3. Logrotate - 日志文件管理，定期清理和压缩旧文件。
4. Home Assistant - 智能家居平台，可集成Unmanic进行自动化任务。

通过这些组合，你可以构建出一套完整的文件管理系统，满足个性化需求。

---

以上是 Unmanic 的简单介绍及启动指南。更多详细信息和高级用法，请参考 Unmanic 的官方文档和示例配置。祝你在文件优化的道路上事半功倍！