如果你手里的 NAS 是群晖、飞牛、极空间或者绿联想解决“下载完资源后还要手动改名、挪目录、更新海报墙、再通知家里人”这一连串重复劳动那 nastool v2 值得花一个下午部署起来。它的核心定位不是下载工具而是把订阅、索引、下载、整理、通知这些环节串成一条自动化流程。下面按真实部署顺序拆先在哪些平台能跑、容器怎么起、首次启动后先改哪些配置、什么时候再开批量订阅最后列出我在多个平台上常见的踩坑点。1. 先搞清楚 nastool v2 在 NAS 媒体管理里的定位很多人第一次看到 nastool容易把它和 qBittorrent、Transmission 混在一起。实际上 nastool v2 不负责“把文件拉下来”这件事它更像一个调度中心。你给它配置好索引器、下载器、媒体目录之后它负责判断“该下什么、去哪搜、下完放哪、按什么规则整理、整理好后通知谁”。想清楚这个定位后面配置的时候就不容易绕晕。1.1 它不是下载器而是调度中心nas-tool 这类工具最早流行起来就是因为 NAS 用户手动下载媒体文件之后还要面对一堆后续工作文件命名不一致、剧集分错季、电影散落多个目录、海报墙一直刮不出正确信息。nastool v2 把“下载完成后的那堆事”统一接管了。实际使用中下载这个动作还是交给 qBittorrent、Transmission 这类下载器完成。nastool v2 会通过接口把你想要的内容发送给下载器然后等下载器回调完成消息。所以你在部署之前需要先想清楚整条链路资源从哪个索引器搜索下载器通过什么端口、什么用户认证下载目录和媒体目录在宿主机上怎么映射整理后的文件放在哪个路径整理完成后通知发到哪个应用这一条链路全部通顺nastool v2 才算是真正跑起来。如果只是把容器启动界面打开那离可用还差很远。1.2 从手动维护到自动化闭环传统 NAS 媒体管理流程通常是手动搜索资源 → 下载 → 改文件名 → 分类移到电影或剧集目录 → 刷新 Jellyfin/Emby/Plex 媒体库。这个流程偶尔做一次还行积累到几百部电影、几十部剧集以后维护成本会很高。nastool v2 把流程改成订阅驱动你在界面上订阅一部电影或一部剧它会根据你设置的搜索策略去索引器里找候选资源交给下载器下载完成后自动按你的目录规则整理随后触发媒体服务器扫描最后把结果通过 Bark、Server酱、Telegram 等通知推送给你。这套闭环的价值不只是“少点几次鼠标”更重要的是它把状态管理起来哪些资源已经下载过、哪些还在等待、哪些质量不够好需要替换、哪些剧集缺了季。只要你目录映射和整理规则设置得当它就不会像手动维护那样反复出现重复文件。1.3 适合人群和平台边界如果你的使用场景只是偶尔下一个文件手动整理也能接受那 nastool v2 不一定适合。它更适合家里有媒体库、下载量比较大、多个设备需要统一播放、又不想为文件命名操心的用户。平台边界其实很清晰只要你的 NAS 能跑 Docker理论上都能运行 nastool v2。群晖用 Container Manager飞牛用 fnOS 自带 Docker极空间和绿联的新系统也都开放了 Docker。四个平台真正有差异的地方不是软件本身而是文件路径、权限、网络模式、端口映射这些系统层细节。所以下面先按四个平台分别梳理准备条件再给一套通用配置模板。2. 四个 NAS 平台的部署准备Docker、目录和端口部署 nastool v2 之前先把 Docker 入口确认好。不同 NAS 管理界面差别很大但底层都差不多。提前建好配置目录、确认端口不被占用能省掉后面很多排查时间。2.1 群晖先确认 Container Manager群晖新系统预装了 Container Manager旧版本叫 Docker 套件。如果套件中心里没有先安装它。群晖上建议给 nastool 单独建一个目录比如/volume1/docker/nastool/config不建议直接放到某个用户的家目录下因为后面你用命令行或容器管理界面操作时路径会显得很乱。群晖还有一个容易踩的点是权限容器内的进程用户要和宿主机可写的目录用户对应上。你可以在 compose 配置里通过 PUID、PGID 指定用户也可以用current user方式创建容器关键是要保证 config 目录可写。2.2 飞牛fnOS 把 Docker 和 Compose 都内置了飞牛 fnOS 最近热度很高系统自带 Docker 应用界面比较友好。在飞牛上创建 nastool 容器时需要先确定你要把配置放在系统盘还是数据盘。建议放在数据盘后续重装系统不会丢配置。飞牛的存储路径习惯和群晖不同常见路径类似/vol1、/vol2这种卷挂载方式。你在 compose 文件里写宿主机路径时一定要先通过飞牛的文件管理器确认真实路径不要凭感觉填。飞牛有个好处是 Docker Compose 支持比较直接新建项目、贴配置、启动就能看到容器状态和日志对新手比较友好。2.3 极空间Docker 在系统设置里注意存储空间映射极空间部分机型在 Docker 创建页面里的默认路径不是特别直观。建议先把存储空间管理里的路径记下来再映射给容器。极空间默认网络模式很多是 bridge如果你后面要连接同一台机器上的 qBittorrent 或 Transmission优先使用宿主机内网 IP比如192.168.1.10不要用127.0.0.1。如果你的极空间上还跑着 Jellyfin、Emby、Plex 这类媒体服务器最好把媒体目录统一整理到一个共享文件夹下这样 nastool 和媒体服务器映射同一个目录后面不会出现“一边看到文件另一边扫描不到”的尴尬情况。2.4 绿联UGOS Pro 的 Docker 应用绿联 NAS 新系统 UGOS Pro 自带 Docker界面逻辑和群晖差别不大。绿联共享文件夹路径可能包含中文或空格这在 compose 配置里会比较麻烦。如果共享文件夹名有空格路径要用引号包起来或者在新建共享文件夹时尽量用英文字母。绿联上部署 nastool v2我个人会先在应用中心确认 Docker 应用已经安装并且能正常拉取镜像。部分型号或系统版本可能在网络设置有差异如果镜像拉取慢可以配置国内镜像源但要确认源地址可靠避免拉到错误版本。平台Docker 入口路径习惯部署注意点群晖Container Manager / Docker 套件/volume1、/volume2权限、路径好认但界面项多飞牛fnOS 自带 Docker/vol1、/vol2 等卷路径Compose 支持好建议配置放数据盘极空间系统设置里的 Docker 应用存储空间管理路径bridge 网络下注意用宿主机 IP绿联UGOS Pro 应用中心 Docker共享文件夹路径路径中英文和空格容易出错3. 一套 docker-compose 模板四个平台通用改法不管哪个平台我都建议用 docker-compose 方式部署而不是在界面上一个个点选容器配置。原因很简单compose 文件可以保存、可以对比、重装后恢复快。3.1 先建目录再写配置第一次部署不要急着贴 compose。先把目录结构想好。以群晖为例我会先创建下面几个目录mkdir -p /volume1/docker/nastool/config mkdir -p /volume1/media/电影 mkdir -p /volume1/media/电视剧 mkdir -p /volume1/media/下载飞牛、极空间、绿联同样把/volume1替换成你机器上的实际存储路径。媒体目录、下载目录尽量放在同一个存储空间下这一点后面讲硬链接时会再强调。3.2 最小可运行配置下面是一套最小可运行的 compose 配置适用于四个平台services: nastool: image: nastool/nas-tools:latest container_name: nastool restart: always ports: - 3000:3000 environment: - PUID1000 - PGID1000 - TZAsia/Shanghai - NASTOOL_AUTO_UPDATEfalse volumes: - /volume1/docker/nastool/config:/config - /volume1/media:/media如果你拉取到的镜像名和上面的不一致以官方页面为准把image那一行替换掉即可。NASTOOL_AUTO_UPDATE我建议先设为false避免容器内自动更新带来不可预期的版本变化。启动命令docker compose up -d首次启动后先确认容器状态再打开页面。3.3 端口、目录映射和权限要注意的三件事第一是端口。默认 Web 页面是 3000如果 NAS 上已经有服务占用 3000可以改成ports: - 3001:3000这样外部访问http://NAS的IP:3001。第二是目录映射。宿主机路径在前容器内路径在后。nastool 界面里填写的路径是容器内路径不是宿主机路径。举例来说群晖里你把媒体放在/volume1/media映射到容器内/media那么在 nastool 界面里添加媒体目录时要填/media/电影而不是/volume1/media/电影。这一步最容易绕晕。第三是权限。容器内进程如果用 PUID1000宿主机上的 config 目录就要允许 uid 1000 的用户写入。如果权限不对日志里会出现 permission denied页面可能打不开或者配置保存不成功。简单判断方法是先在宿主机上确认 config 目录的属主再对照 compose 里的 PUID/PGID。注意路径优先使用容器内路径。凡是“明明映射了却看不到文件”的问题十有八九是你把宿主机路径和容器内路径搞混了。4. 首次启动后的核心配置目录、索引器、下载器容器能启动只是第一步。nastool v2 真正能不能用取决于首次启动后的几组配置。下面按顺序操作不要跳步。4.1 打开页面和初始化账号容器启动后浏览器访问http://NAS的IP:3000第一次进入时按页面提示初始化管理员账号。设置完成后立刻把默认密码改掉或者直接用一个强度足够的密码。这个服务暴露在局域网里可能还好但如果做了端口转发或内网穿透弱密码风险会明显放大。如果页面打不开先看容器状态和日志docker ps docker logs nastool日志里如果能看见正在监听 3000 端口说明程序起来了问题多半出在端口映射、防火墙或你访问的 IP 不对。4.2 媒体目录与容器内路径必须一一对应这一步是整个配置里最核心、也最容易出问题的地方。nastool v2 里的媒体路径全部以容器内视角来填。你需要知道自己把哪些宿主机目录映射到了容器里。例如 compose 里写过volumes: - /volume1/media:/media那你在 nastool 里添加电影目录时应该写/media/电影而不是/volume1/media/电影同样的逻辑也适用于下载器。如果你给 qBittorrent 也映射了同一个/media目录那下载器回调路径和 nastool 整理路径就能对上。如果下载器和 nastool 使用不同的目录结构后续自动整理时会出现“找不到文件”的报错。4.3 索引器配置索引器解决“去哪搜”。nastool v2 支持索引器接口也可以直接配置你常用的资源站。第一次配置时不要把所有站点都填进去先添加一个测试搜索能返回结果再逐个加。原因是搜索操作会并发请求所有已启用的索引器如果你一次性添加太多一次搜索就会触发大量请求响应慢而且容易被站点限流。正确做法是按资源类型分别启用电影用一个剧集用一个等你熟悉了搜索返回质量后再扩大范围。如果搜索无结果先不要怀疑工具按这个顺序排查该资源站能否在浏览器里正常访问容器内能否访问该资源站的域名和端口索引器填写的 Cookie 或认证信息是否过期NAS 的 DNS 和 IPv6 设置是否影响请求这里尤其要注意 DNS 问题。有些 NAS 的 Docker bridge 网络默认 DNS 不稳定表现为所有索引器都超时。这时可以在 compose 里给容器指定 DNS例如dns: - 223.5.5.5 - 8.8.8.8但这只是一个通用建议实际根据你 NAS 的网络情况来调整。4.4 下载器配置以 qBittorrent 为例。先确认 qBittorrent 已开启 WebUI 远程访问并设置好用户名密码。然后在 nastool 的下载器配置里填 qBittorrent 的地址和认证信息。这里最容易犯的错是填localhost或127.0.0.1。如果 nastool 容器和 qBittorrent 不在同一个容器网络命名空间里这个地址指向的是 nastool 容器自己当然连不上。多数情况下应该填宿主机内网 IP比如http://192.168.1.10:8080如果你把 nastool 和 qBittorrent 放在同一个 compose 项目里并且自定义了网络也可以直接用服务名作为主机名。这个要看你 compose 怎么组织不能一概而论。Transmission 的配置也类似除了地址和端口还要注意 RPC 白名单。如果开了 RPC 认证在 nastool 里填对用户名密码测试连接成功后再保存。注意下载器连接不上时先看 WebUI 能不能在浏览器里打开再回过来检查地址、端口、网络模式。不要一上来反复修改 nastool 里的参数。5. 订阅、自动整理和通知把流程串成闭环配置好目录、索引器、下载器之后nastool v2 的“骨架”已经搭好。接下来要做的是把真正面向日常使用的功能跑起来。5.1 从一次手动搜索开始不要急着添加大量订阅。先手动搜索一部你确定能搜到的电影看完整链路是否通顺。手动搜索的结果会显示候选资源确认能返回结果后再手动选择发送到下载器。下载器收到任务后等它下载完成。nastool 需要能收到下载器的“完成回调”。如果下载完成后没有自动整理先打开 nastool 日志看是否收到了下载器通知。如果根本没有回调多半是下载器配置里的地址、端口、认证有问题或者两者网络隔离导致回调失败。一条手动链路跑通后再开订阅功能。5.2 订阅规则不要一开始就拉满订阅是 nastool v2 最省心的功能但也是把双刃剑。订阅规则设置太宽比如质量不限、搜索间隔很短、资源类型不区分电影和剧集会导致索引器请求频繁、下载器排队混乱还会下载到很多你并不想要的结果。我建议第一次添加订阅时按下面的方式设置先只订阅一部电影或一部剧搜索周期调长默认值通常可以先用质量选择设置合理的范围优先蓝光原盘或 1080p 以上但不要同时允许过多格式定期检查订阅列表里哪些是卡住的批量订阅适合你已经熟悉规则之后再开。如果一开始就导入了几十条订阅出了问题时你很难判断是索引器问题、下载器问题还是规则冲突。5.3 自动整理和硬链接自动整理是 nastool v2 的核心价值之一。下载完成后它会按你设置的目录规则把文件移动到电影、电视剧、动漫等对应目录并按标准格式重命名。这样 Jellyfin、Emby、Plex 就能正确刮削海报和简介。但整理方式要提前想清楚。硬链接是推荐选择因为整理后的文件和下载文件指向同一份磁盘数据不额外占用一份空间看起来像复制了一份实际不占双倍容量。硬链接的好处是如果下载目录还在做任务整理后的媒体文件可以正常被播放器扫描不会破坏文件状态。硬链接有一个硬性前提下载目录和媒体目录必须在同一个文件系统上。也就是说如果下载目录在硬盘 1媒体目录在硬盘 2跨盘之后硬链接会失败系统会自动降级为复制或软链接。复制会占空间软链接到外接设备或跨设备播放时可能不稳定。如果你遇到“整理失败”先检查这两个目录是不是在同一个存储空间下。不要把问题直接归到 nastool 不兼容你的 NAS。5.4 通知配置自动化跑起来之后通知很重要。没有通知你根本不知道订阅什么时候完成、什么时候失败。nastool v2 支持 Bark、Server酱、Telegram 等多种通知渠道。配置通知时除了填 token还要注意 NAS 能否访问对应服务地址。有些 NAS 的 Docker bridge 网络下 DNS 或 IPv6 设置有问题通知一直发不出去。现象是任务明明完成了日志里却只看到推送失败或超时。建议配置完成后先在通知页面发一条测试通知确认能收到再等真实任务。如果测试失败先把通知服务地址在浏览器里打开看能不能访问再检查容器内 DNS。6. 四个平台实测容易踩的坑和排查顺序这部分是我实际部署过程中最常遇到的几类问题。每台 NAS 的具体情况不同但排查思路基本一致先看现象再看输入然后看环境最后看参数。6.1 启动失败先看日志再调配置容器一直重启、页面打不开、配置保存不了这类问题先看日志docker logs nastool常见原因就几种config 目录权限不足端口被占用镜像拉取不完整PUID/PGID 设置不对宿主机路径不存在或写错不要一上来就改端口、加参数。先看日志最后几行定位是什么错误。如果日志里出现Permission denied先看宿主机上 config 目录的属主再调整 compose 里的 PUID、PGID或者直接使用chmod调整目录权限。6.2 下载器连不上先分清网络模式这个坑在极空间、群晖、绿联上都可能出现。bridge 模式下nastool 容器内部和宿主机是隔离的连接 qBittorrent 时填localhost肯定不行要填宿主机内网 IP。host 模式下则相反可以直接填127.0.0.1。判断方法很简单先看 qBittorrent 的监听端口在浏览器里访问一下http://NAS的IP:8080能不能打开。能打开再回到 nastool 里填同样的地址。如果浏览器都打不开问题根本不在 nastool。有些用户把 nastool 和 qBittorrent 装在同一台 NAS 上但一个是 Docker 安装一个是套件安装网络模式完全不同。这种情况优先用宿主机 IP最稳。6.3 自动整理失败目录和文件系统是主要怀疑点如果你发现下载器完成了但 nastool 没有整理或者整理报错按这个顺序排查下载器回调是否成功到达 nastool下载目录和媒体目录是否在同一个文件系统目标目录是否有写入权限是否已有同名文件导致命名冲突媒体目录路径在容器内是否真实存在不要反复在界面上点“重新整理”几十次这会把真正的问题掩盖。建议先手动把一个测试文件放到下载目录触发一次整理观察日志。6.4 容易和 nastool 混在一起的场景很多热搜词和问题其实和 nastool 没有直接关系。例如“群晖 Jellyfin 硬件加速”这是在媒体服务器 Jellyfin 里配置的nastool 只负责整理文件不负责转码。海报墙、硬解、播放都是 Jellyfin/Emby/Plex 自己负责。飞牛上装 MySQL、极空间部署 GitLab、绿联搭监控也都属于 Docker 通用能力。nastool 只是其中一个容器。如果你把某个服务和 nastool 放在同一台 NAS 上端口冲突、网络模式冲突、资源占用冲突都会出现但解决思路是一样的先隔离排查。IPv6 也是一个容易误判的点。某些 NAS 的 Docker bridge 网络对 IPv6 支持不完整表现为索引器、通知服务超时。如果你确认密钥和地址都没问题可以先切换成 IPv4 地址测试或者在 compose 里指定 DNS。这个问题并不代表 nastool v2 不支持某个平台只是网络环境需要调整。我个人更建议先把单条链路跑通再逐步加订阅、索引器和通知。很多问题看起来是功能不支持实际是网络模式、目录映射和权限没有对齐。nastool v2 在群晖、飞牛、极空间、绿联上都能稳定跑只是每台机器都要花点时间把路径和端口理清楚。等到下载器、索引器、媒体目录三条线都对上了这套自动化才能真正省事。