CloudDrive2 × Emby / Jellyfin 服务端插件正式发布 v1.0.0 把 Emby / Jellyfin… — CloudNAS

CloudNAS@cloud_nas · 11.7K subscribers Open in TelegramOpen

🎉 CloudDrive2 × Emby / Jellyfin 服务端插件正式发布 v1.0.0

把 Emby / Jellyfin 与同一台机器上的 CloudDrive2 连起来。
装插件就能用 —— 前两项功能完全不需要安装 CloudDrive2 App。

━━━━━━━━━━━━━━━━

📌 核心：媒体库实时更新，而且可以把「实时监控」全部关掉

以前是个两难：

• 开实时监控 —— Linux 的 inotify 不支持递归监视，Emby/Jellyfin 必须先把整个媒体库目录树递归遍历一遍，给每一个子目录单独注册 watch。库挂在网盘上，就等于每次启动都要把整棵目录树从云端重新列一次：启动慢得离谱，还打出一大片云端请求。

• 关实时监控 —— 那个媒体库就完全无人监视，只能等定时整库扫描。而整库扫描正是网盘风控封号的主要原因。

装上插件后不用再选了：插件直接订阅 CloudDrive2 的文件变化推送，交给媒体服务器做定向刷新（走的是服务器自带监视器的同一个入口，所以合并、去抖、局部刷新逻辑全部照常，不会跑整库扫描）。

于是你可以把所有网盘媒体库的实时监控全部关掉 —— 没有启动遍历、不占 inotify watch、开机不再有列目录风暴，而实时更新一切照旧。库越大，省得越多。

⚠️ 注意：文件系统变化通知是 CloudDrive2 会员（Pro）功能。非会员账号收不到变化推送，媒体库不会自动更新。

━━━━━━━━━━━━━━━━

🎬 第三方刮削器直接可用

tinyMediaManager、MoviePilot、MDCx 这类工具都是直接在挂载目录上干活：扫描源目录、逐个刮削、重命名、生成 nfo 和封面，再移动到媒体库目录。

这些操作全部经由挂载，CloudDrive2 会为每一步发出变化推送（重命名会同时推送旧路径和新路径，所以条目不会重复、也不会残留），插件再喂给媒体服务器。刮削完的影片会自动出现在媒体库里 —— 全程实时监控保持关闭。

━━━━━━━━━━━━━━━━

⚡ 按播放行为预热

• 起播时预热文件头部和尾部（头部是出第一帧前必读的 moov / EBML 头，尾部是 MKV cues，拖进度条立刻要用）
• 接近片尾时预热同一网盘目录下的下一个文件，切集不再从零开始
• 停止播放时取消预取并释放网盘连接（网盘并发连接有上限，泄漏的读取器会拖垮后续播放）

所有客户端一并受益：官方 App、网页播放器、第三方播放器都算，不限于 CloudDrive2 App。

━━━━━━━━━━━━━━━━

🔗 免配置路径映射

CloudDrive2 App 登录媒体服务器后自动推算直连播放的路径映射，不用再逐个服务器手写规则。匹配依据是网盘账号身份而不是文件夹名 —— 两端挂载名不同也不会错配。

直连播放的价值不只是快：蓝光原盘菜单（ISO/BDMV）、杜比视界 P7、DSD/SACD、MVC 3D 这些格式，媒体服务器自身的转发接口根本无法正确提供，只有直连才能播。

⚠️ 此项需要 CloudDrive2 App 1.0.14 或更高版本（尚未发布，即将推出）。上面两项与它无关，装插件即刻生效。

━━━━━━━━━━━━━━━━

📦 安装

Emby —— 解压后把 CloudDrive.MediaServer.dll 直接放进插件目录（不要建子文件夹，也不需要 meta.json）

Jellyfin —— 整个压缩包解压到插件目录下的一个子文件夹，meta.json 和 thumb.png 要和 DLL 放在一起

重启服务器，然后在控制台 → 插件 → CloudDrive 里填写 CloudDrive2 地址和 API 令牌即可。

⚠️ 在运行中的容器里替换 DLL，请重启容器，只按服务器自身的「重启」按钮不够。

━━━━━━━━━━━━━━━━

已验证：Emby 4.9.5.0 / Jellyfin 10.11.11
开源，GPL-3.0

项目主页：https://github.com/cloud-fs/clouddrive-mediaserver-plugin
下载：https://github.com/cloud-fs/clouddrive-mediaserver-plugin/releases