# 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`。