用Radarr海报展示你的电影收藏：打造电影海报墙的完整指南-育师

用Radarr海报展示你的电影收藏：打造电影海报墙的完整指南

【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr

打开电影文件夹，几百个.mkv文件躺在里面，想看看自己到底攒了哪些片子，只能逐个翻文件名——这种"收藏只有列表、没有门面"的处境，影音玩家应该都经历过。Radarr 正是为 Usenet 和 BitTorrent 用户做的电影收藏管理器，它除了归置文件，还会自动为每部影片拉取 Radarr 海报，让你的库从一堆文件变成一面能直接浏览的电影海报墙。

Radarr 海报从哪来，又存在哪

在动手之前，先花两分钟搞清楚海报的来龙去脉，后面排障会省很多事。

你往库里添加一部电影后，Radarr 会先向元数据源（比如 TMDb）查询这部片子的信息，其中就包含远程海报地址。下载动作由海报服务源码完成：它把远程原图抓回本地，再顺手裁剪出几个小尺寸，整个过程不需要你干预。

存放位置很有规律：应用数据目录下有一个MediaCover文件夹，里面按电影 ID 分目录，一个 ID 一个文件夹。以 ID 为 1 的电影为例，目录里通常躺着这么几个文件：poster.jpg是原图，poster-500.jpg和poster-250.jpg是按 500 像素、250 像素高度自动生成的两档缩图。横幅类图片（banner）生成 70 像素和 35 像素两档，背景墙（fanart）和截图生成 360 像素和 180 像素两档，角色头像（headshot）则和海报一样是 500/250 两档。文件后缀基本是 jpg，只有透明底的 clearlogo 用 png。

页面展示时，前端并不直接访问 TMDb，而是请求本机的/MediaCover/{电影ID}/poster.jpg这类地址，由 Radarr 把本地文件端出来，地址末尾再挂一段哈希参数防浏览器缓存。这个设计有个附带好处：你把电影从库里删掉时，对应的整个封面文件夹也会被一起清掉，不留垃圾。整个模块的源码都在 MediaCover 目录下，一共六个文件，想看细节随时可查。

从添加一部电影到看见海报的最小操作

安装就不展开了：装好对应系统的版本、启动一次、浏览器访问 7878 端口完成初始化即可。

接下来做最小闭环：在"电影"页面点添加，搜索一部你想收的片子，选中入库。Radarr 随即去取元数据并下载海报，几秒后刷新电影详情页，海报已经在位了。想验证机制的话，去数据目录里翻一下，应该能找到MediaCover/{电影ID}/下面 poster.jpg 和三张带尺寸后缀的 jpg。到这里，你的海报墙已经有了第一块砖。

海报墙的两种看法：内置网页与家庭影院媒体中心

内置网页直接看。Radarr 的 Web 界面本身就是一张海报墙：电影列表以卡片形式铺开展示封面，可以按标签、质量、是否已下载等条件筛选。收藏量上千时，这个页面就是你日常"逛片库"的入口，配合日历页还能顺手看最近有什么新内容。

交给 Kodi 或 Plex 当门面。如果你的家庭影院已经跑着媒体中心，更省事的做法是让它直接扫描你的电影根目录。Radarr 会把封面和元数据按媒体中心的规范落在影片目录里，Plex、Kodi 扫描后首页自然就是整墙海报，连通知配置都省了。如果希望入库变化时额外推送提醒，可以到设置里的通知模块对接，相关接口的源码在 Notifications 目录里。

顺手微调展示效果。界面主题可以在 UI 设置里切换，前端代码在 frontend/src/App/ApplyTheme.tsx 附近有体现；如果你会一点 CSS，给电影卡片组件补几行样式，就能调整间距和悬停动效，让网页版海报墙更合眼缘。

海报没下载下来去哪找

下载失败时源码里的处理很直白：捕获异常、记一条日志、继续处理下一张图，不会卡住整个入库流程。所以排查时按这个顺序来：

打开系统日志页，搜 "Couldn't download media cover"，能直接定位到是哪部电影、什么报错；
常见原因基本三类：元数据源的海报地址失效、服务器网络出不去、封面目录写权限不足，日志文案会提示是哪一种；
实在不行就手动兜底：自己找一张海报图，按命名规范存成MediaCover/{电影ID}/poster.jpg，尺寸后缀文件留空的话，页面会直接显示原图。

手动替换时留意一点：确认 ID 目录没找错，替换后如果页面还显示旧图或空白，多半是缓存问题，强制刷新浏览器缓存即可。如果目录里压根没有对应文件，那就得回到日志看下载那一步为什么失败了。

批量刷新所有电影海报

新加的片子会自动拉海报，但历史老数据或者手动动过文件的库，可能需要一次集中刷新。不必逐部电影点，命令接口支持一键触发：

curl -X POST http://127.0.0.1:7878/api/v3/command \ -H "X-Api-Key: 你的API密钥" \ -d '{"name": "RefreshMovie"}'

命令名RefreshMovie对应的是 commandNames.js 里定义的标准命令，执行后可以去活动页看任务跑到哪了。批量刷新会重新核对每部片子的封面是否存在、尺寸图是否齐全，缺的补齐，所以放心跑。

写在最后

灯光一暗，Plex 首页整墙海报亮起来的那一刻，你会明白为什么花这些功夫——收藏终于有了看得见的样子。最后提醒一句：MediaCover目录值得定期备份，重装系统或换机时，这些海报能原样带走，不用重新等下载。

【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

用Radarr海报展示你的电影收藏：打造电影海报墙的完整指南