【官方推荐】PPJF 10.11.5：Jellyfin与PotPlayer的完美联动指南

如果你正在使用 Jellyfin 搭建个人私人影院，那么这款 PPJF 插件就是你的必装神器。它能让你直接在浏览器里点一下，就调用本地的 PotPlayer 进行硬解播放。

针对最新 10.11.5 版本（文章底部附件提供原版文件下载），我们整理了这份比官方更易读的安装指南。

一、 核心安装（必做 3 步）

1. 安置文件（至关重要）： 将下载的文件夹解压，重命名为 PotPlayerJellyfin，然后务必移动到这个路径：C:\ProgramData\。 正确路径应为：C:\ProgramData\PotPlayerJellyfin

2. 注册协议： 进入该文件夹，双击运行 potplayer.reg 并确认。这会让你的电脑学会处理 potplayer:// 协议。

3. 配置油猴脚本：

   • 在浏览器安装 Violentmonkey（暴力猴） 插件。

   • 新建脚本，清空默认代码。

   • 用记事本打开文件夹里的 OpenWithPotplayerUserscript.js，全部复制并粘贴到插件中保存。

   • 注意： 如果你的 Jellyfin 地址不是默认的 localhost:8096，请在脚本开头的 @match 处修改为你自己的服务器地址（例如 // @match http://192.168.1.10:8096/*）。

二、 权限设置（防止启动失败）

由于 PPJF 使用了 PowerShell 脚本，你需要给 Windows 权限：

1. 以管理员身份运行 PowerShell。

2. 输入命令：Set-ExecutionPolicy RemoteSigned -Force 并回车。

3. （可选）右键运行 Install-PPJF-HiddenProtocol.ps1，这可以隐藏播放时弹出的蓝色脚本窗口，让启动更美观。

三、 NAS 用户必看：解决“无法打开媒体”报错

如果你发现 PotPlayer 启动了，但提示找不到文件，通常是路径不匹配。

1. 在 Windows 里将你的 NAS 文件夹映射为一个盘符（比如 D:）。

2. 用记事本打开 potplayer.ps1，找到末尾的 # YOUR NAS CONFIG。

3. 添加一行：$path = $path -replace "\\你的NAS路径\\", "D:"

四、 进阶功能：服务自动开关

PPJF 还支持“随开随关”功能。通过文件夹里的 Jellyfin.bat 启动，可以实现打开网页时开启 Jellyfin 服务，关闭网页时自动释放系统资源。这对于配置不高的电脑非常实用。

常见问题 FAQ

• 问：PotPlayer 更新后失效了怎么办？ 答：重新运行一遍 potplayer.reg 即可修复。

• 问：一定要用 Firefox 吗？ 答：推荐使用。Chrome 和 Edge 虽然也能用，但经常会弹出安全确认框。

• 问：我的 PotPlayer 装在 D 盘，需要改吗？ 答：默认脚本支持 C 盘路径。如果你装在非默认位置，请修改 potplayer.ps1 最后一行中的 EXE 路径。