Sonarr 與 Radarr,自架媒體庫的自動化下載流程
這四個元件透過 API 與網路位址互相溝通。Sonarr 不會自己下載檔案,它只是「下指令」給下載客戶端;它也不會自己播放,而是把整理好的檔案放在媒體伺服器看得懂的位置。理解這個分工,後續的設定就會變得非常直覺。
2.2 一次完整的自動化流程
假設你新增了一部影集,並把狀態設為「監控中」。Sonarr 會做以下幾件事:首先,它根據影集資訊建立資料夾結構,例如 /media/TV/Show Name/Season 01/。接著,它會按照你設定的「搜尋間隔」定期向索引器查詢,通常新集數播出後不久就會出現資源。找到符合品質設定檔的資源後,Sonarr 會產生一個下載任務,透過 API 送到 qBittorrent。
下載完成後,下載客戶端會通知 Sonarr「任務完成」,Sonarr 便會檢查檔案內容,比對集數與品質,決定是否匯入(Import)。匯入時,它會依照命名規則重新命名檔案,例如 Show.Name.S01E05.1080p.WEB-DL.mkv,並搬移到媒體庫資料夾。最後,它會觸發媒體伺服器的掃描,或透過通知系統告訴你「新集數已入庫」。整個流程從搜尋到入庫,完全不需要你動手。
2.3 品質設定檔與延遲設定檔的角色
品質設定檔(Quality Profile)是整個決策流程的靈魂。你可以在裡面排列品質的優先順序,例如「2160p > 1080p WEB-DL > 1080p BluRay > 720p」,並設定「可接受的最低品質」與「升級直到」。系統在搜尋時,會優先選擇排序較高、且尚未達成的品質。延遲設定檔(Delay Profile)則用來避免「太早抓到爛版本」,例如你可以設定「新集數出現後延遲 24 小時再抓」,讓更好的版本有時間出現。
這兩者搭配得好,可以大幅減少重複下載與硬碟浪費。舉例來說,如果你很在意畫質,可以設定「只接受 BluRay,且延遲 48 小時」,這樣系統就不會急著抓 WEB-DL,而是耐心等待藍光版本釋出。反之,如果你只想快速看到內容,就把延遲設為零,讓系統看到資源就抓。
三、安裝與部署:用 Docker 打造穩定的執行環境
3.1 為什麼推薦 Docker 部署
Sonarr 與 Radarr 都支援 Windows、macOS、Linux 原生安裝,但對自架玩家來說,Docker 幾乎是唯一推薦的方式。原因有三:第一,環境隔離乾淨,不會因為系統更新而把依賴套件弄壞;第二,版本升級與回滾非常容易,只要換一個 image tag 即可;第三,與其他媒體工具(Plex、qBittorrent、Prowlarr、Bazarr)整合時,透過 Docker 網路溝通比走主機網路更安全、更有彈性。
如果你使用的是 Synology、QNAP 等 NAS,多數機型都支援 Docker 或 Container Manager,可以直接在圖形介面操作。如果你用的是迷你主機或自組伺服器,則建議先安裝 Docker Engine 與 Docker Compose,後續維護會輕鬆很多。
3.2 Docker Compose 範例與目錄規劃
以下是一個精簡的 Docker Compose 範例,同時啟動 Sonarr 與 Radarr。請注意「路徑對應」是整個設定中最容易出錯的地方:主機的媒體資料夾與下載資料夾,必須以「相同路徑」掛載到兩個容器中,否則 Sonarr 在匯入時會發生「硬連結失敗」或「跨檔案系統搬移」的問題。
version: "3.8"
services:
sonarr:
image: lscr.io/linuxserver/sonarr:latest
container_name: sonarr
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Taipei
volumes:
- /opt/sonarr/config:/config
- /mnt/media:/media
- /mnt/downloads:/downloads
ports:
- 8989:8989
restart: unless-stopped
radarr:
image: lscr.io/linuxserver/radarr:latest
container_name: radarr
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Taipei
volumes:
- /opt/radarr/config:/config
- /mnt/media:/media
- /mnt/downloads:/downloads
ports:
- 7878:7878
restart: unless-stopped
啟動後,Sonarr 預設監聽 8989 埠,Radarr 則是 7878。你可以透過瀏覽器打開 http://你的伺服器IP:8989 與 http://你的伺服器IP:7878 進行初始設定。第一次進入時,系統會引導你設定語言、驗證方式與資料庫,建議啟用帳號密碼或反向代理驗證,避免公開網路暴露。
3.3 硬連結與原子搬移的重要性
在媒體自動化領域,「硬連結」(Hardlink)是關鍵字。當 Sonarr 從下載資料夾匯入檔案時,如果下載資料夾與媒體庫位於同一個檔案系統,它會建立硬連結,而不是真的複製檔案。這樣做的好處是:不佔用額外空間、匯入速度極快,而且做種中的檔案與媒體庫檔案可以同時存在。若兩者位於不同檔案系統,系統就只能複製,速度慢又浪費空間。
因此,實務上建議把「下載資料夾」與「媒體庫資料夾」放在同一顆硬碟或同一個儲存池,並在 Docker 中以相同路徑掛載。例如主機的 /mnt/downloads 對應容器的 /downloads,主機的 /mnt/media 對應容器的 /media,且兩者位於同一檔案系統。這樣才能享受硬連結帶來的好處。
四、Sonarr 設定實戰:影集自動化下載
4.1 新增索引器與下載客戶端
進入 Sonarr 後,第一步是設定索引器。點選「Settings → Indexers → Add」,你可以選擇內建的索引器類型,或使用「Newznab」「Torznab」串接 Jackett、Prowlarr 等仲介工具。若你使用私有 PT 站,通常需要填入 API Key 與站點網址;若使用公開站,則可選擇對應範本。建議一次只加一個索引器並測試連線,確認成功後再加下一個,方便除錯。
接著設定下載客戶端。點選「Settings → Download Clients → Add」,選擇 qBittorrent 或 Transmission,填入主機位址、埠號、帳號密碼。若 Sonarr 與下載客戶端都在 Docker 中,主機位址應填寫「容器名稱」或 Docker 網路內的 IP,而不是 localhost,否則會連不上。設定完成後,建議用「Test」按鈕確認連線正常。
4.2 建立品質設定檔與資料夾結構
品質設定檔建議至少建立三個:「高畫質優先」「一般畫質」「動畫專用」。以「高畫質優先」為例,可以把 2160p 排在最高,接著是 1080p BluRay、1080p WEB-DL、1080p HDTV,最後是 720p。並勾選「Upgrade Until」為 2160p,讓系統在有更好版本時自動替換。若你的硬體無法播放 4K,就不要把 2160p 放進清單,以免下載後無法使用。
資料夾結構方面,Sonarr 預設會在媒體庫根目錄下建立「影集名稱 / Season XX / 檔案」的結構。請確認根目錄權限正確,且與媒體伺服器讀取的路徑一致。若你使用 Plex,Plex 的電視節目資料夾結構與 Sonarr 預設相同,通常不需額外調整;若使用 Jellyfin,也支援相同結構。
4.3 新增影集與監控策略
設定完成後,就可以開始新增影集。點選「Add Series」,輸入名稱後系統會從 TVDB 拉取資訊,選擇正確的影集後,決定「Monitor」策略:可以只監控未來集數(Future Episodes)、監控所有集數(All Episodes)、或只監控特定季。對於長壽劇如《辛普森家庭》,建議只監控未來集數,避免一次抓取數百集佔爆硬碟。
新增後,Sonarr 會自動開始搜尋已播出的集數。你可以在「Activity → Queue」看到下載進度,在「Series → 影集名稱」看到每一集的狀態(已下載、缺失、未播出)。若某集一直抓不到,系統會依照你設定的「搜尋間隔」持續重試,通常是每 6 到 12 小時一次,可在「Settings → Indexers」中調整。
4.4 通知與自動化串接
Sonarr 支援多種通知方式,包括 Discord、Telegram、Slack、電子郵件、Webhook 等。建議至少設定一種即時通知,這樣新集數入庫時你會立刻知道。設定路徑為「Settings → Connect → Add」,選擇對應的服務,填入 Webhook URL 或 Bot Token,並勾選「On Import」「On Upgrade」「On Health Issue」等事件。這樣一來,不只下載完成會通知,連索引器失效、硬碟空間不足等健康問題也會提醒你。
五、Radarr 設定實戰:電影自動化下載
5.1 電影監控與版本判斷
Radarr 的設定邏輯與 Sonarr 高度相似,最大的差異在於「電影版本」的判斷。新增電影時,Radarr 會從 TMDB 取得電影資訊,包括院線上映日、數位發行日、實體發行日。你可以設定「Minimum Availability」,例如「Released」代表只在數位或實體發行後才搜尋,「Announced」則較寬鬆。這項設定可以避免系統在你還沒進電影院前,就抓到畫質很差的槍版。
對於收藏型玩家,建議把「Minimum Availability」設為「Released」,並搭配延遲設定檔,讓 BluRay 版本有時間釋出。若你只是想快速看到內容,可以設為「In Cinemas」,但要注意畫質與來源合法性。無論哪種設定,都應定期檢查清單,避免系統抓到你其實不需要的版本。
5.2 電影品質與多版本管理
電影的品質設定比影集複雜一些,因為同一部電影可能有「Theatrical Cut」「Director's Cut」「Extended Edition」等不同版本。Radarr 支援「Edition」標記,但多數索引器不一定會正確標示,因此實務上建議「一個版本一部電影」,避免自動化流程混淆。若你真的需要多版本,可以手動建立不同的電影項目,或使用「Custom Formats」進階規則來精準匹配。
Custom Formats 是 Radarr 的強大功能,可以根據檔案名稱中的關鍵字(例如「HDR」「DV」「Atmos」「REMUX」)給予分數,並在品質設定檔中設定「最低分數門檻」。這樣你就能精準控制「只要 HDR10+ 且帶 Atmos 的版本」,而不必手動逐一檢查。Sonarr 也有類似功能,兩者都值得花時間研究。
5.3 與 Sonarr 共用資源的策略
由於 Sonarr 與 Radarr 都需要索引器與下載客戶端,實務上會把它們指向同一組資源。這樣做的好處是管理集中,但要注意「下載佇列」的優先順序。若同時有影集與電影在抓,建議在下載客戶端設定「分類」(Category),例如 Sonarr 使用 tv、Radarr 使用 movies,並在客戶端中設定不同的速度限制或排程,避免某一邊佔滿頻寬。
此外,若你使用 Prowlarr 作為索引器仲介,只需要在 Prowlarr 中設定一次索引器,就能同步到 Sonarr 與 Radarr,大幅減少重複設定的工作量。Prowlarr 也支援索引器健康檢查與統計,方便你找出失效的站點。
六、進階整合:Prowlarr、Bazarr、Overseerr 與自動化生態系
6.1 Prowlarr:索引器的中央管理
Prowlarr 是專為 Sonarr、Radarr、Lidarr、Readarr 設計的索引器管理器。它讓你只需要在一個地方新增索引器,就能自動同步到所有「Arr」應用程式。它還支援索引器統計、失敗率追蹤、標籤分類,對於同時使用多個站點的玩家非常實用。安裝方式同樣是 Docker,設定時把 Sonarr 與 Radarr 的 API Key 填入 Prowlarr 的「Apps」頁面,即可完成雙向同步。
使用 Prowlarr 的另一個好處是「統一搜尋」。當你在 Prowlarr 中搜尋時,它會同時查詢所有索引器並彙整結果,方便你判斷哪個站點資源較齊全。對於經常需要手動補檔的玩家來說,這是一個非常省時的工具。
6.2 Bazarr:字幕自動化
Bazarr 是 Sonarr 與 Radarr 的字幕搭檔,能夠自動為你的影集與電影下載字幕。它支援多個字幕站,包括 OpenSubtitles、Podnapisi、Subscene 等,並可設定語言優先順序(例如繁體中文優先、英文次之)。Bazarr 會監控 Sonarr 與 Radarr 的媒體庫,當新檔案入庫時自動搜尋字幕,也能針對「字幕缺失」的檔案批次補齊。
設定時,請在 Bazarr 中填入 Sonarr 與 Radarr 的網址與 API Key,並選擇「Languages」中的語言設定檔。若你偏好特定字幕組,也可以設定「Series Subtitles」或「Movies Subtitles」的個別規則。對於繁體中文使用者來說,Bazarr 能大幅減少手動找字幕的時間,是自架媒體庫的必備工具。
6.3 Overseerr:使用者請求與權限管理
如果你與家人朋友共用媒體庫,Overseerr 是一個漂亮的「請求入口」。使用者可以透過網頁搜尋電影或影集,按下「Request」後,請求會自動送到 Sonarr 或 Radarr 建立監控項目。管理員可以設定「自動核准」或「手動核准」,並針對不同使用者設定權限與配額。Overseerr 也支援 Plex 登入,使用者不需要另外記帳號密碼。
這樣的整合讓整個媒體生態系更完整:使用者請求 → Overseerr 轉送 → Sonarr/Radarr 搜尋 → 下載客戶端下載 → 自動入庫 → Plex/Jellyfin 通知。你幾乎不需要介入,只需要偶爾檢查系統健康狀態與硬碟空間。
6.4 通知與監控:讓系統自己說話
除了 Discord、Telegram 通知,建議搭配 Uptime Kuma 或 Grafana 監控服務狀態。Uptime Kuma 可以監控 Sonarr、Radarr、Prowlarr、qBittorrent 的 HTTP 狀態碼,當服務掛掉時發送通知。若你使用 Prometheus 與 Grafana,則可以進一步監控下載速度、佇列長度、硬碟使用率等指標,打造專業級的媒體伺服器儀表板。
此外,Sonarr 與 Radarr 內建的「Health」頁面會顯示磁碟空間、索引器失敗、下載客戶端連線等問題,建議每週巡一次。許多自動化腳本也會透過 API 定期抓取健康狀態,寫入日誌或發送到 Discord,讓你能在第一時間處理。
七、常見問題與除錯指南
7.1 為什麼下載完成卻沒有匯入?
最常見的原因是「路徑對應錯誤」。Sonarr 看到的「下載完成路徑」與下載客戶端回報的路徑不一致時,就會找不到檔案。請在「Settings → Download Clients」中確認「Remote Path Mapping」設定,或在 Docker 中確保兩者掛載相同路徑。另一個常見原因是「權限不足」,Sonarr 容器使用的 PUID/PGID 必須對下載資料夾有讀寫權限,否則無法搬移檔案。
若路徑與權限都正確,仍有可能是「檔案名稱無法辨識集數」。Sonarr 依賴檔名或資料夾名稱來判斷集數,若發布組命名太過怪異,系統可能無法匹配。此時可以手動使用「Manual Import」功能,指定正確的集數與品質,或使用「Rename」工具修正檔名後重新掃描。
7.2 索引器一直失敗怎麼辦?
索引器失敗的原因很多:站點暫時關閉、API Key 過期、Cloudflare 防護阻擋、速率限制等。首先確認「Settings → Indexers」中的測試結果,若顯示 403 或 429,通常是驗證或速率問題。若是 Cloudflare 阻擋,可以嘗試使用 FlareSolverr 這類工具繞過,或改用 Prowlarr 的內建代理功能。若站點已關閉,則需尋找替代索引器。
另外,別忘了檢查「Indexers」的「Enable RSS」與「Enable Automatic Search」是否開啟。有些索引器只支援 RSS,不支援手動搜尋;有些則需要特定參數才能正確回傳結果。逐一測試並查看日誌(「System → Logs」),通常能找到具體錯誤訊息。
7.3 硬碟空間不足與清理策略
自動化下載最大的副作用就是「硬碟永遠不夠」。建議設定「品質升級」時保留舊版本一段時間,或使用「Recycle Bin」功能,讓被替換的檔案先進入暫存區,確認新版本正常後再刪除。Sonarr 與 Radarr 都支援「Recycle Bin」路徑設定,可以指定一個資料夾存放被刪除的檔案,避免誤刪。
此外,可以搭配「Maintainerr」或「Janitorr」這類工具,根據觀看紀錄自動刪除已看完的內容。若你使用 Plex,這些工具可以透過 Tautulli 取得觀看資料,制定「保留 30 天後刪除」或「只保留 4K 版本」等規則。定期清理不僅節省空間,也能讓媒體庫保持整潔。
八、法律、安全與倫理注意事項
Sonarr 與 Radarr 本身是合法的開源軟體,但它們的功能是「自動化管理下載流程」。實際使用時,你必須確保所下載的內容符合當地法律與版權規範。在台灣,著作權法對重製與公開傳輸有明確規範,建議僅將這類工具用於「已合法取得」或「公有領域」的內容,例如你自行錄製的節目、創用 CC 授權的影片,或已購買的數位檔案。
安全方面,請務必為 Sonarr、Radarr、Prowlarr 等服務設定驗證,並避免直接暴露在公開網際網路。若需要遠端存取,建議使用 VPN、Tailscale、Cloudflare Tunnel 等安全通道,並搭配反向代理與 HTTPS。定期更新 Docker image 與套件,修補已知漏洞,也是基本的安全習慣。
倫理方面,自架媒體庫的初衷是「整理與播放自己擁有的內容」,而非「無限制地取得他人作品」。尊重創作者、支持正版,才能讓整個影視產業持續產出好內容。將自動化工具視為「管理已擁有媒體」的助手,而不是「繞過付費機制」的手段,是每個自架玩家應有的態度。
九、效能優化與長期維護建議
9.1 硬體與儲存規劃
Sonarr 與 Radarr 本身的資源需求很低,一般迷你主機、NAS 或樹莓派都能勝任。真正需要規劃的是「儲存」與「網路」。若你經常下載 4K 內容,建議準備至少 8TB 以上的硬碟,並考慮使用 RAID 或定期備份,避免硬碟故障導致媒體庫全毁。網路方面,若索引器與下載客戶端都在區網內,建議使用有線網路,避免 Wi-Fi 不穩導致下載中斷。
若你使用 SSD 作為快取,可以把 Docker 的 config 與資料庫放在 SSD,媒體庫放在 HDD,兼顧速度與容量。另外,定期備份 Sonarr 與 Radarr 的資料庫(Settings → General → Backup),可以在系統故障時快速還原,不用重新設定所有索引器與品質設定檔。
9.2 日誌與監控的最佳實踐
建議開啟「Debug」日誌一段時間,觀察系統在搜尋與匯入時的行為,確認沒有異常重試或錯誤。若日誌檔案過大,可以設定輪替(Rotation),避免佔滿硬碟。監控方面,除了 Uptime Kuma,也可以使用「Netdata」監控系統資源,或使用「Glances」快速查看 CPU、記憶體、網路使用率。這些工具都能以 Docker 部署,與媒體生態系共存。
長期維護的關鍵是「定期更新」與「定期檢查」。更新前建議先備份資料庫,並查看 release notes 是否有重大變更。檢查時可以巡一次「Health」頁面、下載佇列、索引器狀態、硬碟空間,以及通知是否正常。把這些檢查變成每月例行公事,就能讓系統穩定運行很長時間。
十、總結:打造屬於你的自動化媒體中心
Sonarr 與 Radarr 的價值,不只是「自動下載」這麼簡單,而是把繁瑣的媒體管理流程,轉化為一套可預測、可維護、可擴充的系統。從索引器、下載客戶端、品質設定檔到通知與監控,每一個環節都有明確的角色與設定邏輯。當你熟悉這套架構後,就能根據自己的需求調整,例如加入 Bazarr 自動字幕、Overseerr 開放請求、Prowlarr 集中管理索引器,甚至串接 Tautulli 與清理工具,讓整個媒體庫自動維持在最佳狀態。
對新手來說,建議先從「最小可用系統」開始:一套 Sonarr、一套 Radarr、一個下載客戶端、一個媒體伺服器,先讓流程跑通,再逐步加入進階工具。不要一開始就追求完美設定,因為每個人的網路環境、硬體條件、觀看習慣都不同,唯有實際運行、觀察日誌、調整參數,才能找到最適合自己的配置。
最後,別忘了尊重版權與法律規範,並為系統做好安全防護。自架媒體庫是一場馬拉松,不是短跑。當你某天打開電視,發現昨天剛播出的影集已經自動出現在媒體庫,字幕也已經匹配完成,那種「系統自己照顧自己」的成就感,就是這套工具最迷人的地方。希望這篇指南能幫助你順利踏上自動化媒體庫的旅程,享受科技帶來的便利與樂趣。
💬 想說點什麼?
歡迎到留言板分享你的想法、心得或疑問。
💬 前往留言板 →