Radarr 电影封面管理海报如何自动下载、缩放与展示【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/RadarrRadarr 是一款面向 Usenet 和 BitTorrent 用户的电影整理与管理工具除了解码、命名、入库之外它还负责为每部影片自动获取海报、横幅、背景图等封面素材并生成多个尺寸供 Web 界面和媒体中心调用。本文围绕封面从哪来、存在哪里、界面怎么显示、出问题时怎么查这条主线展开适合刚接触 Radarr、想搞清楚封面机制的使用者。为什么电影库离不开封面管理一个只有文件名和年份的电影列表使用起来是很枯燥的。封面解决了三个实际问题识别在浏览影片时人眼对图像的反应速度远高于文字一张海报比一行标题更容易被认出来。筛选Web 界面的列表和日历视图依赖缩略图快速定位目标影片。对外输出Kodi、Plex 等媒体中心读取本地封面文件来渲染自己的界面封面质量直接决定媒体库的观感。Radarr 把这些工作自动化了使用者不需要手工维护图片文件夹。添加电影后封面文件会出现在哪里完成 Radarr 安装并首次访问http://your-ip:7878后添加第一部电影时就可以观察封面的落盘位置。所有封面存放在应用数据目录下的MediaCover文件夹中结构如下MediaCover/ ├── 1/ │ ├── poster.jpg # 原始海报 │ ├── poster-500.jpg # 高 500px 版本 │ ├── poster-250.jpg # 高 250px 版本 │ ├── fanart.jpg │ └── banner-70.jpg └── 2/ └── ...这里的数字是影片在 Radarr 内部数据库中的 ID而不是 TMDB ID。每部影片一个独立子目录目录内按类型 高度命名文件。这个结构由src/NzbDrone.Core/MediaCover/MediaCoverService.cs中的路径逻辑决定理解它之后手动干预封面时就不会放错位置。封面从下载到缩放的完整流程添加影片后Radarr 会触发一次封面检查整体流程分为三段拉取原始图。系统根据影片元数据默认来自 TMDb拿到每种封面类型的远程地址通过 HTTP 客户端下载到本地目录。生成多个尺寸。以海报为例会额外产出高 500px 和 250px 两个版本横幅是 70px 和 35px背景图/截图是 360px 和 180px。缩略图用于列表页大图用于详情页。记录状态。只有当远程地址对应的本地文件确实不存在时才会重新下载避免每次刷新都重复拉取缩放失败时会回退到原图并在日志里留下调试记录。几种封面的具体规格可以参考src/NzbDrone.Core/MediaCover/MediaCoverService.cs中的尺寸定义。另外透明背景的 Clearlogo 使用 PNG 格式其余封面统一为 JPG。删除影片时对应的MediaCover/{ID}目录会被整体清理因此不需要担心磁盘被历史封面占满。海报在 Web 界面中如何展示与验证确认封面是否真正生效最直接的方法是回到影片详情页详情页应显示大图海报和背景图如果只看到占位图说明该类型的封面尚未下载成功。列表/日历视图显示的是 250px 缩略图用于快速扫视。封面通过/MediaCover/{movieId}/poster.jpg这类 URL 提供给浏览器并附带一个哈希参数用于浏览器缓存失效控制——所以如果你手动替换了图片但页面没变化多半是浏览器缓存强制刷新即可。前端组件frontend/src/Movie/MoviePoster.tsx里定义了海报组件默认使用 250 尺寸、可切换到 500 尺寸这解释了为什么界面里同一张海报会出现两种清晰度。封面下载失败或图片缺失怎么排查Radarr 把封面下载失败当作可恢复的错误处理单张图失败不会中断整个添加流程只会记一条警告日志并继续处理其他封面。排查时按以下顺序检查现象可能原因处理方式详情页显示灰色占位图元数据源未配置或网络无法访问 TMDb在设置中确认元数据来源检查出站网络大图正常但缩略图缺失图片缩放失败常见于部分 ARM 环境查看日志中 resize 相关记录原图仍可显示手动替换图片后无变化文件名不符合类型-高度规则或浏览器缓存按poster-500.jpg这类命名放置强刷页面批量刷新无效影片 ID 传错从影片详情页 URL 中确认 ID再调用刷新命令批量触发刷新可以通过命令 API 完成curl -X POST http://your-ip:7878/api/v3/command \ -H X-Api-Key: your-api-key \ -d {name: RefreshMovie, movieIds: [1, 2, 3]}API Key 在 Radarr 的设置 → 通用中查看。如果只是想重新拉取某一部影片的元数据含封面用影片菜单里的刷新元数据按钮更稳妥。从封面机制出发的下一步检查一次MediaCover目录结构确认影片 ID 与目录对应关系为后续手动维护打下基础。把 Kodi 或 Plex 指向 Radarr 的电影根目录验证封面是否被媒体中心正确读取。如果长期部署把MediaCover目录纳入定期备份重装时可直接恢复避免重复下载。源码层面可以进一步阅读src/NzbDrone.Core/MediaCover/下的ImageResizer.cs和MediaCoverProxy.cs了解缩放实现和未入库影片时封面 URL 的代理机制。【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考