Unmanic 快速上手指南：一条命令搭好你的媒体库自动优化系统

【免费下载链接】unmanicUnmanic - Library Optimiser项目地址: https://gitcode.com/gh_mirrors/un/unmanic

Unmanic（Library Optimiser）是一款开源的媒体库优化工具，它专门解决一个痛点：你硬盘里的影视文件格式乱七八糟，有的体积巨大、有的音轨电视放不了，而手动一个个转码又累又慢。它能自动扫描媒体库、找出不合规则的文件，再按你设定的规则批量转码、压缩或移动。这篇入门教程不扯概念，直接带你用最短路径把它跑起来，并完成第一次真实的批量转码。

硬盘又满了，先别急着删片 📦

我有个朋友，收藏了上千部动漫和电影。某天他打开磁盘管理一看，4T 硬盘只剩 80G。想清理吧，哪一部都舍不得；想压缩吧，文件夹里 MKV、AVI、MP4 混成一锅粥，有的还是 DTS 音轨，电视盒子根本放不出声音。他之前用格式工厂手动转，一部电影转半小时，转了 3 部就放弃了。

如果你也有类似的处境——文件格式不统一、体积臃肿、播放器不兼容，那么你需要的不是更强的转码软件，而是一个能替你盯盘、自动干活的“媒体库管家”。这就是 Unmanic 存在的意义：你把规则告诉它，剩下的扫描、排队、转码、归位，它全包了。

最快跑起来：一条命令 + 三步设置 🚀

最快的运行方式不是源码安装，而是用官方 Docker 镜像。只要机器上有 Docker，一条命令即可：

docker run -d \ --name unmanic \ -p 8888:8888 \ -v /home/me/unmanic-config:/config \ # 配置存档目录 -v /home/me/media:/library \ # 你的媒体库根目录 -v /home/me/unmanic-cache:/tmp/unmanic \ # 转码缓存目录 -e PUID=1000 -e PGID=1000 \ -e NUMBER_OF_WORKERS=2 \ josh5/unmanic:latest

PUID/PGID是容器内文件权限的“身份证号”，建议填成你当前用户的 uid（终端里输入id就能看到）。缓存目录别省，转码过程需要临时落盘空间。

等日志出现启动完成提示后，浏览器打开http://localhost:8888，然后只需三步：

1. 进入设置，添加一个媒体库，路径填容器内的/library；
2. 到插件页面安装你需要的插件（比如音频编码、视频压缩）；
3. 回到仪表盘点“开始扫描”，剩下的交给它。

想走源码开发路线的话，也可以先git clone https://gitcode.com/gh_mirrors/un/unmanic，再运行./devops/local_dev_venv.sh一键搭好本地虚拟环境，命令细节都写在docs/DEVELOPING.md里。

先搞懂 3 个词，后面就顺了 🧠

新手看文档最容易懵的，其实是几个反复出现的关键词。用生活里的比喻讲，一下就通了。

媒体库（Library）：给管家划地盘

媒体库就是你要交给 Unmanic 管理的那个文件夹。它只在你划定的地盘里干活，地盘外面的文件一概不动。你可以建多个媒体库，比如“电影库”和“动画库”，分别套用不同的处理规则。

工人（Worker）：同时干活的几双手

Worker 是同时处理任务的线程数。就像雇了几个工人，人越多同时处理的文件越多，但工钱（CPU 占用）也越高。NUMBER_OF_WORKERS就是工人数量，家用电脑从 2 起步慢慢调，别一上来就拉满。

插件（Plugin）：家务清单上的具体技能

插件是 Unmanic 的核心玩法，相当于你给管家下达的具体指令：把 AAC 音频重新编码、把 DTS 转成电视能播的 Dolby Digital、忽略超过某个体积的文件、转码后自动移动位置……官方还提供了“插件流（Plugin Flow）”编排功能，你可以决定这些技能按什么顺序执行。

实战：把整个动漫文件夹批量压成统一格式 🎬

理论讲完，来一个完整的小任务：把一整个动漫文件夹里的混合格式文件，统一转成 H.264 视频 + AAC 音频，顺便把体积压下来。

第一步，在设置里添加媒体库，指向存放动漫的目录。第二步，去插件商店安装“Audio Encoder AAC”和视频编码类插件，然后在“Configure Plugin Flow”里把它们的执行顺序排好。第三步，把NUMBER_OF_WORKERS调到 2，回到仪表盘点击扫描。

扫描开始后，你会看到类似下图这样的画面：三个 Worker 各自处理着不同文件，左侧是排队中的任务，右侧是已完成的任务，进度、剩余时间一目了然：

处理完成后，打开文件大小数据面板，能看到每个文件处理前后的体积对比。以我自己的实测为例，一批动漫文件转码后整体体积下降了 53%，画质肉眼看不出区别：

整个过程你只需要配置一次，之后新增的文件只要进了这个文件夹，Unmanic 也会自动检测、自动入队处理——因为它内置了文件监控功能。

新手最常踩的 5 个坑（附解法）⚠️

进阶玩法与资源入口 🧭

跑通基础流程后，还可以往这几个方向挖一挖：

• 定时自动扫描：加环境变量SCHEDULE_FULL_SCAN_MINUTES=10，让 Unmanic 每 10 分钟全库扫一遍，新片入库即处理；
• 硬件加速转码：项目提供了docker/docker-compose-vaapi.yml（Intel 核显）和docker/docker-compose-nvidia.yml（N 卡）两套配置，能让转码速度翻倍而 CPU 几乎不转；
• 自定义命令：插件市场里有“外部脚本”类插件，可以接 FileBot 自动改名，或按文件大小、时间戳执行任意命令。

想深入了解，可以在项目里翻这几个入口：示例配置在docker/目录下的各 compose 文件，开发文档在docs/DEVELOPING.md，测试辅助脚本在tests/scripts_/。

最后说句实在的：不用急着配齐所有功能，先让它帮你处理一个文件夹，看看那 53% 的磁盘空间是怎么省出来的。Unmanic 值得你给它一个周末的信任。

【免费下载链接】unmanicUnmanic - Library Optimiser项目地址: https://gitcode.com/gh_mirrors/un/unmanic