
Radarr 海報墻實戰路徑從灰底占位圖到滿墻海報【免費下載鏈接】RadarrMovie organizer/manager for usenet and torrent users.項目地址: https://gitcode.com/GitHub_Trending/ra/Radarr凌晨三點整理完一批新片打開媒體庫發現海報全是灰底占位圖——這種時刻最考驗收藏者的耐心。Radarr 海報墻要解決的就是這件事把電影海報自動拉下來、縮放好、按片歸檔讓收藏一眼可見。本文沿著 MediaCover 模塊海報服務的源碼所在走一遍怎么讓海報自動歸位、怎么批量刷新、怎么接到媒體中心順帶講清楚它為什么這么設計。項目能力速覽Radarr 是面向 Usenet 和 BitTorrent 用戶的電影整理/管理工具下載、元數據、海報一條龍。自動海報下載— 電影添加或更新即觸發下載無需手動扒圖多尺寸縮略圖— 原圖之外自動生成 500px/250px 等多檔前端按需加載按片歸檔— 每部電影一個以 ID 命名的目錄結構固定、可整體備份事件驅動— 靠內部事件總線聯動沒有常駐腳本要維護和純手工管海報比手動整理Radarr新片海報自己下載命名添加影片自動到位縮略圖自己裁剪自動生成多檔環境準備與首次運行前置條件一句話.NET 8 運行時項目目標框架見 Radarr.csproj或直接使用官方發布的預編譯包服務默認監聽 7878 端口Bootstrap.csL149。git clone https://gitcode.com/GitHub_Trending/ra/Radarr # 拿到完整源碼 cd Radarr # 進入項目目錄 dotnet publish src/NzbDrone.Host -c Release # 編譯出可執行程序 dotnet run --project src/NzbDrone.Host # 啟動服務瀏覽器打開http://localhost:7878按首次引導配好媒體庫路徑即可。 核心功能實操讓 Radarr 海報墻亮起來海報自動歸位添加電影的那一秒海報就已經在落盤了全程零操作。觸發鏈路是電影保存后發出更新事件MediaCoverService作為事件訂閱者被喚醒逐張檢查并下載。入口在 MediaCoverService.csL227-L232public void HandleAsync(MovieUpdatedEvent message) { var updated EnsureCovers(message.Movie); // ... }下載前會先查一次AlreadyExists同文件 L124已存在就跳過所以刷新命令不怕重復執行。一個細節電影尚未入庫時圖片 URL 會改走/MediaCover本地代理L73-L100繞開源站的防盜鏈。注意下載失敗只記 Warn 日志L132-L143不會阻塞電影入庫海報稍后補即可。一部電影三檔尺寸同一張海報Radarr 會存原圖加兩張縮小版列表頁、詳情頁各取所需加載飛快。文件名規則在GetCoverPath同文件 L66-L71封面類型名 高度后綴比如poster-500.jpg。各類型的縮放檔位定義在EnsureResizedCoversL182-L194類型生成高度Poster / Headshot500、250Banner70、35Fanart / Screenshot360、180落盤后的目錄長這樣根目錄即應用數據下的MediaCover見 PathExtensions.csL334-L337MediaCover/ ├── 128/ │ ├── poster.jpg # 原圖 │ ├── poster-500.jpg # 中圖 │ ├── poster-250.jpg # 縮略圖 │ └── fanart-360.jpg └── 305/上面這只舉牌怪就是 Radarr 前端 404 時的樣子——海報缺位時你大概率會先見到它。另一個小提醒Clearlogo類型存.png其余默認.jpgL218-L225。批量刷新海報庫換了圖片源或者補庫之后不用在界面上逐部點刷新一條 API 命令全庫重掃。命令入口在 CommandController.csRefreshMovie命令類型定義見 TaskManager.csL89curl -X POST http://localhost:7878/api/v3/command \ -H X-Api-Key: 你的API密鑰 \ -d {name: RefreshMovie}刷新會重新觸發上面的下載與縮放流程已存在的文件自動跳過。API 密鑰在 Settings → General 里拿忘了填或填錯會直接 401。?? 深度定制與生態集成對接媒體中心Kodi / Plex / Emby適用誰想讓客廳大屏同步看到海報墻的人怎么做Settings → Notifications → 添加對應媒體服務器通知填地址和端口啟用更新通知開關注意Radarr 只負責喊一嗓子發通知事件掃描入庫動作仍在媒體服務器側完成把 MediaCover 目錄整體搬到 NAS適用誰本地盤小、海報想跟影片放一起的人怎么做停服 → 修改配置中應用數據路徑 → 把MediaCover目錄整體移動過去注意電影 ID 命名的子目錄名千萬不要改改一個丟一片前端樣式微調適用誰受夠了默認間距和懸停效果的人怎么做前端源碼在 frontend/src/海報網格樣式可參考修改.poster-cell { margin: 10px; transition: transform .3s; } .poster-cell:hover { transform: scale(1.05); }注意官方沒有預留用戶級樣式注入點這類改動需自行維護構建產物升級前先記錄 diff?? 踩坑速查現象大概率原因解法一句話海報是灰底/404 占位源圖地址失效或網絡不穩看日志中 Couldnt download 記錄只有原圖沒有小圖縮放失敗回退用了原圖查 L206-L213 回退邏輯與磁盤空間API 刷新返回 401X-Api-Key 缺失或寫錯去 Settings → General 重新拷貝頁面打不開7878 端口被占改配置文件中的服務端口需要更細的線索直接翻 MediaCoverService.csL107-L163的異常分支注釋寫得比多數文檔都誠實。你現在已經能讓海報隨電影自動落盤、看懂多檔縮略圖的命名與目錄結構、用一條命令刷新全庫、并把海報墻接到媒體中心。進階方向可以看看自定義封面代理、海報自動備份、前端主題改造。提示MediaCover目錄獨立于影片庫重裝前花兩分鐘打包備份ID 目錄名原樣保留即可無縫恢復。打開設置頁把媒體庫指到你的 NAS5 分鐘后第一面海報墻就會亮起來。【免費下載鏈接】RadarrMovie organizer/manager for usenet and torrent users.項目地址: https://gitcode.com/GitHub_Trending/ra/Radarr創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考