如何给 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）
- 做什么：添加插件仓库。在哪做：控制台 → 插件 → 插件存储库 → 添加，粘贴官方 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 Token |
| Use FilePath for matching | 复选框 | 把文件所在目录路径纳入匹配依据 | 勾选 |
| Use OpenSubtitlesHash for matching | 复选框 | 用文件哈希做精确匹配，文件名混乱时很有效 | 勾选 |
| Order Style | 下拉框 | 多个匹配结果时的排序方式 | Default |
| Tag Style | 下拉框 | 标签以“类型”还是“标签”写入元数据 | Genre |
| Studio Style | 下拉框 | 厂牌字段取站点/上级厂牌/网络哪个值 | All |
| Custom Title Format | 文本框（需先启用 Use Custom Title） | 自定义标题模板 | {studio}: {title} ({actors}) |
| Scenes Image Option | 下拉框 | 影片海报取海报图还是背景图 | Poster |
| Add Collection on Site / Collection Type | 复选框 + 下拉框 | 按厂牌自动建合集，以及针对哪类内容 | JAV |
| Disable 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），仅供参考
)
