如何给 Jellyfin 装上 ThePornDB 插件：成人影片元数据一步到位

如何给 Jellyfin 装上 ThePornDB 插件成人影片元数据一步到位Jellyfin ThePornDB 插件Jellyfin.Plugin.ThePornDB是专为 Jellyfin兼容 Emby打造的元数据插件它能自动从 ThePornDB 数据库拉取成人影片的标题、演员、厂牌与封面让你的媒体库告别一堆裸文件名。它能帮你做什么两个典型场景场景一给无元数据的影片库“补课”。你有一批成人影片文件导入 Jellyfin 后只有文件名、没有海报、没有演员、没有简介。装上这个插件后媒体库扫描时会按文件名或文件路径、文件哈希去 ThePornDB 匹配自动填上标题、演员阵容、厂牌、剧情标签并下载海报和背景图。它同时覆盖三类内容Scene、Movie 和 JAV。场景二把“人”和“合集”也管起来。插件不只是给影片打标签它还会识别 Performer 并自动建立演员页写入角色、头像和简介配合内置的 “Add Collection” 计划任务控制台 → 任务里可手动触发还能按厂牌/站点把影片自动归组成 Collection方便浏览。安装前的准备环境要求与一个必踩的坑Jellyfin 版本最新版插件1.6.0.11面向 Jellyfin 10.11 编译Emby 侧则支持 4.9。版本不匹配是装完不显示的高频原因老版本服务器可对照项目manifest.json里的版本列表选对应旧版。网络服务器必须能访问外网插件实际调用的是 ThePornDB 的 APIapi.theporndb.net内网隔离环境装上也白装。一个 Token需要 ThePornDB 账号的 Metadata API Token。⚠️ 最容易踩的坑就在这里不填 Token插件不会报错只是安静地返回空结果。很多人以为“装坏了”其实只是没配凭证。装之前就把 Token 准备好。手把手安装步骤5 分钟装好 ThePornDB 插件插件没有独立的启动入口——装好后它随 Jellyfin 服务启动自动加载你不需要也无法单独“运行”它。下面是两种装法。方式 A插件仓库安装推荐仅 Jellyfin做什么添加插件仓库。在哪做控制台 → 插件 → 插件存储库 → 添加粘贴官方 README 中 “Install” 一节给出的仓库 manifest 地址形如…/manifest.json以 README 为准。做对了是什么样子仓库列表里出现这条新地址。做什么安装插件。在哪做插件 → 浏览找到 ThePornDB点安装。做对了是什么样子插件列表里 ThePornDB 显示已安装左侧“插件”区多出一个 ThePornDB 入口。做什么重启一次 Jellyfin 服务确认插件正常加载。方式 B手动安装Jellyfin / Emby 通用做什么从官方 Release 下载最新的插件 zip 包版本号与服务器版本对应关系见上一条准备事项。做什么把 zip 内容解压到服务器的插件目录——配置目录下的plugins文件夹Docker 部署一般在/config/plugins里。做对了是什么样子该目录下能看到ThePornDB.dll。做什么重启 Jellyfin 服务到控制台插件页确认出现 ThePornDB 条目。配置项速查如何修改插件配置并保存所有配置都在控制台 → 插件 → ThePornDB页面完成配置页是插件内置的不用手动改文件点底部 Save 保存即可一般无需重启服务。配置项所在位置作用示例值Token配置页首个输入框API 凭证不填则搜索恒为空你的 API TokenUse FilePath for matching复选框把文件所在目录路径纳入匹配依据勾选Use OpenSubtitlesHash for matching复选框用文件哈希做精确匹配文件名混乱时很有效勾选Order Style下拉框多个匹配结果时的排序方式DefaultTag Style下拉框标签以“类型”还是“标签”写入元数据GenreStudio Style下拉框厂牌字段取站点/上级厂牌/网络哪个值AllCustom Title Format文本框需先启用 Use Custom Title自定义标题模板{studio}: {title} ({actors})Scenes Image Option下拉框影片海报取海报图还是背景图PosterAdd Collection on Site / Collection Type复选框 下拉框按厂牌自动建合集以及针对哪类内容JAVDisable Actors / Directors / Genres复选框关闭对应元数据入库精简库体积不勾选Actors Image / Role / Overview下拉框 文本框演员头像取全身还是脸照、角色显示方式、简介自定义模板Poster 建议先把两个匹配开关FilePath / OpenSubtitlesHash都勾上跑一遍再按效果取舍——这样做的目的是让插件“多一条线索”去认你的文件。装了插件不生效4 个高频问题排查现象搜索没有任何结果。原因Token 未填、填错或过期空 Token 时插件直接返回空列表不打日志报错。解法回 ThePornDB 账号重新获取 Token填进插件配置页保存再对单部电影手动搜一次验证。现象插件仓库里找不到 ThePornDB。原因仓库地址没添加成功或服务器无法访问外网。解法核对地址是否完整检查服务器网络连通性。现象装完列表里没有插件入口。原因插件与服务端版本不匹配新版要求 Jellyfin 10.11。解法按manifest.json的 targetAbi 选对应旧版本手动安装的先把旧文件夹清掉再放新版。现象能拉到数据但标题、演员不对。原因文件名太隐晦导致匹配偏差或误开了 Disable 系列开关。解法开启路径/哈希匹配检查 Disable Actors、Disable Genres 等是否被勾选必要时用自定义标题模板兜底。小结一句话这个插件的价值就是“一次配置长期自动匹配”把成人影片库从文件堆变成有封面、有演员、有合集的媒体库。关键提醒Token 是命门改完配置记得点 Save升级或更换插件版本后请重启 Jellyfin 服务。更多细节请以项目README.md和 Jellyfin 官方文档中“插件管理”一节的最新说明为准。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考