Radarr 电影海报管理：4 个最常踩的坑，项目里都给了默认解法
【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr
Radarr 是一款面向 Usenet 和 BitTorrent 用户的电影收藏管理器，它的海报系统直接决定你的电影墙好不好看。这篇文章不按教程步骤走，而是围绕电影海报自动下载、海报存储目录、多尺寸裁切和媒体中心同步这 4 个新手最容易卡住的点，讲讲 Radarr 内部是怎么解决的。
🎬 海报不见了：先搞清楚文件存在哪
- 添加电影时，MediaCoverService 会从 TMDb（一个免费的电影元数据源）拉取封面图，存到应用目录下的
MediaCover文件夹 - 每部影片按数据库 ID 独占一个子目录，原始图和多尺寸裁切图都放在里面
- 删掉电影时，对应的海报目录也会被自动清掉，不会留垃圾文件
目录结构大概长这样：
MediaCover/ ├── 123/ │ ├── poster.jpg # 原始尺寸 │ ├── poster-500.jpg # 高度 500px 裁切 │ └── poster-250.jpg # 高度 250px 缩略图一张海报为什么变成三个文件
- 源码里对不同封面类型硬编码了裁切高度：海报 500/250，横幅 70/35，背景图 360/180
- 多尺寸的意义在于：Web 列表页加载缩略图快，详情页才请求大图，Kodi 这类媒体中心也能各取所需
- 一个容易被忽略的细节：裁切任务用信号量限制了并发数，因为图片库在 ARM 架构（比如树莓派）上没有硬件加速，不加限制会把机器卡死
海报下载失败：先查日志再动手
- 下载失败不会让整个流程中断，而是以 warning 级别写进日志，所以"界面看着没事、海报却缺失"时，第一步永远是翻日志
- 高频原因就三个：元数据源的图片地址失效、服务器出不了外网、应用目录写权限不足
- 兜底方案：手动下载一张 jpg，按
poster.jpg的命名放进对应电影 ID 的目录，再刷新一下影片即可
MediaCover 核心源码
🖥️ 让 Kodi 和 Plex 自动同步海报墙
- Radarr 每导入或整理完一部电影，都会广播一次事件，Kodi、Plex 这类媒体中心的通知器就挂在这个事件上
- 你只需要在设置的 Notifications 面板里启用对应通知器，填好媒体中心的地址，之后海报更新、库变更都会自动推过去，不用手动扫库
- 通知器的可用动作（比如"影片导入""媒体封面更新"）都定义在 API 层的资源类里，配界面时能直接看到
Notifications 集成目录
想批量重刷所有海报？
不用一部部点刷新，直接调命令 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]}'实用贴士：
MediaCover目录就是全部本地海报缓存，重装系统或迁移数据库前先把它备份走，否则新环境重建完，你的电影墙会变成一排空白占位图。
【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
