在家庭影音和自动化管理领域NAS网络附加存储早已超越了简单的文件存储功能成为集下载、整理、播放于一体的家庭媒体中心。然而面对PT/BT站点、豆瓣、TMDB等多个信息源如何自动化地完成影视资源的搜索、下载、识别、整理和通知一直是个繁琐的痛点。手动操作不仅耗时耗力还容易出错。NASTool 的出现正是为了解决这一系列自动化难题。它是一款强大的NAS媒体库自动化管理工具能够将你的NAS打造成一个智能的“私人影院管家”。近期NASTool V2 版本的发布带来了更现代化的界面、更稳定的架构以及对更多NAS平台的广泛支持包括群晖Synology、飞牛FeiniuOS、极空间ZSpace、绿联UGREEN和威联通QNAP等主流品牌让更多用户能够轻松享受到自动化带来的便利。本文将为你带来一份从零开始的 NASTool V2 保姆级安装与配置教程。无论你是上述任一NAS品牌的新手用户还是希望从旧版升级的资深玩家都能通过本文掌握完整的部署流程、核心功能配置以及排错技巧最终实现影视资源的全自动管理。1. NASTool V2 核心概念与工作原理在开始动手安装之前理解 NASTool 的核心价值和工作机制能帮助你更好地进行后续的配置和问题排查。1.1 NASTool 是什么NASTool 是一个开源项目其主要功能是自动化管理你的媒体库。你可以将它理解为一个高度可定制的“机器人”或“调度中心”。它的核心工作流程是监控 - 识别 - 下载 - 整理 - 通知。监控监控你指定的PT/BT站点通过RSS或API、豆瓣想看列表、TMDB收藏夹等发现新的、符合你需求的资源。识别利用强大的刮削器如 TMDB、豆瓣对下载完成的文件进行识别获取准确的影视元数据如海报、简介、演员、评分、分类等。整理根据你设定的命名规则和目录结构将识别后的文件自动移动到媒体库的正确位置例如/media/movies/电影名 (年份)/电影名 (年份).mkv。通知通过 Telegram、微信、Bark 等渠道向你发送任务执行结果的通知如下载完成、整理成功、识别失败等。1.2 V2 版本带来了哪些重要更新V2 版本是基于 V1 版本的一次重大重构和升级主要体现在以下几个方面技术栈现代化后端从 Python 迁移到了性能更好、更易于维护的现代框架前端界面也进行了全面重写交互更流畅。安装方式统一大力推广并优化了Docker安装方式。Docker 提供了近乎一致的环境彻底解决了因系统依赖、Python版本不同导致的“我能运行你报错”的难题使得跨平台群晖、飞牛、极空间等部署变得异常简单。配置逻辑优化对部分复杂配置进行了简化和重组降低了新手入门门槛。更好的扩展性为未来的插件系统和更丰富的媒体源支持打下了基础。1.3 它如何与你的NAS生态协作NASTool 本身不提供下载和媒体播放功能它是一个“大脑”需要指挥“四肢”工作。典型的家庭媒体中心架构如下互联网资源站 (PT/BT/RSS) ↓ NASTool (大脑监控、决策、调度) ↓ 下载工具 (四肢执行下载) (如qBittorrent, Transmission) ↓ NAS存储 (仓库存放文件) ↓ 媒体服务器 (展示播放和管理) (如Jellyfin, Emby, Plex)你需要提前准备好下载工具如 qBittorrent和媒体服务器如 Jellyfin。NASTool 会通过它们的 Web API 进行控制。2. 安装环境准备由于 Docker 是 V2 版最推荐且兼容性最好的安装方式我们的教程将围绕 Docker 展开。无论你使用哪种NAS确保满足以下前提条件。2.1 硬件与系统要求NAS设备任意支持 Docker 的 x86_64 或 ARM64 架构的 NAS群晖、威联通、飞牛、极空间、绿联云等或普通 Linux 服务器。内存建议至少 2GB 可用内存。运行 NASTool 本身占用不大但需要为 Docker 和后续其他容器留出空间。存储空间需要为 NASTool 的配置文件和缓存数据预留少量空间几百MB到1GB媒体文件存储在单独的卷上。2.2 必须的配套服务在安装 NASTool 之前请确保以下服务已经部署并正常运行并记录好它们的访问信息下载工具二选一或都备qBittorrent推荐使用功能强大与 NASTool 集成好。需记录Web UI 地址如http://NAS_IP:8080、用户名、密码。Transmission轻量级选择。需记录Web UI 地址、用户名、密码。媒体服务器至少选一个Jellyfin开源免费功能全面推荐。Emby部分高级功能需付费。Plex商业软件外网访问体验好。需记录Web UI 地址、API 密钥在服务器设置中可生成。媒体信息刮削源用于识别电影电视剧TMDB主要刮削源需要去其官网注册账号并申请 API Key免费。豆瓣辅助刮削源用于中文内容可能需要配置 Cookie非必须但推荐。2.3 获取关键信息请准备一个文本文件记录以下信息后续配置会频繁用到NAS 的 IP 地址。计划存放媒体文件的目录路径例如/volume1/media群晖、/mnt/HDD/media通用Linux。计划存放 NASTool 配置文件的目录路径例如/volume1/docker/nastool群晖。上述下载工具和媒体服务器的访问地址、端口、用户名、密码、API密钥。TMDB 的 API Key。3. 通过 Docker 安装 NASTool V2Docker 安装的核心是创建一个容器并将宿主机的目录存储配置和媒体文件映射到容器内部。不同NAS系统的 Docker 图形界面操作逻辑类似。3.1 创建配置和数据目录首先在 NAS 的文件系统中创建用于持久化 NASTool 数据的目录。以在/volume1/docker下创建为例# 通过SSH连接到NAS后执行或在NAS的File Station中创建 mkdir -p /volume1/docker/nastool/config mkdir -p /volume1/docker/nastool/dataconfig用于存放 NASTool 的核心配置文件、数据库等非常重要必须持久化。data可选可用于存放临时数据或日志建议一并创建并持久化。3.2 使用 Docker CLI 命令安装通用方法如果你熟悉命令行以下命令适用于所有支持 Docker 的 Linux 系统包括NAS的SSH终端。请替换其中的路径为你实际创建的路径。docker run -d \ --name nastool \ --restart unless-stopped \ -p 3000:3000 \ # 将宿主机的3000端口映射到容器的3000端口 -v /volume1/docker/nastool/config:/config \ # 映射配置目录 -v /volume1/media:/media \ # 映射你的媒体文件根目录 -v /volume1/docker/nastool/data:/data \ # 映射数据目录 -e PUID0 \ # 用户ID0为root根据你的NAS权限设置群晖通常用0 -e PGID0 \ # 用户组ID -e UMASK022 \ -e TZAsia/Shanghai \ # 设置时区 --network host \ # 使用host网络模式简化容器与宿主机其他服务如下载器的通信 jxxghp/nas-tools:latest参数解释--name nastool为容器指定一个名字便于管理。--restart unless-stopped容器意外退出时自动重启除非手动停止。-p 3000:3000端口映射。宿主机端口:容器端口。访问http://你的NAS_IP:3000即可进入 NASTool Web界面。-v目录映射卷挂载。宿主机路径:容器内路径。这是持久化数据的关键。-e PUID/PGID设置容器内运行进程的用户和组ID需与宿主机上媒体文件的所有者匹配否则可能无权限读写。在群晖中root的 UID/GID 通常是0。--network host使用主机网络。强烈推荐这样容器内的 NASTool 可以直接通过localhost或127.0.0.1访问宿主机上运行的其他服务如下载器无需复杂的IP配置。3.3 在各类NAS图形界面中安装对于不习惯命令行的用户各品牌NAS的 Docker 图形化管理工具如群晖的 Container Manager威联通的 Container Station极空间/飞牛/绿联的 Docker 应用操作大同小异。通用图形界面步骤在 Docker 应用中点击“搜索”或“注册表”输入jxxghp/nas-tools。选择latest标签下载镜像。镜像下载完成后点击“启动”或“创建容器”。端口设置添加端口映射容器端口填3000本地端口填3000或其他未被占用的端口。卷/文件夹设置添加文件夹映射。装载路径/config- 宿主机路径/volume1/docker/nastool/config装载路径/media- 宿主机路径/volume1/media你的媒体根目录(可选) 装载路径/data- 宿主机路径/volume1/docker/nastool/data环境变量添加环境变量。TZAsia/ShanghaiPUID0PGID0UMASK022网络选择“host”网络模式如果选项中有。完成创建并启动容器。3.4 验证安装容器启动后等待约30秒到1分钟。然后在浏览器中访问http://你的NAS_IP:3000。 如果看到 NASTool 的登录界面首次使用可能需要初始化管理员账号说明安装成功。4. 基础配置与核心功能设置首次登录后你需要进行一系列配置将 NASTool 与你的下载工具、媒体服务器等连接起来。4.1 系统初始化与基础设置首次登录访问NAS_IP:3000根据提示设置管理员用户名和密码。修改默认密码登录后务必在“系统设置” - “安全”中修改默认密码。设置媒体库目录进入“系统设置” - “媒体库”。添加你的媒体根目录例如/media这是在容器内看到的路径对应你之前映射的宿主机路径。并设置电影、电视剧的分类目录如/media/movies,/media/tv。4.2 配置下载器这是自动化流程的“执行臂”。进入“系统设置” - “下载器”。点击“添加下载器”选择你使用的类型如 qBittorrent。关键配置项名称自定义如my_qb。主机由于我们使用了--network host模式下载器如果也运行在宿主机上这里填127.0.0.1或localhost。如果下载器是另一个容器且在同一自定义桥接网络中则填容器名。端口下载器Web UI的端口如 qBittorrent 默认是8080。用户名/密码下载器的登录凭据。下载目录填写下载器容器内的默认下载保存路径。例如qBittorrent 容器内路径可能是/downloads。这个目录必须能被 NASTool 容器访问到。通常的实践是让下载器和 NASTool 都将同一个宿主机目录如/volume1/downloads映射为各自容器内的路径如都映射为/downloads这样 NASTool 才能处理下载完成的文件。点击“测试连接”显示成功即可保存。4.3 配置媒体服务器这是自动化流程的“成果展示端”。进入“系统设置” - “媒体服务器”。点击“添加媒体服务器”选择类型如 Jellyfin。关键配置项主机同上如果媒体服务器运行在宿主机填127.0.0.1。端口媒体服务器端口如 Jellyfin 是8096。API密钥在 Jellyfin/Emby/Plex 的管理后台生成并填入。测试连接并保存。4.4 配置消息通知可选但推荐设置通知可以在任务完成或出错时及时收到提醒。进入“系统设置” - “消息通知”。支持 Telegram、微信、Bark、Server酱等。以 Telegram 为例需要先向BotFather申请一个 Bot获取Token。然后与你的 Bot 对话获取你的Chat ID。在 NASTool 中填入Token和Chat ID并开启需要的通知类型下载完成、整理完成等。4.5 配置索引器与订阅这是自动化流程的“信息来源”。TMDB在“系统设置” - “媒体” - “TMDB”中填入你申请的 API Key。这是识别影视信息的主要来源。豆瓣在“系统设置” - “媒体” - “豆瓣”中可以填入 Cookie用于同步“想看”列表非必须。站点资源在“站点管理”中可以添加你拥有的 PT 站点的 Cookie 或 API用于 RSS 自动刷流、搜索等功能。此部分涉及具体站点请谨慎操作并遵守站点规则。5. 实战实现一部电影的全自动下载与整理让我们通过一个完整的例子串联起所有配置。目标自动下载豆瓣评分8.5以上的《星际穿越》1080p REMUX版本。5.1 步骤一添加订阅在 NASTool 首页点击“电影” - “添加订阅”。在搜索框输入“星际穿越”选择正确的影片。在订阅设置中类型电影质量选择1080pREMUX过滤规则可以设置“标题包含Interstellar”、“排除标题包含x265”如果你不想要H.265编码等。搜索站点选择你已配置的 PT 站点。保存路径选择/media/movies你之前设置的媒体库电影目录。下载器选择my_qb你配置的下载器。点击“确定”保存订阅。NASTool 会立即执行一次搜索并在后台持续监控 RSS。5.2 步骤二自动下载与识别NASTool 搜索到符合条件的资源后会自动发送下载链接到 qBittorrent。你可以在“下载”页面看到任务状态。下载完成后NASTool 会监控到 qBittorrent 中任务完成自动触发“目录监控”功能。5.3 步骤三文件整理与重命名NASTool 的“目录监控”功能会扫描下载完成目录/downloads。找到《星际穿越》的文件后它会调用 TMDB API 进行识别。识别成功后根据你设定的“媒体库”和“重命名规则”在“系统设置”-“媒体库”中配置将文件从/downloads硬链接或移动到媒体库目录/media/movies/Interstellar (2014)/下并重命名为如Interstellar (2014).mkv。硬链接推荐方式。文件数据只有一份但在两个目录下都有入口不占用额外空间适合做种。整理完成后NASTool 可以可选通知媒体服务器Jellyfin刷新库。5.4 步骤四成果验收打开 Jellyfin进入电影库你会发现《星际穿越》已经赫然在列并且海报、简介、演员等信息一应俱全。在 NASTool 的“历史记录”中可以看到完整的“搜索-下载-识别-整理”流水线日志。至此一个完全自动化的流程跑通。你可以通过“订阅”功能批量管理想看的影视剧彻底解放双手。6. 常见问题与故障排查在部署和使用过程中你可能会遇到一些问题。以下是高频问题的排查思路。问题现象可能原因排查与解决思路无法访问 Web 界面 (NAS_IP:3000)1. 容器未成功启动。2. 端口映射错误或被占用。3. NAS防火墙阻止。1. 在 Docker 管理界面查看容器状态是否为“运行中”查看容器日志有无报错。2. 检查-p 3000:3000映射是否正确。尝试更换宿主机端口如-p 3001:3000然后访问NAS_IP:3001。3. 检查 NAS 的防火墙设置放行对应端口。下载器/媒体服务器连接测试失败1. 网络模式问题。2. 地址/端口错误。3. 用户名/密码/API密钥错误。4. 目标服务未运行。1.确保使用host网络模式这是最简单的方式。如果不用 host需确保容器在同一自定义网络并能互通。2. 在宿主机上用curl http://127.0.0.1:8080测试下载器是否可达。3. 仔细核对凭据。4. 确认 qBittorrent、Jellyfin 等服务本身是否正常运行。文件下载完成但未自动整理1. 目录监控未开启或路径错误。2. 下载目录映射不一致。3. 文件识别失败。4. 权限不足。1. 检查“系统设置”-“下载器”中是否开启了“目录监控”并监控了正确的容器内下载路径如/downloads。2.最关键确认 NASTool 容器内看到的下载路径如/downloads和 qBittorrent 容器内设置的下载保存路径是同一个宿主机目录。3. 查看“历史记录”或“系统”-“日志”看识别阶段是否有 TMDB 连接错误或未匹配到信息。4. 检查 PUID/PGID 设置确保 NASTool 有权限读取下载目录和写入媒体库目录。在宿主机上使用ls -l查看目录所有者。媒体服务器搜刮不到整理好的电影1. 媒体服务器未正确配置媒体库路径。2. NASTool 未触发媒体服务器刷新。1. 在 Jellyfin/Emby 中添加媒体库时选择的路径必须是宿主机上的媒体库路径如/volume1/media/movies这个路径需要能被媒体服务器访问。2. 在 NASTool 的媒体服务器设置中开启“库刷新”相关选项。也可以手动在媒体服务器后台触发扫描。NASTool 日志提示“Permission denied”容器内进程用户PUID/PGID无权访问映射的宿主机目录。1. 在宿主机上将你的媒体目录和下载目录的所有者改为与容器内 PUID/PGID 一致的用户。例如chown -R 1000:1000 /volume1/media如果 PUID1000。2. 或者将目录权限改为 777不推荐用于生产环境chmod -R 777 /volume1/media。3.对于群晖在控制面板-共享文件夹-编辑对应文件夹-权限中给Everyone或docker用户如果有读写权限。更新容器后配置丢失启动新容器时没有映射 (-v) 持久化的/config目录。绝对不要直接删除旧容器而不保留/config目录。更新时应使用同样的-v映射参数启动新容器指向同一个宿主机配置目录。你的所有设置都保存在这个目录里。7. 最佳实践与进阶建议配置稳定运行后以下建议可以帮助你打造更高效、更安全的个人媒体自动化系统。7.1 目录结构与权限规划一个清晰、一致的目录结构是自动化的基石。/volume1/ # 存储池根目录 ├── docker/ # 所有Docker应用数据 │ └── nastool/ │ ├── config/ # NASTool配置必须映射 │ └── data/ # NASTool其他数据 ├── downloads/ # 下载目录 │ ├── qbittorrent/ # qBittorrent的下载文件夹 │ └── completed/ # 下载完成区可选用于NASTool监控 └── media/ # 最终媒体库 ├── movies/ # 电影 ├── tv/ # 电视剧 ├── music/ # 音乐 └── documentaries/ # 纪录片权限建议创建一个专用的系统用户如mediaUID1000让 Docker 容器NASTool、qBittorrent、Jellyfin都使用这个用户的 UID/GID 运行并让该用户拥有上述目录的所有权。这样可以最大限度地避免权限问题。7.2 使用 Docker Compose 进行编排对于需要运行多个关联容器NASTool, qBittorrent, Jellyfin的环境使用docker-compose.yml进行编排是更优雅、可复现的方式。创建一个docker-compose.yml文件version: 3.8 services: nastool: image: jxxghp/nas-tools:latest container_name: nastool restart: unless-stopped ports: - 3000:3000 volumes: - /volume1/docker/nastool/config:/config - /volume1/media:/media - /volume1/downloads:/downloads # 统一映射下载目录 environment: - PUID1000 - PGID1000 - UMASK022 - TZAsia/Shanghai network_mode: host # 使用host网络 qbittorrent: image: linuxserver/qbittorrent:latest container_name: qbittorrent restart: unless-stopped environment: - PUID1000 - PGID1000 - TZAsia/Shanghai - WEBUI_PORT8080 volumes: - /volume1/docker/qbittorrent/config:/config - /volume1/downloads:/downloads # 与NASTool映射相同的目录 ports: - 6881:6881 - 6881:6881/udp - 8080:8080 network_mode: host jellyfin: image: jellyfin/jellyfin:latest container_name: jellyfin restart: unless-stopped user: 1000:1000 volumes: - /volume1/docker/jellyfin/config:/config - /volume1/media:/media ports: - 8096:8096 network_mode: host然后在包含此文件的目录下运行docker-compose up -d即可一键启动所有服务。管理、更新、备份都更加方便。7.3 安全强化措施修改默认端口将 NASTool 的 Web 端口从3000改为一个不常用的高位端口如8321减少被扫描的风险。设置强密码NASTool、下载器、媒体服务器的后台密码务必设置为强密码。启用 HTTPS如果通过公网访问务必在 NAS 层面或通过反向代理如 Nginx Proxy Manager配置 HTTPS加密通信。定期备份配置定期备份 NASTool 映射的/config目录。这是你的所有规则和数据库丢失后需要重新配置。权限最小化不要使用root(UID0) 运行容器。创建专用用户并只赋予必要的目录权限。7.4 性能与稳定性优化TMDB API 限制TMDB 的免费 API 有调用频率限制。在 NASTool 的 TMDB 设置中可以适当调大请求间隔避免被限。合理设置 RSS 间隔在站点 RSS 设置中不要将刷新间隔设得太短如小于10分钟以免对站点服务器造成压力或被封禁。使用硬链接而非移动在“系统设置”-“下载器”-“下载设置”中优先选择“硬链接”。这样整理文件时不会中断做种且不占用双倍空间。日志管理定期清理 NASTool 的日志文件防止/config目录无限增大。可以在 Docker 启动命令中添加日志大小限制或使用日志轮转工具。通过以上步骤你不仅能在群晖、飞牛、极空间、绿联、威联通等任意支持 Docker 的 NAS 上成功部署 NASTool V2更能建立起一套稳健、高效、安全的家庭媒体自动化管理体系。从手动搜索下载到全自动追剧体验的提升是巨大的。