Jellyfin 接入 ThePornDB：给成人媒体库补上海报和元数据
Jellyfin 接入 ThePornDB：给成人媒体库补上海报和元数据
把成人向媒体扔进 Jellyfin 后，你常会拿到一个"裸"媒体库：没海报、没简介、没演员表，只剩一堆文件。Jellyfin.Plugin.ThePornDB 就是干这个的——它是个元数据提供器（metadata provider），能从 ThePornDB 数据库给你的媒体批量匹配海报、简介和演员信息。
它在 Jellyfin 里扮演什么角色
简单说，它是一个同时兼容 Jellyfin 和 Emby 的元数据提供器，你可以理解成成人向媒体的"资料管家"。装好之后它会接管"远程搜索 + 下载元数据"这条链路，覆盖场景、电影、JAV 三类内容，演员页面也能一并匹配。
🔧 四步跑起来
- 拿包：从仓库的 Releases 下载最新 release 包；想自己编译也行，克隆源码后执行：
git clone https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB dotnet build ThePornDB.sln -c Release注意：产物分两套，Release对应 Jellyfin，Release.Emby对应 Emby，别拿混。
- 放对位置：Jellyfin 的插件目录一般在
/var/lib/jellyfin/plugins，里面建一个ThePornDB子文件夹，把 dll 丢进去。release 包已经带好了子文件夹，直接解压到插件目录即可。 - 重启：重启 Jellyfin 服务，插件才会被加载。
- 验证生效：Web 面板「Dashboard → Plugins」里能看到 ThePornDB；再随便打开一个条目，点元数据搜索，数据源列表里出现 "ThePornDB"，就算装好了。
配置页里值得动的几项
没有独立配置文件，全部在面板里：Dashboard → Plugins → ThePornDB。最常调的几项：
| 选项 | 作用 |
|---|---|
| Token | ThePornDB 网站的 API token，填上相当于走认证访问，限流更稳 |
| Use OpenSubtitlesHash | 按文件哈希直接匹配，最准，建议开 |
| Use FilePath | 按文件/文件夹名匹配，哈希匹配不上时的兜底 |
| Scenes Image Option | 选主图用海报（Poster）还是背景（Background） |
| Use Custom Title Format | 自定义标题模板，默认{studio}: {title} ({actors}) |
⚠️ 常见坑与排查方向
- 插件不出现：九成是版本不匹配。Jellyfin 版按 10.11 系列编译（.NET 9），Emby 必须用
Release.Emby产物；看服务器日志里的加载报错最直观。 - 远程搜索超时或搜不到：ThePornDB 的 API 有限流，插件内置了限速和缓存，但批量扫描仍可能被掐。放慢扫描频率，或者先把 Token 填上。
- 元数据一直匹配不上：检查文件名里是否带标题（直接影响匹配策略）；开启 Unmatched Tag 可以给没匹配上的条目打标签，方便批量找出来。想按站点分组的，插件里还带一个 "Add Collection" 定时任务。
碰到更冷门的怪问题，直接翻官方仓库的 README 和 Issues，同类案例非常多。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考