企业官网建设流程全解析

Radarr 电影海报墙实操指南：从 0 到 1，把电影库变成会自己更新的展示墙

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

在大屏上翻电影库，最扎眼的从来不是文件多乱，而是一整排灰扑扑的无图方块。对影音爱好者来说，一面「电影海报墙」才是收藏真正的门面。Radarr 就是为这类需求而生的电影收藏管理器：它面向 Usenet 和 BitTorrent 用户，你只管把电影加进库，海报则由它自动从 TMDb 匹配、下载、缩放并存到本地，随后可同步给 Plex、Kodi 等媒体中心直接展示。

🖼️ Radarr 的海报机制：图片为什么能自动进库

不用逐张手动存图，靠的是 MediaCover 模块 这套流水线，它只做三件事：

• 自动匹配元数据：添加电影后，Radarr 从元数据源 TMDb 拉取该片的图片列表，逐个下载到本地，无需你在界面里做任何操作。
• 多尺寸自动缩放：下好后会按类型生成不同高度档位——Poster（海报）出 500px 和 250px 两档，Banner（横幅）出 70px 和 35px 两档，Fanart（背景图）出 360px 和 180px 两档。大屏用原图，列表页用小图，各取所需。
• 对接媒体中心：内置 Plex 通知器 和 Kodi 通知器，电影入库或状态变化时主动推送，媒体中心库随之刷新，海报墙同步更新。

换句话说：海报墙不需要你"做"出来，只需要把 Radarr 跑起来，它会自己长出来。

🚀 五分钟跑起来：在界面里看到第一张海报

最小完整路径如下，全程不超过十分钟：

git clone https://gitcode.com/GitHub_Trending/ra/Radarr cd Radarr ./test.sh # 跑一遍测试，确认本地环境没问题

这三条命令负责把仓库拉到本地并验证环境健康。接着运行 Radarr（发行版直接双击启动，源码构建则执行对应启动命令），然后浏览器打开http://你的IP:7878——7878 是 Radarr 的默认端口，首次启动会进入引导向导。

向导里做两件事：添加一个根目录（存放影片的位置），然后到 Discover 页面搜一部电影、点添加。稍等片刻刷新页面，这部电影的卡片上就该出现海报了。至此，海报墙的"第一块砖"已经砌好。

📂 看懂海报存哪了：MediaCover 目录结构

Radarr 默认把海报放在应用数据目录下的MediaCover文件夹，每部电影一个以 ID 命名的子文件夹，内部按"类型 + 高度"命名：

MediaCover/ ├── 1/ # 电影 ID = 1 │ ├── poster.jpg # 原始海报 │ ├── poster-500.jpg # 500px 档 │ └── poster-250.jpg # 250px 档 └── 2/ └── banner-70.jpg # 70px 横幅

这个结构直接对应你将来要做的替换和备份：只要知道电影 ID，就能精准定位它的所有图。

触发时机也很省心：每当电影元数据更新（比如你点了刷新），MediaCover 服务就会检查本地文件——缺哪个下哪个，已存在的跳过，不会重复下载。这也是为什么手动替换海报前，要先想好文件名对上号。

🛠️ 手动换海报与批量刷新：不顺手的时候怎么办

对自动抓到的图不满意？两条路：

1. 单片替换：把自制图按命名规范（如poster-500.jpg）放进MediaCover/电影ID/目录，然后在电影页点刷新元数据，界面即改用新图。
2. 批量刷新：海报大面积缺失或过期时，走命令 API 一次性触发RefreshMovie：

curl -X POST http://your-ip:7878/api/v3/command \ -H "X-Api-Key: your-api-key" \ -d '{"name": "RefreshMovie", "movieIds": [1, 2, 3]}'

这条命令向 Radarr 的 v3 API 提交一个RefreshMovie任务，movieIds里填电影 ID 列表，任务执行后这些影片的元数据和海报会全部重新校验。API Key 在设置页面就能拿到。

📺 把海报墙接进 Plex 和 Kodi：开箱即看

Radarr 负责"存图"，媒体中心负责"展示"，中间靠通知器衔接：

• 进入设置 → 通知，添加Plex Server，填入服务器地址与 token（token 从 Plex 的媒体服务器信息里复制），选择电影区。
• 再添加一个Kodi，填 Kodi 的主机与端口，认证方式按需选择。
• 两者都勾选"电影入库/更新时发送通知"这类触发事件。

配置完成后体验是"开箱即看"的：Radarr 里每多一部电影，Plex 和 Kodi 的库自动多一张海报，你甚至不用打开媒体中心去点"扫描媒体库"。大屏端的海报墙从此跟着 Radarr 的入库节奏自己生长。

⚠️ 避坑清单：海报相关高频问题

如果界面连不上，先确认 7878 端口是否被其他实例占用了——这是新手期最常见的"假死"。

✅ 收尾：一条提醒与两个进阶方向

实用提醒：把MediaCover目录纳入你的定期备份。重建系统时，数据库可以导、海报也能重新下载，但手动替换过的那部分图，备份是唯一保险。

进阶方向，看兴趣挑一个：

• 用RefreshMovie命令 API 写个定时脚本，把"批量刷新"变成每周一自动执行的家务。
• 结合导入列表功能，把整个片单批量灌进库，一次养成一整面海报墙。

现在就动手：打开设置 → 通知 → 添加 Plex Server，填上你的 Plex 地址和 token——五分钟后，你的大屏就该亮起来了。

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