ConfigData/rename-media/nastools部署说明.md

nas-tools 部署与配置说明（飞牛 fnOS）

目标流程：media_final.py 清理后的媒体目录 → nas-tools 自动监听 → 刮削 → 复制落库到成品媒体库。

一、部署（飞牛 Docker）

1. 飞牛后台 → 应用中心 → Docker（或直接 Docker 应用）→ 新建项目 / Compose。
2. 粘贴 nastools-docker-compose.yml 内容，把 /vol1/media/cleaned、/vol1/media/library、/vol1/docker/nas-tools/config 三处改成你飞牛上的真实路径。
3. 保存并启动，等待镜像拉取完成。
4. 浏览器打开 http://<飞牛IP>:3000，默认账号 admin / 密码 password（首次登录后改掉）。

镜像拉不动时：确认环境变量 NASTOOL_AUTO_UPDATE=false、NASTOOL_CN_UPDATE=true 已设置。

二、Web 里必须配的点

配置项	位置	说明
TMDB API Key	设置 → 媒体库	必填，TMDB 官网免费申请（themoviedb.org/settings/api）。没有它无法刮削海报/简介
目录同步：复制模式	设置 → 目录同步	添加「源目录 = /media/source、目的目录 = /media/library」，传输方式选复制（对应你定的落库方式）
媒体库识别	设置 → 媒体库	电影/剧集命名规则保持默认即可，识别率高
联动 Jellyfin/Emby	设置 → 媒体服务器	可选。填入 Jellyfin/Emby 地址和 API Key，nas-tools 刮削完会通知它刷新海报墙

三、关键行为确认

• nas-tools 默认会监控源目录，文件新增/变更后自动识别媒体真实名称 → 刮削 → 复制到成品目录。
• 「复制」= 源目录保留，成品目录得到一份完整的刮削后副本（含 nfo、海报、背景图）。
• 如果你想省空间、源和成品在同一文件系统，可把「复制」换成「硬链接」——效果等同但几乎不占额外空间（自愿切换）。

四、验证

• 往 /vol1/media/cleaned 丢一个清理后的影片，几秒后到 /vol1/media/library 检查是否出现了刮削好的副本（含 .nfo、-poster.jpg）。
• 若配合 Jellyfin/Emby，刷新后应出现海报墙。

常见问题

• 海报刮不出来：多半是 TMDB Key 没配，或无法访问 TMDB（国内网络需在媒体库设置里配代理/TMDB 备用源）。
• 没自动触发：确认源目录路径和目录同步里的监控路径一致；看容器日志 docker logs nas-tools。