如何给 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 的 API（api.theporndb.net），内网隔离环境装上也白装。
• 一个 Token：需要 ThePornDB 账号的 Metadata API Token。

⚠️ 最容易踩的坑就在这里：不填 Token，插件不会报错，只是安静地返回空结果。很多人以为“装坏了”，其实只是没配凭证。装之前就把 Token 准备好。

手把手安装步骤：5 分钟装好 ThePornDB 插件

插件没有独立的启动入口——装好后它随 Jellyfin 服务启动自动加载，你不需要（也无法）单独“运行”它。下面是两种装法。

方式 A：插件仓库安装（推荐，仅 Jellyfin）

1. 做什么：添加插件仓库。在哪做：控制台 → 插件 → 插件存储库 → 添加，粘贴官方 README 中 “Install” 一节给出的仓库 manifest 地址（形如…/manifest.json，以 README 为准）。做对了是什么样子：仓库列表里出现这条新地址。
2. 做什么：安装插件。在哪做：插件 → 浏览，找到 ThePornDB，点安装。做对了是什么样子：插件列表里 ThePornDB 显示已安装，左侧“插件”区多出一个 ThePornDB 入口。
3. 做什么：重启一次 Jellyfin 服务，确认插件正常加载。

方式 B：手动安装（Jellyfin / Emby 通用）

1. 做什么：从官方 Release 下载最新的插件 zip 包（版本号与服务器版本对应关系见上一条准备事项）。
2. 做什么：把 zip 内容解压到服务器的插件目录——配置目录下的plugins文件夹，Docker 部署一般在/config/plugins里。做对了是什么样子：该目录下能看到ThePornDB.dll。
3. 做什么：重启 Jellyfin 服务，到控制台插件页确认出现 ThePornDB 条目。

配置项速查：如何修改插件配置并保存

所有配置都在控制台 → 插件 → ThePornDB页面完成（配置页是插件内置的，不用手动改文件），点底部 Save 保存即可，一般无需重启服务。

💡 建议先把两个匹配开关（FilePath / OpenSubtitlesHash）都勾上跑一遍，再按效果取舍——这样做的目的是让插件“多一条线索”去认你的文件。

装了插件不生效？4 个高频问题排查

1. 现象：搜索没有任何结果。原因：Token 未填、填错或过期（空 Token 时插件直接返回空列表，不打日志报错）。解法：回 ThePornDB 账号重新获取 Token，填进插件配置页保存，再对单部电影手动搜一次验证。
2. 现象：插件仓库里找不到 ThePornDB。原因：仓库地址没添加成功，或服务器无法访问外网。解法：核对地址是否完整，检查服务器网络连通性。
3. 现象：装完列表里没有插件入口。原因：插件与服务端版本不匹配（新版要求 Jellyfin 10.11）。解法：按manifest.json的 targetAbi 选对应旧版本，手动安装的先把旧文件夹清掉再放新版。
4. 现象：能拉到数据，但标题、演员不对。原因：文件名太隐晦导致匹配偏差，或误开了 Disable 系列开关。解法：开启路径/哈希匹配，检查 Disable Actors、Disable Genres 等是否被勾选，必要时用自定义标题模板兜底。

小结

一句话：这个插件的价值就是“一次配置，长期自动匹配”，把成人影片库从文件堆变成有封面、有演员、有合集的媒体库。关键提醒：Token 是命门，改完配置记得点 Save，升级或更换插件版本后请重启 Jellyfin 服务。更多细节请以项目README.md和 Jellyfin 官方文档中“插件管理”一节的最新说明为准。