企业官网建设流程全解析

Radarr 海报墙指南：封面自动下载、手动替换与媒体中心同步一次讲清

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

Radarr 是面向 Usenet 和 BitTorrent 用户的免费电影管理工具，它的海报墙能力藏在 MediaCover 模块里：电影入库后自动从 TMDb 下载高清海报，生成多尺寸文件存到本地，再同步到 Plex、Kodi。如果你遇到"入库后没有封面""海报发糊""媒体中心不显示新封面"，按下面四段对症处理即可。

封面没有自动下载下来

先给结论：只要元数据更新，封面就会自动补齐，不需要手动点下载。MediaCoverService 会监听电影更新事件，发现本地缺海报时立刻向元数据源发起下载，下载完成后再按类型生成缩略图（源码 第 107-163 行）。

海报文件存在哪、叫什么

所有封面存放在应用数据目录下的 MediaCover 文件夹，每部电影一个独立子目录，目录名就是电影 ID。文件命名由 GetCoverPath 拼接：

public string GetCoverPath(int movieId, MediaCoverTypes coverType, int? height = null) { var heightSuffix = height.HasValue ? $"-{height}" : ""; return Path.Combine(GetMovieCoverPath(movieId), coverType.ToString().ToLowerInvariant() + heightSuffix + GetExtension(coverType)); }

尺寸规则固定：海报（Poster）和头像（Headshot）生成 500 与 250 两种高度；横幅（Banner）是 70 与 35；背景图（Fanart）和截图（Screenshot）是 360 与 180。缩略图在文件名里带-高度后缀，比如 poster-250.jpg。

下载失败的排查顺序

失败不会弹窗，只会写进日志，按这个顺序查：先看日志里有没有 "Couldn't download media cover" 告警；有告警多半是网络问题或元数据源 URL 失效；无告警且文件缺失，检查 MediaCover 目录的写权限。修复后不用整库刷新，对单部电影触发 RefreshMovie 命令即可重新拉取封面。

手动替换一张海报文件的正确姿势

自动海报不满意时，手动替换完全可行，关键在文件名必须对得上：

1. 从 TMDb 网页或 API 下载你满意的图片，原图存为poster.jpg；
2. 进入 MediaCover/{电影ID}/ 目录，覆盖同名文件；
3. ⚠️ 同时删掉 poster-500.jpg、poster-250.jpg 两个缩略图，否则 Radarr 不会重新裁切，你看到的还是旧图；
4. 触发一次 RefreshMovie 刷新，事件链会重新生成缺失的缩略图。

需要批量处理时，直接调命令接口，一次传多个 movieIds：

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

让 Plex、Kodi 里的封面跟着更新

Radarr 的媒体中心同步走的是通知插件，实现分别位于 Notifications/Plex 和 Notifications/Xbmc。

在设置页配置通知

进 Web 界面 Settings → Notifications，添加 Plex 或 Kodi 条目，填入服务器地址、端口（Kodi 默认 8080）和账号。之后每次电影导入、刷新或升级画质，Radarr 都会向媒体中心推送库更新，新海报随之进入 Plex/Kodi。

同步了但封面还是旧的

这通常是缓存问题，不一定是 Radarr 的错。先确认队列里没有失败的刷新任务，再手动让 Plex 刷新一下那部电影。另外注意：如果你改过本地海报文件，必须再触发一次 RefreshMovie，Radarr 才会把新封面信息推送给媒体中心，只换文件不刷新等于白换。

批量维护海报的几个实用习惯

• 定期备份 MediaCover 整个目录，重装系统时封面资产不丢；
• 删除电影时，Radarr 会连同该电影的海报文件夹一起清理，不用手动删残留；
• 想看下载与裁切细节，读 MediaCoverService.cs 这一个文件就够。

现在就打开 MediaCover 目录，确认一部电影的海报文件是否齐全，缺哪个补哪个。

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