化管理：NASTool V2 Docker部署與全流程配置指南)
在家庭影音和自動(dòng)化管理領(lǐng)域NAS網(wǎng)絡(luò)附加存儲(chǔ)早已超越了簡(jiǎn)單的文件存儲(chǔ)功能成為集下載、整理、播放于一體的家庭媒體中心。然而面對(duì)PT/BT站點(diǎn)、豆瓣、TMDB等多個(gè)信息源如何自動(dòng)化地完成影視資源的搜索、下載、識(shí)別、整理和通知一直是個(gè)繁瑣的痛點(diǎn)。手動(dòng)操作不僅耗時(shí)耗力還容易出錯(cuò)。NASTool 的出現(xiàn)正是為了解決這一系列自動(dòng)化難題。它是一款強(qiáng)大的NAS媒體庫自動(dòng)化管理工具能夠?qū)⒛愕腘AS打造成一個(gè)智能的“私人影院管家”。近期NASTool V2 版本的發(fā)布帶來了更現(xiàn)代化的界面、更穩(wěn)定的架構(gòu)以及對(duì)更多NAS平臺(tái)的廣泛支持包括群暉Synology、飛牛FeiniuOS、極空間ZSpace、綠聯(lián)UGREEN和威聯(lián)通QNAP等主流品牌讓更多用戶能夠輕松享受到自動(dòng)化帶來的便利。本文將為你帶來一份從零開始的 NASTool V2 保姆級(jí)安裝與配置教程。無論你是上述任一NAS品牌的新手用戶還是希望從舊版升級(jí)的資深玩家都能通過本文掌握完整的部署流程、核心功能配置以及排錯(cuò)技巧最終實(shí)現(xiàn)影視資源的全自動(dòng)管理。1. NASTool V2 核心概念與工作原理在開始動(dòng)手安裝之前理解 NASTool 的核心價(jià)值和工作機(jī)制能幫助你更好地進(jìn)行后續(xù)的配置和問題排查。1.1 NASTool 是什么NASTool 是一個(gè)開源項(xiàng)目其主要功能是自動(dòng)化管理你的媒體庫。你可以將它理解為一個(gè)高度可定制的“機(jī)器人”或“調(diào)度中心”。它的核心工作流程是監(jiān)控 - 識(shí)別 - 下載 - 整理 - 通知。監(jiān)控監(jiān)控你指定的PT/BT站點(diǎn)通過RSS或API、豆瓣想看列表、TMDB收藏夾等發(fā)現(xiàn)新的、符合你需求的資源。識(shí)別利用強(qiáng)大的刮削器如 TMDB、豆瓣對(duì)下載完成的文件進(jìn)行識(shí)別獲取準(zhǔn)確的影視元數(shù)據(jù)如海報(bào)、簡(jiǎn)介、演員、評(píng)分、分類等。整理根據(jù)你設(shè)定的命名規(guī)則和目錄結(jié)構(gòu)將識(shí)別后的文件自動(dòng)移動(dòng)到媒體庫的正確位置例如/media/movies/電影名 (年份)/電影名 (年份).mkv。通知通過 Telegram、微信、Bark 等渠道向你發(fā)送任務(wù)執(zhí)行結(jié)果的通知如下載完成、整理成功、識(shí)別失敗等。1.2 V2 版本帶來了哪些重要更新V2 版本是基于 V1 版本的一次重大重構(gòu)和升級(jí)主要體現(xiàn)在以下幾個(gè)方面技術(shù)?，F(xiàn)代化后端從 Python 遷移到了性能更好、更易于維護(hù)的現(xiàn)代框架前端界面也進(jìn)行了全面重寫交互更流暢。安裝方式統(tǒng)一大力推廣并優(yōu)化了Docker安裝方式。Docker 提供了近乎一致的環(huán)境徹底解決了因系統(tǒng)依賴、Python版本不同導(dǎo)致的“我能運(yùn)行你報(bào)錯(cuò)”的難題使得跨平臺(tái)群暉、飛牛、極空間等部署變得異常簡(jiǎn)單。配置邏輯優(yōu)化對(duì)部分復(fù)雜配置進(jìn)行了簡(jiǎn)化和重組降低了新手入門門檻。更好的擴(kuò)展性為未來的插件系統(tǒng)和更豐富的媒體源支持打下了基礎(chǔ)。1.3 它如何與你的NAS生態(tài)協(xié)作NASTool 本身不提供下載和媒體播放功能它是一個(gè)“大腦”需要指揮“四肢”工作。典型的家庭媒體中心架構(gòu)如下互聯(lián)網(wǎng)資源站 (PT/BT/RSS) ↓ NASTool (大腦監(jiān)控、決策、調(diào)度) ↓ 下載工具 (四肢執(zhí)行下載) (如qBittorrent, Transmission) ↓ NAS存儲(chǔ) (倉庫存放文件) ↓ 媒體服務(wù)器 (展示播放和管理) (如Jellyfin, Emby, Plex)你需要提前準(zhǔn)備好下載工具如 qBittorrent和媒體服務(wù)器如 Jellyfin。NASTool 會(huì)通過它們的 Web API 進(jìn)行控制。2. 安裝環(huán)境準(zhǔn)備由于 Docker 是 V2 版最推薦且兼容性最好的安裝方式我們的教程將圍繞 Docker 展開。無論你使用哪種NAS確保滿足以下前提條件。2.1 硬件與系統(tǒng)要求NAS設(shè)備任意支持 Docker 的 x86_64 或 ARM64 架構(gòu)的 NAS群暉、威聯(lián)通、飛牛、極空間、綠聯(lián)云等或普通 Linux 服務(wù)器。內(nèi)存建議至少 2GB 可用內(nèi)存。運(yùn)行 NASTool 本身占用不大但需要為 Docker 和后續(xù)其他容器留出空間。存儲(chǔ)空間需要為 NASTool 的配置文件和緩存數(shù)據(jù)預(yù)留少量空間幾百M(fèi)B到1GB媒體文件存儲(chǔ)在單獨(dú)的卷上。2.2 必須的配套服務(wù)在安裝 NASTool 之前請(qǐng)確保以下服務(wù)已經(jīng)部署并正常運(yùn)行并記錄好它們的訪問信息下載工具二選一或都備qBittorrent推薦使用功能強(qiáng)大與 NASTool 集成好。需記錄Web UI 地址如http://NAS_IP:8080、用戶名、密碼。Transmission輕量級(jí)選擇。需記錄Web UI 地址、用戶名、密碼。媒體服務(wù)器至少選一個(gè)Jellyfin開源免費(fèi)功能全面推薦。Emby部分高級(jí)功能需付費(fèi)。Plex商業(yè)軟件外網(wǎng)訪問體驗(yàn)好。需記錄Web UI 地址、API 密鑰在服務(wù)器設(shè)置中可生成。媒體信息刮削源用于識(shí)別電影電視劇TMDB主要刮削源需要去其官網(wǎng)注冊(cè)賬號(hào)并申請(qǐng) API Key免費(fèi)。豆瓣輔助刮削源用于中文內(nèi)容可能需要配置 Cookie非必須但推薦。2.3 獲取關(guān)鍵信息請(qǐng)準(zhǔn)備一個(gè)文本文件記錄以下信息后續(xù)配置會(huì)頻繁用到NAS 的 IP 地址。計(jì)劃存放媒體文件的目錄路徑例如/volume1/media群暉、/mnt/HDD/media通用Linux。計(jì)劃存放 NASTool 配置文件的目錄路徑例如/volume1/docker/nastool群暉。上述下載工具和媒體服務(wù)器的訪問地址、端口、用戶名、密碼、API密鑰。TMDB 的 API Key。3. 通過 Docker 安裝 NASTool V2Docker 安裝的核心是創(chuàng)建一個(gè)容器并將宿主機(jī)的目錄存儲(chǔ)配置和媒體文件映射到容器內(nèi)部。不同NAS系統(tǒng)的 Docker 圖形界面操作邏輯類似。3.1 創(chuàng)建配置和數(shù)據(jù)目錄首先在 NAS 的文件系統(tǒng)中創(chuàng)建用于持久化 NASTool 數(shù)據(jù)的目錄。以在/volume1/docker下創(chuàng)建為例# 通過SSH連接到NAS后執(zhí)行或在NAS的File Station中創(chuàng)建 mkdir -p /volume1/docker/nastool/config mkdir -p /volume1/docker/nastool/dataconfig用于存放 NASTool 的核心配置文件、數(shù)據(jù)庫等非常重要必須持久化。data可選可用于存放臨時(shí)數(shù)據(jù)或日志建議一并創(chuàng)建并持久化。3.2 使用 Docker CLI 命令安裝通用方法如果你熟悉命令行以下命令適用于所有支持 Docker 的 Linux 系統(tǒng)包括NAS的SSH終端。請(qǐng)?zhí)鎿Q其中的路徑為你實(shí)際創(chuàng)建的路徑。docker run -d \ --name nastool \ --restart unless-stopped \ -p 3000:3000 \ # 將宿主機(jī)的3000端口映射到容器的3000端口 -v /volume1/docker/nastool/config:/config \ # 映射配置目錄 -v /volume1/media:/media \ # 映射你的媒體文件根目錄 -v /volume1/docker/nastool/data:/data \ # 映射數(shù)據(jù)目錄 -e PUID0 \ # 用戶ID0為root根據(jù)你的NAS權(quán)限設(shè)置群暉通常用0 -e PGID0 \ # 用戶組ID -e UMASK022 \ -e TZAsia/Shanghai \ # 設(shè)置時(shí)區(qū) --network host \ # 使用host網(wǎng)絡(luò)模式簡(jiǎn)化容器與宿主機(jī)其他服務(wù)如下載器的通信 jxxghp/nas-tools:latest參數(shù)解釋--name nastool為容器指定一個(gè)名字便于管理。--restart unless-stopped容器意外退出時(shí)自動(dòng)重啟除非手動(dòng)停止。-p 3000:3000端口映射。宿主機(jī)端口:容器端口。訪問http://你的NAS_IP:3000即可進(jìn)入 NASTool Web界面。-v目錄映射卷掛載。宿主機(jī)路徑:容器內(nèi)路徑。這是持久化數(shù)據(jù)的關(guān)鍵。-e PUID/PGID設(shè)置容器內(nèi)運(yùn)行進(jìn)程的用戶和組ID需與宿主機(jī)上媒體文件的所有者匹配否則可能無權(quán)限讀寫。在群暉中root的 UID/GID 通常是0。--network host使用主機(jī)網(wǎng)絡(luò)。強(qiáng)烈推薦這樣容器內(nèi)的 NASTool 可以直接通過localhost或127.0.0.1訪問宿主機(jī)上運(yùn)行的其他服務(wù)如下載器無需復(fù)雜的IP配置。3.3 在各類NAS圖形界面中安裝對(duì)于不習(xí)慣命令行的用戶各品牌NAS的 Docker 圖形化管理工具如群暉的 Container Manager威聯(lián)通的 Container Station極空間/飛牛/綠聯(lián)的 Docker 應(yīng)用操作大同小異。通用圖形界面步驟在 Docker 應(yīng)用中點(diǎn)擊“搜索”或“注冊(cè)表”輸入jxxghp/nas-tools。選擇latest標(biāo)簽下載鏡像。鏡像下載完成后點(diǎn)擊“啟動(dòng)”或“創(chuàng)建容器”。端口設(shè)置添加端口映射容器端口填3000本地端口填3000或其他未被占用的端口。卷/文件夾設(shè)置添加文件夾映射。裝載路徑/config- 宿主機(jī)路徑/volume1/docker/nastool/config裝載路徑/media- 宿主機(jī)路徑/volume1/media你的媒體根目錄(可選) 裝載路徑/data- 宿主機(jī)路徑/volume1/docker/nastool/data環(huán)境變量添加環(huán)境變量。TZAsia/ShanghaiPUID0PGID0UMASK022網(wǎng)絡(luò)選擇“host”網(wǎng)絡(luò)模式如果選項(xiàng)中有。完成創(chuàng)建并啟動(dòng)容器。3.4 驗(yàn)證安裝容器啟動(dòng)后等待約30秒到1分鐘。然后在瀏覽器中訪問http://你的NAS_IP:3000。 如果看到 NASTool 的登錄界面首次使用可能需要初始化管理員賬號(hào)說明安裝成功。4. 基礎(chǔ)配置與核心功能設(shè)置首次登錄后你需要進(jìn)行一系列配置將 NASTool 與你的下載工具、媒體服務(wù)器等連接起來。4.1 系統(tǒng)初始化與基礎(chǔ)設(shè)置首次登錄訪問NAS_IP:3000根據(jù)提示設(shè)置管理員用戶名和密碼。修改默認(rèn)密碼登錄后務(wù)必在“系統(tǒng)設(shè)置” - “安全”中修改默認(rèn)密碼。設(shè)置媒體庫目錄進(jìn)入“系統(tǒng)設(shè)置” - “媒體庫”。添加你的媒體根目錄例如/media這是在容器內(nèi)看到的路徑對(duì)應(yīng)你之前映射的宿主機(jī)路徑。并設(shè)置電影、電視劇的分類目錄如/media/movies,/media/tv。4.2 配置下載器這是自動(dòng)化流程的“執(zhí)行臂”。進(jìn)入“系統(tǒng)設(shè)置” - “下載器”。點(diǎn)擊“添加下載器”選擇你使用的類型如 qBittorrent。關(guān)鍵配置項(xiàng)名稱自定義如my_qb。主機(jī)由于我們使用了--network host模式下載器如果也運(yùn)行在宿主機(jī)上這里填127.0.0.1或localhost。如果下載器是另一個(gè)容器且在同一自定義橋接網(wǎng)絡(luò)中則填容器名。端口下載器Web UI的端口如 qBittorrent 默認(rèn)是8080。用戶名/密碼下載器的登錄憑據(jù)。下載目錄填寫下載器容器內(nèi)的默認(rèn)下載保存路徑。例如qBittorrent 容器內(nèi)路徑可能是/downloads。這個(gè)目錄必須能被 NASTool 容器訪問到。通常的實(shí)踐是讓下載器和 NASTool 都將同一個(gè)宿主機(jī)目錄如/volume1/downloads映射為各自容器內(nèi)的路徑如都映射為/downloads這樣 NASTool 才能處理下載完成的文件。點(diǎn)擊“測(cè)試連接”顯示成功即可保存。4.3 配置媒體服務(wù)器這是自動(dòng)化流程的“成果展示端”。進(jìn)入“系統(tǒng)設(shè)置” - “媒體服務(wù)器”。點(diǎn)擊“添加媒體服務(wù)器”選擇類型如 Jellyfin。關(guān)鍵配置項(xiàng)主機(jī)同上如果媒體服務(wù)器運(yùn)行在宿主機(jī)填127.0.0.1。端口媒體服務(wù)器端口如 Jellyfin 是8096。API密鑰在 Jellyfin/Emby/Plex 的管理后臺(tái)生成并填入。測(cè)試連接并保存。4.4 配置消息通知可選但推薦設(shè)置通知可以在任務(wù)完成或出錯(cuò)時(shí)及時(shí)收到提醒。進(jìn)入“系統(tǒng)設(shè)置” - “消息通知”。支持 Telegram、微信、Bark、Server醬等。以 Telegram 為例需要先向BotFather申請(qǐng)一個(gè) Bot獲取Token。然后與你的 Bot 對(duì)話獲取你的Chat ID。在 NASTool 中填入Token和Chat ID并開啟需要的通知類型下載完成、整理完成等。4.5 配置索引器與訂閱這是自動(dòng)化流程的“信息來源”。TMDB在“系統(tǒng)設(shè)置” - “媒體” - “TMDB”中填入你申請(qǐng)的 API Key。這是識(shí)別影視信息的主要來源。豆瓣在“系統(tǒng)設(shè)置” - “媒體” - “豆瓣”中可以填入 Cookie用于同步“想看”列表非必須。站點(diǎn)資源在“站點(diǎn)管理”中可以添加你擁有的 PT 站點(diǎn)的 Cookie 或 API用于 RSS 自動(dòng)刷流、搜索等功能。此部分涉及具體站點(diǎn)請(qǐng)謹(jǐn)慎操作并遵守站點(diǎn)規(guī)則。5. 實(shí)戰(zhàn)實(shí)現(xiàn)一部電影的全自動(dòng)下載與整理讓我們通過一個(gè)完整的例子串聯(lián)起所有配置。目標(biāo)自動(dòng)下載豆瓣評(píng)分8.5以上的《星際穿越》1080p REMUX版本。5.1 步驟一添加訂閱在 NASTool 首頁點(diǎn)擊“電影” - “添加訂閱”。在搜索框輸入“星際穿越”選擇正確的影片。在訂閱設(shè)置中類型電影質(zhì)量選擇1080pREMUX過濾規(guī)則可以設(shè)置“標(biāo)題包含Interstellar”、“排除標(biāo)題包含x265”如果你不想要H.265編碼等。搜索站點(diǎn)選擇你已配置的 PT 站點(diǎn)。保存路徑選擇/media/movies你之前設(shè)置的媒體庫電影目錄。下載器選擇my_qb你配置的下載器。點(diǎn)擊“確定”保存訂閱。NASTool 會(huì)立即執(zhí)行一次搜索并在后臺(tái)持續(xù)監(jiān)控 RSS。5.2 步驟二自動(dòng)下載與識(shí)別NASTool 搜索到符合條件的資源后會(huì)自動(dòng)發(fā)送下載鏈接到 qBittorrent。你可以在“下載”頁面看到任務(wù)狀態(tài)。下載完成后NASTool 會(huì)監(jiān)控到 qBittorrent 中任務(wù)完成自動(dòng)觸發(fā)“目錄監(jiān)控”功能。5.3 步驟三文件整理與重命名NASTool 的“目錄監(jiān)控”功能會(huì)掃描下載完成目錄/downloads。找到《星際穿越》的文件后它會(huì)調(diào)用 TMDB API 進(jìn)行識(shí)別。識(shí)別成功后根據(jù)你設(shè)定的“媒體庫”和“重命名規(guī)則”在“系統(tǒng)設(shè)置”-“媒體庫”中配置將文件從/downloads硬鏈接或移動(dòng)到媒體庫目錄/media/movies/Interstellar (2014)/下并重命名為如Interstellar (2014).mkv。硬鏈接推薦方式。文件數(shù)據(jù)只有一份但在兩個(gè)目錄下都有入口不占用額外空間適合做種。整理完成后NASTool 可以可選通知媒體服務(wù)器Jellyfin刷新庫。5.4 步驟四成果驗(yàn)收打開 Jellyfin進(jìn)入電影庫你會(huì)發(fā)現(xiàn)《星際穿越》已經(jīng)赫然在列并且海報(bào)、簡(jiǎn)介、演員等信息一應(yīng)俱全。在 NASTool 的“歷史記錄”中可以看到完整的“搜索-下載-識(shí)別-整理”流水線日志。至此一個(gè)完全自動(dòng)化的流程跑通。你可以通過“訂閱”功能批量管理想看的影視劇徹底解放雙手。6. 常見問題與故障排查在部署和使用過程中你可能會(huì)遇到一些問題。以下是高頻問題的排查思路。問題現(xiàn)象可能原因排查與解決思路無法訪問 Web 界面 (NAS_IP:3000)1. 容器未成功啟動(dòng)。2. 端口映射錯(cuò)誤或被占用。3. NAS防火墻阻止。1. 在 Docker 管理界面查看容器狀態(tài)是否為“運(yùn)行中”查看容器日志有無報(bào)錯(cuò)。2. 檢查-p 3000:3000映射是否正確。嘗試更換宿主機(jī)端口如-p 3001:3000然后訪問NAS_IP:3001。3. 檢查 NAS 的防火墻設(shè)置放行對(duì)應(yīng)端口。下載器/媒體服務(wù)器連接測(cè)試失敗1. 網(wǎng)絡(luò)模式問題。2. 地址/端口錯(cuò)誤。3. 用戶名/密碼/API密鑰錯(cuò)誤。4. 目標(biāo)服務(wù)未運(yùn)行。1.確保使用host網(wǎng)絡(luò)模式這是最簡(jiǎn)單的方式。如果不用 host需確保容器在同一自定義網(wǎng)絡(luò)并能互通。2. 在宿主機(jī)上用curl http://127.0.0.1:8080測(cè)試下載器是否可達(dá)。3. 仔細(xì)核對(duì)憑據(jù)。4. 確認(rèn) qBittorrent、Jellyfin 等服務(wù)本身是否正常運(yùn)行。文件下載完成但未自動(dòng)整理1. 目錄監(jiān)控未開啟或路徑錯(cuò)誤。2. 下載目錄映射不一致。3. 文件識(shí)別失敗。4. 權(quán)限不足。1. 檢查“系統(tǒng)設(shè)置”-“下載器”中是否開啟了“目錄監(jiān)控”并監(jiān)控了正確的容器內(nèi)下載路徑如/downloads。2.最關(guān)鍵確認(rèn) NASTool 容器內(nèi)看到的下載路徑如/downloads和 qBittorrent 容器內(nèi)設(shè)置的下載保存路徑是同一個(gè)宿主機(jī)目錄。3. 查看“歷史記錄”或“系統(tǒng)”-“日志”看識(shí)別階段是否有 TMDB 連接錯(cuò)誤或未匹配到信息。4. 檢查 PUID/PGID 設(shè)置確保 NASTool 有權(quán)限讀取下載目錄和寫入媒體庫目錄。在宿主機(jī)上使用ls -l查看目錄所有者。媒體服務(wù)器搜刮不到整理好的電影1. 媒體服務(wù)器未正確配置媒體庫路徑。2. NASTool 未觸發(fā)媒體服務(wù)器刷新。1. 在 Jellyfin/Emby 中添加媒體庫時(shí)選擇的路徑必須是宿主機(jī)上的媒體庫路徑如/volume1/media/movies這個(gè)路徑需要能被媒體服務(wù)器訪問。2. 在 NASTool 的媒體服務(wù)器設(shè)置中開啟“庫刷新”相關(guān)選項(xiàng)。也可以手動(dòng)在媒體服務(wù)器后臺(tái)觸發(fā)掃描。NASTool 日志提示“Permission denied”容器內(nèi)進(jìn)程用戶PUID/PGID無權(quán)訪問映射的宿主機(jī)目錄。1. 在宿主機(jī)上將你的媒體目錄和下載目錄的所有者改為與容器內(nèi) PUID/PGID 一致的用戶。例如chown -R 1000:1000 /volume1/media如果 PUID1000。2. 或者將目錄權(quán)限改為 777不推薦用于生產(chǎn)環(huán)境chmod -R 777 /volume1/media。3.對(duì)于群暉在控制面板-共享文件夾-編輯對(duì)應(yīng)文件夾-權(quán)限中給Everyone或docker用戶如果有讀寫權(quán)限。更新容器后配置丟失啟動(dòng)新容器時(shí)沒有映射 (-v) 持久化的/config目錄。絕對(duì)不要直接刪除舊容器而不保留/config目錄。更新時(shí)應(yīng)使用同樣的-v映射參數(shù)啟動(dòng)新容器指向同一個(gè)宿主機(jī)配置目錄。你的所有設(shè)置都保存在這個(gè)目錄里。7. 最佳實(shí)踐與進(jìn)階建議配置穩(wěn)定運(yùn)行后以下建議可以幫助你打造更高效、更安全的個(gè)人媒體自動(dòng)化系統(tǒng)。7.1 目錄結(jié)構(gòu)與權(quán)限規(guī)劃一個(gè)清晰、一致的目錄結(jié)構(gòu)是自動(dòng)化的基石。/volume1/ # 存儲(chǔ)池根目錄 ├── docker/ # 所有Docker應(yīng)用數(shù)據(jù) │ └── nastool/ │ ├── config/ # NASTool配置必須映射 │ └── data/ # NASTool其他數(shù)據(jù) ├── downloads/ # 下載目錄 │ ├── qbittorrent/ # qBittorrent的下載文件夾 │ └── completed/ # 下載完成區(qū)可選用于NASTool監(jiān)控 └── media/ # 最終媒體庫 ├── movies/ # 電影 ├── tv/ # 電視劇 ├── music/ # 音樂 └── documentaries/ # 紀(jì)錄片權(quán)限建議創(chuàng)建一個(gè)專用的系統(tǒng)用戶如mediaUID1000讓 Docker 容器NASTool、qBittorrent、Jellyfin都使用這個(gè)用戶的 UID/GID 運(yùn)行并讓該用戶擁有上述目錄的所有權(quán)。這樣可以最大限度地避免權(quán)限問題。7.2 使用 Docker Compose 進(jìn)行編排對(duì)于需要運(yùn)行多個(gè)關(guān)聯(lián)容器NASTool, qBittorrent, Jellyfin的環(huán)境使用docker-compose.yml進(jìn)行編排是更優(yōu)雅、可復(fù)現(xiàn)的方式。創(chuàng)建一個(gè)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 # 統(tǒng)一映射下載目錄 environment: - PUID1000 - PGID1000 - UMASK022 - TZAsia/Shanghai network_mode: host # 使用host網(wǎng)絡(luò) 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然后在包含此文件的目錄下運(yùn)行docker-compose up -d即可一鍵啟動(dòng)所有服務(wù)。管理、更新、備份都更加方便。7.3 安全強(qiáng)化措施修改默認(rèn)端口將 NASTool 的 Web 端口從3000改為一個(gè)不常用的高位端口如8321減少被掃描的風(fēng)險(xiǎn)。設(shè)置強(qiáng)密碼NASTool、下載器、媒體服務(wù)器的后臺(tái)密碼務(wù)必設(shè)置為強(qiáng)密碼。啟用 HTTPS如果通過公網(wǎng)訪問務(wù)必在 NAS 層面或通過反向代理如 Nginx Proxy Manager配置 HTTPS加密通信。定期備份配置定期備份 NASTool 映射的/config目錄。這是你的所有規(guī)則和數(shù)據(jù)庫丟失后需要重新配置。權(quán)限最小化不要使用root(UID0) 運(yùn)行容器。創(chuàng)建專用用戶并只賦予必要的目錄權(quán)限。7.4 性能與穩(wěn)定性優(yōu)化TMDB API 限制TMDB 的免費(fèi) API 有調(diào)用頻率限制。在 NASTool 的 TMDB 設(shè)置中可以適當(dāng)調(diào)大請(qǐng)求間隔避免被限。合理設(shè)置 RSS 間隔在站點(diǎn) RSS 設(shè)置中不要將刷新間隔設(shè)得太短如小于10分鐘以免對(duì)站點(diǎn)服務(wù)器造成壓力或被封禁。使用硬鏈接而非移動(dòng)在“系統(tǒng)設(shè)置”-“下載器”-“下載設(shè)置”中優(yōu)先選擇“硬鏈接”。這樣整理文件時(shí)不會(huì)中斷做種且不占用雙倍空間。日志管理定期清理 NASTool 的日志文件防止/config目錄無限增大?？梢栽?Docker 啟動(dòng)命令中添加日志大小限制或使用日志輪轉(zhuǎn)工具。通過以上步驟你不僅能在群暉、飛牛、極空間、綠聯(lián)、威聯(lián)通等任意支持 Docker 的 NAS 上成功部署 NASTool V2更能建立起一套穩(wěn)健、高效、安全的家庭媒體自動(dòng)化管理體系。從手動(dòng)搜索下載到全自動(dòng)追劇體驗(yàn)的提升是巨大的。 NAS媒體庫自動(dòng)化管理：NASTool V2 Docker部署與全流程配置指南
在家庭影音和自動(dòng)化管理領(lǐng)域NAS網(wǎng)絡(luò)附加存儲(chǔ)早已超越了簡(jiǎn)單的文件存儲(chǔ)功能成為集下載、整理、播放于一體的家庭媒體中心。然而面對(duì)PT/BT站點(diǎn)、豆瓣、TMDB等多個(gè)信息源如何自動(dòng)化地完成影視資源的搜索、下載、識(shí)別、整理和通知一直是個(gè)繁瑣的痛點(diǎn)。手動(dòng)操作不僅耗時(shí)耗力還容易出錯(cuò)。NASTool 的出現(xiàn)正是為了解決這一系列自動(dòng)化難題。它是一款強(qiáng)大的NAS媒體庫自動(dòng)化管理工具能夠?qū)⒛愕腘AS打造成一個(gè)智能的“私人影院管家”。近期NASTool V2 版本的發(fā)布帶來了更現(xiàn)代化的界面、更穩(wěn)定的架構(gòu)以及對(duì)更多NAS平臺(tái)的廣泛支持包括群暉Synology、飛牛FeiniuOS、極空間ZSpace、綠聯(lián)UGREEN和威聯(lián)通QNAP等主流品牌讓更多用戶能夠輕松享受到自動(dòng)化帶來的便利。本文將為你帶來一份從零開始的 NASTool V2 保姆級(jí)安裝與配置教程。無論你是上述任一NAS品牌的新手用戶還是希望從舊版升級(jí)的資深玩家都能通過本文掌握完整的部署流程、核心功能配置以及排錯(cuò)技巧最終實(shí)現(xiàn)影視資源的全自動(dòng)管理。1. NASTool V2 核心概念與工作原理在開始動(dòng)手安裝之前理解 NASTool 的核心價(jià)值和工作機(jī)制能幫助你更好地進(jìn)行后續(xù)的配置和問題排查。1.1 NASTool 是什么NASTool 是一個(gè)開源項(xiàng)目其主要功能是自動(dòng)化管理你的媒體庫。你可以將它理解為一個(gè)高度可定制的“機(jī)器人”或“調(diào)度中心”。它的核心工作流程是監(jiān)控 - 識(shí)別 - 下載 - 整理 - 通知。監(jiān)控監(jiān)控你指定的PT/BT站點(diǎn)通過RSS或API、豆瓣想看列表、TMDB收藏夾等發(fā)現(xiàn)新的、符合你需求的資源。識(shí)別利用強(qiáng)大的刮削器如 TMDB、豆瓣對(duì)下載完成的文件進(jìn)行識(shí)別獲取準(zhǔn)確的影視元數(shù)據(jù)如海報(bào)、簡(jiǎn)介、演員、評(píng)分、分類等。整理根據(jù)你設(shè)定的命名規(guī)則和目錄結(jié)構(gòu)將識(shí)別后的文件自動(dòng)移動(dòng)到媒體庫的正確位置例如/media/movies/電影名 (年份)/電影名 (年份).mkv。通知通過 Telegram、微信、Bark 等渠道向你發(fā)送任務(wù)執(zhí)行結(jié)果的通知如下載完成、整理成功、識(shí)別失敗等。1.2 V2 版本帶來了哪些重要更新V2 版本是基于 V1 版本的一次重大重構(gòu)和升級(jí)主要體現(xiàn)在以下幾個(gè)方面技術(shù)?，F(xiàn)代化后端從 Python 遷移到了性能更好、更易于維護(hù)的現(xiàn)代框架前端界面也進(jìn)行了全面重寫交互更流暢。安裝方式統(tǒng)一大力推廣并優(yōu)化了Docker安裝方式。Docker 提供了近乎一致的環(huán)境徹底解決了因系統(tǒng)依賴、Python版本不同導(dǎo)致的“我能運(yùn)行你報(bào)錯(cuò)”的難題使得跨平臺(tái)群暉、飛牛、極空間等部署變得異常簡(jiǎn)單。配置邏輯優(yōu)化對(duì)部分復(fù)雜配置進(jìn)行了簡(jiǎn)化和重組降低了新手入門門檻。更好的擴(kuò)展性為未來的插件系統(tǒng)和更豐富的媒體源支持打下了基礎(chǔ)。1.3 它如何與你的NAS生態(tài)協(xié)作NASTool 本身不提供下載和媒體播放功能它是一個(gè)“大腦”需要指揮“四肢”工作。典型的家庭媒體中心架構(gòu)如下互聯(lián)網(wǎng)資源站 (PT/BT/RSS) ↓ NASTool (大腦監(jiān)控、決策、調(diào)度) ↓ 下載工具 (四肢執(zhí)行下載) (如qBittorrent, Transmission) ↓ NAS存儲(chǔ) (倉庫存放文件) ↓ 媒體服務(wù)器 (展示播放和管理) (如Jellyfin, Emby, Plex)你需要提前準(zhǔn)備好下載工具如 qBittorrent和媒體服務(wù)器如 Jellyfin。NASTool 會(huì)通過它們的 Web API 進(jìn)行控制。2. 安裝環(huán)境準(zhǔn)備由于 Docker 是 V2 版最推薦且兼容性最好的安裝方式我們的教程將圍繞 Docker 展開。無論你使用哪種NAS確保滿足以下前提條件。2.1 硬件與系統(tǒng)要求NAS設(shè)備任意支持 Docker 的 x86_64 或 ARM64 架構(gòu)的 NAS群暉、威聯(lián)通、飛牛、極空間、綠聯(lián)云等或普通 Linux 服務(wù)器。內(nèi)存建議至少 2GB 可用內(nèi)存。運(yùn)行 NASTool 本身占用不大但需要為 Docker 和后續(xù)其他容器留出空間。存儲(chǔ)空間需要為 NASTool 的配置文件和緩存數(shù)據(jù)預(yù)留少量空間幾百M(fèi)B到1GB媒體文件存儲(chǔ)在單獨(dú)的卷上。2.2 必須的配套服務(wù)在安裝 NASTool 之前請(qǐng)確保以下服務(wù)已經(jīng)部署并正常運(yùn)行并記錄好它們的訪問信息下載工具二選一或都備qBittorrent推薦使用功能強(qiáng)大與 NASTool 集成好。需記錄Web UI 地址如http://NAS_IP:8080、用戶名、密碼。Transmission輕量級(jí)選擇。需記錄Web UI 地址、用戶名、密碼。媒體服務(wù)器至少選一個(gè)Jellyfin開源免費(fèi)功能全面推薦。Emby部分高級(jí)功能需付費(fèi)。Plex商業(yè)軟件外網(wǎng)訪問體驗(yàn)好。需記錄Web UI 地址、API 密鑰在服務(wù)器設(shè)置中可生成。媒體信息刮削源用于識(shí)別電影電視劇TMDB主要刮削源需要去其官網(wǎng)注冊(cè)賬號(hào)并申請(qǐng) API Key免費(fèi)。豆瓣輔助刮削源用于中文內(nèi)容可能需要配置 Cookie非必須但推薦。2.3 獲取關(guān)鍵信息請(qǐng)準(zhǔn)備一個(gè)文本文件記錄以下信息后續(xù)配置會(huì)頻繁用到NAS 的 IP 地址。計(jì)劃存放媒體文件的目錄路徑例如/volume1/media群暉、/mnt/HDD/media通用Linux。計(jì)劃存放 NASTool 配置文件的目錄路徑例如/volume1/docker/nastool群暉。上述下載工具和媒體服務(wù)器的訪問地址、端口、用戶名、密碼、API密鑰。TMDB 的 API Key。3. 通過 Docker 安裝 NASTool V2Docker 安裝的核心是創(chuàng)建一個(gè)容器并將宿主機(jī)的目錄存儲(chǔ)配置和媒體文件映射到容器內(nèi)部。不同NAS系統(tǒng)的 Docker 圖形界面操作邏輯類似。3.1 創(chuàng)建配置和數(shù)據(jù)目錄首先在 NAS 的文件系統(tǒng)中創(chuàng)建用于持久化 NASTool 數(shù)據(jù)的目錄。以在/volume1/docker下創(chuàng)建為例# 通過SSH連接到NAS后執(zhí)行或在NAS的File Station中創(chuàng)建 mkdir -p /volume1/docker/nastool/config mkdir -p /volume1/docker/nastool/dataconfig用于存放 NASTool 的核心配置文件、數(shù)據(jù)庫等非常重要必須持久化。data可選可用于存放臨時(shí)數(shù)據(jù)或日志建議一并創(chuàng)建并持久化。3.2 使用 Docker CLI 命令安裝通用方法如果你熟悉命令行以下命令適用于所有支持 Docker 的 Linux 系統(tǒng)包括NAS的SSH終端。請(qǐng)?zhí)鎿Q其中的路徑為你實(shí)際創(chuàng)建的路徑。docker run -d \ --name nastool \ --restart unless-stopped \ -p 3000:3000 \ # 將宿主機(jī)的3000端口映射到容器的3000端口 -v /volume1/docker/nastool/config:/config \ # 映射配置目錄 -v /volume1/media:/media \ # 映射你的媒體文件根目錄 -v /volume1/docker/nastool/data:/data \ # 映射數(shù)據(jù)目錄 -e PUID0 \ # 用戶ID0為root根據(jù)你的NAS權(quán)限設(shè)置群暉通常用0 -e PGID0 \ # 用戶組ID -e UMASK022 \ -e TZAsia/Shanghai \ # 設(shè)置時(shí)區(qū) --network host \ # 使用host網(wǎng)絡(luò)模式簡(jiǎn)化容器與宿主機(jī)其他服務(wù)如下載器的通信 jxxghp/nas-tools:latest參數(shù)解釋--name nastool為容器指定一個(gè)名字便于管理。--restart unless-stopped容器意外退出時(shí)自動(dòng)重啟除非手動(dòng)停止。-p 3000:3000端口映射。宿主機(jī)端口:容器端口。訪問http://你的NAS_IP:3000即可進(jìn)入 NASTool Web界面。-v目錄映射卷掛載。宿主機(jī)路徑:容器內(nèi)路徑。這是持久化數(shù)據(jù)的關(guān)鍵。-e PUID/PGID設(shè)置容器內(nèi)運(yùn)行進(jìn)程的用戶和組ID需與宿主機(jī)上媒體文件的所有者匹配否則可能無權(quán)限讀寫。在群暉中root的 UID/GID 通常是0。--network host使用主機(jī)網(wǎng)絡(luò)。強(qiáng)烈推薦這樣容器內(nèi)的 NASTool 可以直接通過localhost或127.0.0.1訪問宿主機(jī)上運(yùn)行的其他服務(wù)如下載器無需復(fù)雜的IP配置。3.3 在各類NAS圖形界面中安裝對(duì)于不習(xí)慣命令行的用戶各品牌NAS的 Docker 圖形化管理工具如群暉的 Container Manager威聯(lián)通的 Container Station極空間/飛牛/綠聯(lián)的 Docker 應(yīng)用操作大同小異。通用圖形界面步驟在 Docker 應(yīng)用中點(diǎn)擊“搜索”或“注冊(cè)表”輸入jxxghp/nas-tools。選擇latest標(biāo)簽下載鏡像。鏡像下載完成后點(diǎn)擊“啟動(dòng)”或“創(chuàng)建容器”。端口設(shè)置添加端口映射容器端口填3000本地端口填3000或其他未被占用的端口。卷/文件夾設(shè)置添加文件夾映射。裝載路徑/config- 宿主機(jī)路徑/volume1/docker/nastool/config裝載路徑/media- 宿主機(jī)路徑/volume1/media你的媒體根目錄(可選) 裝載路徑/data- 宿主機(jī)路徑/volume1/docker/nastool/data環(huán)境變量添加環(huán)境變量。TZAsia/ShanghaiPUID0PGID0UMASK022網(wǎng)絡(luò)選擇“host”網(wǎng)絡(luò)模式如果選項(xiàng)中有。完成創(chuàng)建并啟動(dòng)容器。3.4 驗(yàn)證安裝容器啟動(dòng)后等待約30秒到1分鐘。然后在瀏覽器中訪問http://你的NAS_IP:3000。 如果看到 NASTool 的登錄界面首次使用可能需要初始化管理員賬號(hào)說明安裝成功。4. 基礎(chǔ)配置與核心功能設(shè)置首次登錄后你需要進(jìn)行一系列配置將 NASTool 與你的下載工具、媒體服務(wù)器等連接起來。4.1 系統(tǒng)初始化與基礎(chǔ)設(shè)置首次登錄訪問NAS_IP:3000根據(jù)提示設(shè)置管理員用戶名和密碼。修改默認(rèn)密碼登錄后務(wù)必在“系統(tǒng)設(shè)置” - “安全”中修改默認(rèn)密碼。設(shè)置媒體庫目錄進(jìn)入“系統(tǒng)設(shè)置” - “媒體庫”。添加你的媒體根目錄例如/media這是在容器內(nèi)看到的路徑對(duì)應(yīng)你之前映射的宿主機(jī)路徑。并設(shè)置電影、電視劇的分類目錄如/media/movies,/media/tv。4.2 配置下載器這是自動(dòng)化流程的“執(zhí)行臂”。進(jìn)入“系統(tǒng)設(shè)置” - “下載器”。點(diǎn)擊“添加下載器”選擇你使用的類型如 qBittorrent。關(guān)鍵配置項(xiàng)名稱自定義如my_qb。主機(jī)由于我們使用了--network host模式下載器如果也運(yùn)行在宿主機(jī)上這里填127.0.0.1或localhost。如果下載器是另一個(gè)容器且在同一自定義橋接網(wǎng)絡(luò)中則填容器名。端口下載器Web UI的端口如 qBittorrent 默認(rèn)是8080。用戶名/密碼下載器的登錄憑據(jù)。下載目錄填寫下載器容器內(nèi)的默認(rèn)下載保存路徑。例如qBittorrent 容器內(nèi)路徑可能是/downloads。這個(gè)目錄必須能被 NASTool 容器訪問到。通常的實(shí)踐是讓下載器和 NASTool 都將同一個(gè)宿主機(jī)目錄如/volume1/downloads映射為各自容器內(nèi)的路徑如都映射為/downloads這樣 NASTool 才能處理下載完成的文件。點(diǎn)擊“測(cè)試連接”顯示成功即可保存。4.3 配置媒體服務(wù)器這是自動(dòng)化流程的“成果展示端”。進(jìn)入“系統(tǒng)設(shè)置” - “媒體服務(wù)器”。點(diǎn)擊“添加媒體服務(wù)器”選擇類型如 Jellyfin。關(guān)鍵配置項(xiàng)主機(jī)同上如果媒體服務(wù)器運(yùn)行在宿主機(jī)填127.0.0.1。端口媒體服務(wù)器端口如 Jellyfin 是8096。API密鑰在 Jellyfin/Emby/Plex 的管理后臺(tái)生成并填入。測(cè)試連接并保存。4.4 配置消息通知可選但推薦設(shè)置通知可以在任務(wù)完成或出錯(cuò)時(shí)及時(shí)收到提醒。進(jìn)入“系統(tǒng)設(shè)置” - “消息通知”。支持 Telegram、微信、Bark、Server醬等。以 Telegram 為例需要先向BotFather申請(qǐng)一個(gè) Bot獲取Token。然后與你的 Bot 對(duì)話獲取你的Chat ID。在 NASTool 中填入Token和Chat ID并開啟需要的通知類型下載完成、整理完成等。4.5 配置索引器與訂閱這是自動(dòng)化流程的“信息來源”。TMDB在“系統(tǒng)設(shè)置” - “媒體” - “TMDB”中填入你申請(qǐng)的 API Key。這是識(shí)別影視信息的主要來源。豆瓣在“系統(tǒng)設(shè)置” - “媒體” - “豆瓣”中可以填入 Cookie用于同步“想看”列表非必須。站點(diǎn)資源在“站點(diǎn)管理”中可以添加你擁有的 PT 站點(diǎn)的 Cookie 或 API用于 RSS 自動(dòng)刷流、搜索等功能。此部分涉及具體站點(diǎn)請(qǐng)謹(jǐn)慎操作并遵守站點(diǎn)規(guī)則。5. 實(shí)戰(zhàn)實(shí)現(xiàn)一部電影的全自動(dòng)下載與整理讓我們通過一個(gè)完整的例子串聯(lián)起所有配置。目標(biāo)自動(dòng)下載豆瓣評(píng)分8.5以上的《星際穿越》1080p REMUX版本。5.1 步驟一添加訂閱在 NASTool 首頁點(diǎn)擊“電影” - “添加訂閱”。在搜索框輸入“星際穿越”選擇正確的影片。在訂閱設(shè)置中類型電影質(zhì)量選擇1080pREMUX過濾規(guī)則可以設(shè)置“標(biāo)題包含Interstellar”、“排除標(biāo)題包含x265”如果你不想要H.265編碼等。搜索站點(diǎn)選擇你已配置的 PT 站點(diǎn)。保存路徑選擇/media/movies你之前設(shè)置的媒體庫電影目錄。下載器選擇my_qb你配置的下載器。點(diǎn)擊“確定”保存訂閱。NASTool 會(huì)立即執(zhí)行一次搜索并在后臺(tái)持續(xù)監(jiān)控 RSS。5.2 步驟二自動(dòng)下載與識(shí)別NASTool 搜索到符合條件的資源后會(huì)自動(dòng)發(fā)送下載鏈接到 qBittorrent。你可以在“下載”頁面看到任務(wù)狀態(tài)。下載完成后NASTool 會(huì)監(jiān)控到 qBittorrent 中任務(wù)完成自動(dòng)觸發(fā)“目錄監(jiān)控”功能。5.3 步驟三文件整理與重命名NASTool 的“目錄監(jiān)控”功能會(huì)掃描下載完成目錄/downloads。找到《星際穿越》的文件后它會(huì)調(diào)用 TMDB API 進(jìn)行識(shí)別。識(shí)別成功后根據(jù)你設(shè)定的“媒體庫”和“重命名規(guī)則”在“系統(tǒng)設(shè)置”-“媒體庫”中配置將文件從/downloads硬鏈接或移動(dòng)到媒體庫目錄/media/movies/Interstellar (2014)/下并重命名為如Interstellar (2014).mkv。硬鏈接推薦方式。文件數(shù)據(jù)只有一份但在兩個(gè)目錄下都有入口不占用額外空間適合做種。整理完成后NASTool 可以可選通知媒體服務(wù)器Jellyfin刷新庫。5.4 步驟四成果驗(yàn)收打開 Jellyfin進(jìn)入電影庫你會(huì)發(fā)現(xiàn)《星際穿越》已經(jīng)赫然在列并且海報(bào)、簡(jiǎn)介、演員等信息一應(yīng)俱全。在 NASTool 的“歷史記錄”中可以看到完整的“搜索-下載-識(shí)別-整理”流水線日志。至此一個(gè)完全自動(dòng)化的流程跑通。你可以通過“訂閱”功能批量管理想看的影視劇徹底解放雙手。6. 常見問題與故障排查在部署和使用過程中你可能會(huì)遇到一些問題。以下是高頻問題的排查思路。問題現(xiàn)象可能原因排查與解決思路無法訪問 Web 界面 (NAS_IP:3000)1. 容器未成功啟動(dòng)。2. 端口映射錯(cuò)誤或被占用。3. NAS防火墻阻止。1. 在 Docker 管理界面查看容器狀態(tài)是否為“運(yùn)行中”查看容器日志有無報(bào)錯(cuò)。2. 檢查-p 3000:3000映射是否正確。嘗試更換宿主機(jī)端口如-p 3001:3000然后訪問NAS_IP:3001。3. 檢查 NAS 的防火墻設(shè)置放行對(duì)應(yīng)端口。下載器/媒體服務(wù)器連接測(cè)試失敗1. 網(wǎng)絡(luò)模式問題。2. 地址/端口錯(cuò)誤。3. 用戶名/密碼/API密鑰錯(cuò)誤。4. 目標(biāo)服務(wù)未運(yùn)行。1.確保使用host網(wǎng)絡(luò)模式這是最簡(jiǎn)單的方式。如果不用 host需確保容器在同一自定義網(wǎng)絡(luò)并能互通。2. 在宿主機(jī)上用curl http://127.0.0.1:8080測(cè)試下載器是否可達(dá)。3. 仔細(xì)核對(duì)憑據(jù)。4. 確認(rèn) qBittorrent、Jellyfin 等服務(wù)本身是否正常運(yùn)行。文件下載完成但未自動(dòng)整理1. 目錄監(jiān)控未開啟或路徑錯(cuò)誤。2. 下載目錄映射不一致。3. 文件識(shí)別失敗。4. 權(quán)限不足。1. 檢查“系統(tǒng)設(shè)置”-“下載器”中是否開啟了“目錄監(jiān)控”并監(jiān)控了正確的容器內(nèi)下載路徑如/downloads。2.最關(guān)鍵確認(rèn) NASTool 容器內(nèi)看到的下載路徑如/downloads和 qBittorrent 容器內(nèi)設(shè)置的下載保存路徑是同一個(gè)宿主機(jī)目錄。3. 查看“歷史記錄”或“系統(tǒng)”-“日志”看識(shí)別階段是否有 TMDB 連接錯(cuò)誤或未匹配到信息。4. 檢查 PUID/PGID 設(shè)置確保 NASTool 有權(quán)限讀取下載目錄和寫入媒體庫目錄。在宿主機(jī)上使用ls -l查看目錄所有者。媒體服務(wù)器搜刮不到整理好的電影1. 媒體服務(wù)器未正確配置媒體庫路徑。2. NASTool 未觸發(fā)媒體服務(wù)器刷新。1. 在 Jellyfin/Emby 中添加媒體庫時(shí)選擇的路徑必須是宿主機(jī)上的媒體庫路徑如/volume1/media/movies這個(gè)路徑需要能被媒體服務(wù)器訪問。2. 在 NASTool 的媒體服務(wù)器設(shè)置中開啟“庫刷新”相關(guān)選項(xiàng)。也可以手動(dòng)在媒體服務(wù)器后臺(tái)觸發(fā)掃描。NASTool 日志提示“Permission denied”容器內(nèi)進(jìn)程用戶PUID/PGID無權(quán)訪問映射的宿主機(jī)目錄。1. 在宿主機(jī)上將你的媒體目錄和下載目錄的所有者改為與容器內(nèi) PUID/PGID 一致的用戶。例如chown -R 1000:1000 /volume1/media如果 PUID1000。2. 或者將目錄權(quán)限改為 777不推薦用于生產(chǎn)環(huán)境chmod -R 777 /volume1/media。3.對(duì)于群暉在控制面板-共享文件夾-編輯對(duì)應(yīng)文件夾-權(quán)限中給Everyone或docker用戶如果有讀寫權(quán)限。更新容器后配置丟失啟動(dòng)新容器時(shí)沒有映射 (-v) 持久化的/config目錄。絕對(duì)不要直接刪除舊容器而不保留/config目錄。更新時(shí)應(yīng)使用同樣的-v映射參數(shù)啟動(dòng)新容器指向同一個(gè)宿主機(jī)配置目錄。你的所有設(shè)置都保存在這個(gè)目錄里。7. 最佳實(shí)踐與進(jìn)階建議配置穩(wěn)定運(yùn)行后以下建議可以幫助你打造更高效、更安全的個(gè)人媒體自動(dòng)化系統(tǒng)。7.1 目錄結(jié)構(gòu)與權(quán)限規(guī)劃一個(gè)清晰、一致的目錄結(jié)構(gòu)是自動(dòng)化的基石。/volume1/ # 存儲(chǔ)池根目錄 ├── docker/ # 所有Docker應(yīng)用數(shù)據(jù) │ └── nastool/ │ ├── config/ # NASTool配置必須映射 │ └── data/ # NASTool其他數(shù)據(jù) ├── downloads/ # 下載目錄 │ ├── qbittorrent/ # qBittorrent的下載文件夾 │ └── completed/ # 下載完成區(qū)可選用于NASTool監(jiān)控 └── media/ # 最終媒體庫 ├── movies/ # 電影 ├── tv/ # 電視劇 ├── music/ # 音樂 └── documentaries/ # 紀(jì)錄片權(quán)限建議創(chuàng)建一個(gè)專用的系統(tǒng)用戶如mediaUID1000讓 Docker 容器NASTool、qBittorrent、Jellyfin都使用這個(gè)用戶的 UID/GID 運(yùn)行并讓該用戶擁有上述目錄的所有權(quán)。這樣可以最大限度地避免權(quán)限問題。7.2 使用 Docker Compose 進(jìn)行編排對(duì)于需要運(yùn)行多個(gè)關(guān)聯(lián)容器NASTool, qBittorrent, Jellyfin的環(huán)境使用docker-compose.yml進(jìn)行編排是更優(yōu)雅、可復(fù)現(xiàn)的方式。創(chuàng)建一個(gè)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 # 統(tǒng)一映射下載目錄 environment: - PUID1000 - PGID1000 - UMASK022 - TZAsia/Shanghai network_mode: host # 使用host網(wǎng)絡(luò) 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然后在包含此文件的目錄下運(yùn)行docker-compose up -d即可一鍵啟動(dòng)所有服務(wù)。管理、更新、備份都更加方便。7.3 安全強(qiáng)化措施修改默認(rèn)端口將 NASTool 的 Web 端口從3000改為一個(gè)不常用的高位端口如8321減少被掃描的風(fēng)險(xiǎn)。設(shè)置強(qiáng)密碼NASTool、下載器、媒體服務(wù)器的后臺(tái)密碼務(wù)必設(shè)置為強(qiáng)密碼。啟用 HTTPS如果通過公網(wǎng)訪問務(wù)必在 NAS 層面或通過反向代理如 Nginx Proxy Manager配置 HTTPS加密通信。定期備份配置定期備份 NASTool 映射的/config目錄。這是你的所有規(guī)則和數(shù)據(jù)庫丟失后需要重新配置。權(quán)限最小化不要使用root(UID0) 運(yùn)行容器。創(chuàng)建專用用戶并只賦予必要的目錄權(quán)限。7.4 性能與穩(wěn)定性優(yōu)化TMDB API 限制TMDB 的免費(fèi) API 有調(diào)用頻率限制。在 NASTool 的 TMDB 設(shè)置中可以適當(dāng)調(diào)大請(qǐng)求間隔避免被限。合理設(shè)置 RSS 間隔在站點(diǎn) RSS 設(shè)置中不要將刷新間隔設(shè)得太短如小于10分鐘以免對(duì)站點(diǎn)服務(wù)器造成壓力或被封禁。使用硬鏈接而非移動(dòng)在“系統(tǒng)設(shè)置”-“下載器”-“下載設(shè)置”中優(yōu)先選擇“硬鏈接”。這樣整理文件時(shí)不會(huì)中斷做種且不占用雙倍空間。日志管理定期清理 NASTool 的日志文件防止/config目錄無限增大?？梢栽?Docker 啟動(dòng)命令中添加日志大小限制或使用日志輪轉(zhuǎn)工具。通過以上步驟你不僅能在群暉、飛牛、極空間、綠聯(lián)、威聯(lián)通等任意支持 Docker 的 NAS 上成功部署 NASTool V2更能建立起一套穩(wěn)健、高效、安全的家庭媒體自動(dòng)化管理體系。從手動(dòng)搜索下載到全自動(dòng)追劇體驗(yàn)的提升是巨大的。