Jellyfin 成人影片元数据插件 ThePornDB：5 分钟装好并调通
【免费下载链接】Jellyfin.Plugin.ThePornDBJellyfin/Emby Metadata Provider项目地址: https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB
Jellyfin.Plugin.ThePornDB 是 Jellyfin / Emby 的元数据插件：接上 ThePornDB 数据源后，它会自动为你的影片库搜索匹配，把标题、简介、海报、演员、厂牌信息全部拉回来。不用再逐条手填信息，这篇文章带你从安装、匹配到显示微调一次跑通。
三步装完：把 ThePornDB 加进 Jellyfin 插件列表
插件没有独立入口，装好后由 Jellyfin 服务启动时自动加载，不需要你跑任何命令。
- 登录 Jellyfin 网页面板，进入「控制台 → 插件管理器 → 已安装」，点顶部的「添加」。
- 填入插件仓库地址，即官方仓库 README 里以
manifest.json结尾的那个仓库 URL（此方式仅 Jellyfin 支持）。 - 搜索 "ThePornDB"，点击安装，稍等几秒即出现在已安装列表。
走手动安装（Emby 4.9 用户必须用它）：从官方 Release 页下载插件压缩包（最新 1.6.0.11，支持 Jellyfin 10.11 / Emby 4.9），解压到服务器的plugins目录，重启 Jellyfin 即可。
打开插件页，把匹配方式和 Token 配好
默认按文件名里的标题去搜，文件名规范就能命中；想提高命中率，再加两个开关：
- 「控制台 → 插件管理器 → ThePornDB」打开配置页。
- 勾选 Use FilePath for matching（改用文件完整路径参与匹配）。
- 勾选 Use OpenSubtitlesHash for matching：这是字幕站匹配字幕用的文件哈希算法，文件相同就能精确对上，非常稳。
- 选填 Token：填入 ThePornDB 的 API Token 可提升请求额度，不填也能用。
- 点 Save 保存。
所有选项都写进 Jellyfin 的插件配置，保存后立即生效，下次抓取元数据时按新规则走，不用重启服务。
能拿到什么数据：场景、演员、厂牌一次补齐
- 场景（Scene）：匹配后自动回填标题、简介、发行日期、预告片，海报和背景图直接下载入库；再配合内置的 "Add Collection" 定时任务，能按厂牌自动建合集，把同厂牌影片归到一起。
- 演员（Performer）：头像、生日、出生地写入人物页，角色栏可显示性别或片内用名，还能关闭男性演员入库，让列表更精简。
- 厂牌（Site）：站点、父站点、发行网络可写入 Studio 字段，用 Studio Style 选粒度，适合按厂牌筛选浏览。
微调显示：自定义标题与合集规则
同一个配置页里还能改这些展示细节：
- Tag Style：决定标签写进「类型（Genre）」字段、「标签（Tag）」字段，还是完全不写。
- Use Custom Title Format：用模板重命名影片，默认
{studio}: {title} ({actors})，整个库标题格式立刻统一。 - Add Collection on Site + Collection Min Size：匹配后自动加入合集，并用最小数量过滤掉太小的合集。
- Collection Type：把以上合集行为限定在 Scene、Movie、JAV 或全部类型上。
常见问题：匹配不到、Token 必填吗、要不要重启
Q：搜索完全没有结果？先确认文件名包含影片标题；不包含就把上面的路径和哈希匹配打开。还可以把 Order Style 改成 DistanceByTitle，它按标题相似度模糊匹配，接近但不完全一致也能找到。
Q：Token 是必填项吗？不是。不填插件照常工作，填入只是为了提高 API 请求额度。
Q：改完配置要重启 Jellyfin 吗？不用。配置页所有选项保存即生效；只有升级插件本身（更换压缩包）才需要重启服务。
Q：影片很多，会不会把 API 打爆？不会。插件内置限流（每分钟最多 120 次请求）和响应缓存，重复请求同一内容不重复计数。
Jellyfin.Plugin.ThePornDB 属于装上就能用的类型：装插件、开匹配、补元数据，三步到位。更多配置细节和版本更新记录，请以官方仓库的 README 与 Release 说明为准。
【免费下载链接】Jellyfin.Plugin.ThePornDBJellyfin/Emby Metadata Provider项目地址: https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
