nas-tools媒体库管理工具实战指南三步完成部署让NAS自动整理效率翻倍【免费下载链接】nas-toolsNAS媒体库管理工具项目地址: https://gitcode.com/gh_mirrors/nas/nas-toolsnas-tools是一款开源的NAS媒体库管理工具它的核心价值是把下载→识别→重命名→分类→入库→通知这条整理链路全自动跑通。看完这篇文章你会掌握它的完整部署方法、核心配置逻辑以及几个多数人没发现的进阶玩法从此告别手动整理媒体文件的苦日子。凌晨两点的整理崩溃下载一时爽整理火葬场先讲一个很多NAS用户都经历过的场景周五晚上你在PT站一口气下载了3部电影、2部电视剧。周六大扫除时你打开NAS发现下载目录里躺着这样的文件Movie.2024.1080p.BluRay.x264-GROUP.mkvtv.show.s01e01-e10.web.2160p.mkv还有一堆.nfo、.jpg、.ass字幕文件散落各处你打开Emby发现媒体库一片混乱——电视剧没有正确的集数信息、海报全是默认占位图、国产剧和欧美剧挤在同一个文件夹里。于是你开始手动建目录、改文件名、下载海报、重新刮削……一折腾就是两三个小时。nas-tools要解决的正是这个痛点。它把媒体识别、重命名、分类、刮削、入库这一整套流程自动化文件下载完成后自动识别片名和集数、按你的命名规则重命名、按分类规则归档到对应目录再自动同步给媒体服务器。你的工作从手动整理变成偶尔看一眼。先别急着装nas-tools和Emby、手动整理到底有什么区别很多人第一次接触nas-tools时会困惑我已经有Emby/Jellyfin了为什么还需要它这里需要理清一个关键认知工具擅长的事不擅长的事Emby/Jellyfin/Plex媒体库展示海报墙、刮削、播放、多端同步不会帮你移动文件、重命名、归档手动整理脚本/FileBot批量重命名、移动文件无法联动下载器无法自动订阅nas-tools下载后自动整理识别、重命名、分类、入库、通知不负责播放交给媒体服务器一句话总结nas-tools是整理中枢媒体服务器是展示窗口。它们不是替代关系而是上下游配合——nas-tools把整理好的文件放进媒体库目录Emby/Jellyfin再扫描展示。理解了这层关系你就明白为什么它的配置里会专门有一项媒体服务器。另外nas-tools还有一个鲜明特点它是一套完整的自动化体系而不是单点工具。从PT站点订阅RSS到下载器管理qBittorrent、Transmission、Aria2、115、PikPak从媒体识别TMDB到消息通知Telegram、微信、Bark全部打通成一条流水线。这是它和很多仅重命名工具最本质的区别。动手前的功课硬件、账号、目录三张准备清单部署前先花10分钟清点这几样东西能省掉后面80%的返工。1. 硬件与系统一台能7×24运行的设备群晖、威联通、软路由、迷你主机或云服务器均可建议至少2GB内存Docker方式运行x86或ARM架构都支持已安装Docker与Docker Compose推荐或Python 3.10环境源码方式2. 必须申请的账号TMDB API Key媒体识别的命根子。在TMDB官网注册账号后在设置中申请免费。没有它nas-tools无法识别电影电视剧这一步别跳过如果你要用Telegram/微信通知提前准备好对应的机器人或推送凭证3. 目录规划关键在动手前先在存储空间上规划好三个层级/volume1/downloads ← 下载器PT/BT的下载目录 /volume1/media/movie ← 媒体库电影目录整理后归档到这里 /volume1/media/tv ← 媒体库电视剧目录规划时有两条硬性建议下载目录和媒体库目录尽量放在同一块硬盘/存储空间上后面讲硬链接时会解释原因目录层级想清楚再动手因为后续改映射比改配置更麻烦。从零到能用三步完成部署与首次配置第一步部署前先确认路径映射这件事在写Docker命令之前你必须理解一个概念容器内路径 ≠ 宿主机路径。nas-tools在容器里看到的目录取决于你映射了哪些宿主机目录。这里直接看官方的映射对比图左边是错误示范只映射了子目录导致跨盘右边是正确示范映射了根目录这张图建议收藏nas-tools硬链接模式的关键映射目录时要以根目录为基准否则会被容器判定为跨盘第二步Docker Compose部署推荐一条命令搞定新建一个docker-compose.yaml文件version: 3 services: nas-tools: image: hsuyelin/nas-tools:latest ports: - 3000:3000 # Web管理界面端口 volumes: - ./config:/config # 配置目录务必映射到宿主机持久化 - /volume1/downloads:/volume1/downloads # 下载目录 - /volume1/media:/volume1/media # 媒体库根目录 environment: - PUID0 # 运行用户UID建议与媒体文件所有者一致 - PGID0 # 运行用户GID - UMASK000 # 文件掩码权限 - NASTOOL_AUTO_UPDATEfalse # 如需启动时自动升级可设为true restart: always hostname: nas-tools container_name: nas-tools然后执行docker-compose up -d看到容器正常运行后访问http://你的NAS IP:3000默认账号admin/password登录后第一件事是修改默认密码。如果你偏好源码方式运行仅支持Python 3.10需预装Cythongit clone https://gitcode.com/gh_mirrors/nas/nas-tools cd nas-tools python3 -m pip install Cython python3 -m pip install --force-reinstall -r requirements.txt export NASTOOL_CONFIG/你的路径/config/config.yaml nohup python3 run.py 第三步首次使用的四项核心配置现在的版本已经支持全部在Web界面里完成配置设置→基础设置比手改YAML更不易出错。首次使用按这个顺序配半小时内能跑通① 填TMDB API Key基础设置→系统→TMDB API Key。填入你在官网申请的Key顺便确认tmdb_domain使用默认的api.tmdb.org。识别不准时可把匹配模式rmt_match_mode从normal调为strict严格按年份匹配降低误识别。TMDB是nas-tools的识图引擎Key配好后媒体自动识别才算真正可用② 配置媒体库路径基础设置→媒体→电影/电视剧/动漫目录分别填你规划好的路径注意用容器内路径与volume映射保持一致。如果你有动漫单独归档的需求把anime_path也配上。③ 选择文件转移方式这是新手最容易懵的一项。目前支持link硬链接、softlink软链接、copy复制、move移动、rclone等模式link 硬链接最推荐。文件在下载目录和媒体库两份名字、一份数据不占双倍空间还能继续做种。前提是源目录和媒体库目录在同一存储空间copy 复制简单粗暴但会复制一份完整数据占空间move 移动会直接搬走原文件影响做种有保种需求千万别选④ 配置媒体服务器如果你在用Emby在媒体服务器页签填入地址和API Keyemby: host: http://127.0.0.1:8096 api_key: 你的Emby API密钥 play_host: http://127.0.0.1:8096Jellyfin、Plex同理。配置好后nas-tools完成整理会自动触发媒体服务器刷新新片直接出现在海报墙上nas-tools负责整理入库Emby负责展示两者配合形成完整的媒体管理闭环进阶玩法解密四个让整理效率翻倍的隐藏技能基础配置跑通后下面这几个功能多数教程不会细讲但用好了体验完全不同。玩法一二级分类国产剧/欧美剧/动漫自动分目录默认情况下所有电影都在一个目录里。在config/config.yaml中设置category: default-category程序会读取 config/default-category.yaml 的规则按语种、国家、内容类型自动建二级目录tv: 国产剧: origin_country: CN,TW,HK 欧美剧: origin_country: US,FR,GB,DE,ES,IT,NL,PT,RU,UK 日韩剧: origin_country: JP,KP,KR,TH,IN,SG这些规则完全按TMDB返回的字段匹配genre_ids、original_language、origin_country你完全可以照葫芦画瓢加一个纪录片儿童分类。从此你的媒体库不再是一锅炖而是分门别类、一目了然。玩法二RSS订阅新剧上线自动下载这是把自动化推到极致的核心功能。在订阅页面添加一部正在连载的剧程序会定期去PT站点检索新集资源并自动下载下完自动整理入库pt: pt_check_interval: 1800 # RSS订阅检查周期秒建议不小于30分钟 search_rss_interval: 6 # 定量搜索RSS周期小时用于主动检索订阅 download_order: site # 择优规则site站点优先/seeder做种数优先配合消息通知新剧更新时你的Telegram/微信会收到推送真正做到躺在沙发上等更新。玩法三插件市场签到、字幕、豆瓣一键扩展nas-tools内置了丰富的插件系统全部在 app/plugins/modules/ 目录下通过插件页面一键启用站点自动签到支持52PT、btschool、chdbits、hdchina、hdsky等数十个PT站定时自动签到保号设置好间隔即可ChineseSubFinder自动为媒体库匹配下载中文字幕配合整理流程入库即带字幕豆瓣同步 / 豆瓣榜单订阅把豆瓣想看同步成订阅或直接订阅豆瓣榜单片源自动入库磁盘空间释放监控空间占用触发整理/清理策略避免磁盘写满CookieCloud同步浏览器Cookie云端同步站点Cookie失效后自动续期插件是nas-tools无限扩展的入口按需开启即可不用给系统增加无谓负担玩法四刮削增强与自定义命名打开nfo_poster开关后文件转移时会自动生成NFO描述文件和海报帮助媒体服务器精准刮削media: nfo_poster: true movie_name_format: {title} ({year})/{title}-{part} ({year}) - {videoFormat} tv_name_format: {title} ({year})/Season {season}/{title}-{part} - {season_episode} - 第{episode}集占位符体系很完整{title}、{year}、{videoFormat}、{season_episode}、{releaseGroup}、{rating}等一应俱全想怎么排版都行。对于重命名格式有洁癖的用户这简直是强迫症福音开启NFO刮削后nas-tools整理出的每个文件都自带完整元数据媒体服务器识别零成本避坑与调试最容易踩的5个坑和自查清单把常见问题按症状→原因→解决讲清楚遇到时按图索骥即可。坑1启动报 inotify 错误或目录同步时灵时不灵症状日志出现inotify instance limit reached、inotify watch limit reached。原因宿主机inotify监控上限不足Docker环境常见。解决在宿主机不是容器里执行echo fs.inotify.max_user_watches524288 | sudo tee -a /etc/sysctl.conf echo fs.inotify.max_user_instances524288 | sudo tee -a /etc/sysctl.conf sudo sysctl -p坑2识别转移报错错误码-1症状文件转移失败错误码 -1。原因硬链接跨盘。转移前后目录的根目录必须相同群晖中不同共享文件夹也会被判定为跨盘。解决检查Docker卷映射确保下载目录和媒体库目录在同一存储空间下回到开头那张映射对比图。坑3媒体识别不准或张冠李戴症状电影识别成错误片名或同名电影年份匹配错乱。自查顺序① 确认TMDB API Key有效且网络可访问api.tmdb.org② 检查文件名是否规范含正确年份③ 把rmt_match_mode从normal调为strict减少误识别。坑4改了config.yaml后程序报错起不来症状启动失败日志提示YAML语法错误。原因YAML语法非常严格——冒号后面必须有空格、不能用全角标点、缩进不能混用Tab和空格。解决优先用Web界面配置已覆盖全部配置项必须手改时用带YAML校验的编辑器改完先用python -c import yaml;yaml.safe_load(open(config.yaml))自检一遍。坑5订阅添加后一直在队列中不搜索症状电影/电视剧订阅添加后永远停在队列状态。原因订阅搜索依赖RSS周期或搜索周期两者都未启用。解决在基础设置→服务中开启订阅RSS周期建议30分钟和订阅搜索周期建议6小时然后进入订阅页点刷新手动触发一次。生态地图从四个目录看懂nas-tools的扩展能力想深入了解这个项目下面四个目录是它的骨架按图索骥即可快速上手app/plugins/modules/插件库。自动签到、字幕、豆瓣、空间清理等全部插件源码所在也是学习自定义插件的最佳范本app/downloader/client/下载器适配层。qBittorrent、Transmission、Aria2、115、PikPak等客户端接入代码app/message/client/消息通道。Telegram、微信、Server酱、Bark、Slack等十余种通知方式app/mediaserver/client/媒体服务器适配。Emby、Jellyfin、Plex三种服务器的对接实现想进一步折腾可以看看 app/sites/siteuserinfo/ 里的站点解析模块它是各PT站数据抓取的核心config/default-category.yaml 则是分类规则的完整示例改起来很简单。项目的requirements.txt和package_list.txt也列全了依赖方便排查环境问题。现在让NAS自己干活吧回顾一下我们做的事理解定位整理中枢≠播放器→ 清点前置条件 → 三步完成部署与核心配置 → 解锁二级分类、RSS订阅、插件、刮削四个进阶玩法 → 掌握常见坑的排查方法。至此你的NAS已经具备了下载即整理、入库即完整、更新即通知的完整能力。接下来建议按这个顺序动手今晚按第三步完成部署和四项核心配置跑通第一次整理本周开启二级分类和RSS订阅添加一部正在连载的剧体验全自动本月逛一遍插件市场把自动签到、字幕下载等高频插件配起来配置一次享受很久。现在就去打开NAS让nas-tools接管你的媒体库吧。【免费下载链接】nas-toolsNAS媒体库管理工具项目地址: https://gitcode.com/gh_mirrors/nas/nas-tools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考