在家庭影音和自動化管理領域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更能建立起一套穩健、高效、安全的家庭媒體自動化管理體系。從手動搜索下載到全自動追劇體驗的提升是巨大的。