企业官网建设流程全解析

MoviePilot v2.3.6 阿里云盘 API 与飞牛影视接入完整指南

【免费下载链接】MoviePilotNAS媒体库自动化管理工具项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot

MoviePilot v2.3.6 这次把阿里云盘从第三方脚本切换到官方开放接口，同时新增飞牛影视作为媒体服务器类型。如果你的资源流向涉及云盘秒传，或家里跑的是飞牛系统，这个版本值得升级；两者都不沾边，可以按自己节奏安排。

版本概览

功能拆解

阿里云盘官方 API 接入

是什么：用官方开放接口完成登录、文件管理和上传，替代过去依赖非官方方式的不稳定连接。

在哪配置：存储配置里选择「阿里云盘」；系统设置里填ALIPAN_APP_ID（阿里云盘开放平台应用标识，默认ac1bf04dc9fd4d9aaabb65b4a668d403，用自己创建的应用可换成自己的 App ID）。

如何验证：点扫码登录，用阿里云盘 App 扫二维码，状态从「等待登录」变为「登录成功」，随后能列出空间与文件即生效。

配置动作收敛为：

• 创建或选用一个开放平台应用，记下 App ID
• 在存储配置里选「阿里云盘」，填入 App ID
• 扫码完成设备授权，令牌自动保存并到期刷新

源码见 alipan 存储适配。

飞牛影视媒体服务器

是什么：把飞牛影视当成和 Emby、Plex 同级的媒体服务器，接入统一接口做同步、媒体数量统计与续播查询。

在哪配置：媒体服务器设置里新增一台，类型选飞牛影视（trimemedia），填host（如http://192.168.1.10:5666/v）、username、password；开启设备访问码时再填access_code；有外网播放需求可填play_host。

如何验证：保存后做一次连接测试，能拉到前后端版本号并列出媒体库，说明认证与请求签名都通了。

配置动作收敛为：

• 先确认飞牛侧已给 MoviePilot 分配登录账号
• 填写 host、username、password，访问码按需填
• 勾选要同步的媒体库（sync_libraries）

源码见 trimemedia 模块。

云盘快照对比开关

是什么：对阿里云盘做快照对比时，决定是否检查文件夹的修改时间。

在哪配置：系统设置里的ALIPAN_SNAPSHOT_CHECK_FOLDER_MODTIME，默认关闭。

如何验证：保持默认关闭即可；只有当目录时间能准确反映子文件变化时才打开，避免大量目录时间不更新的误判。

实战建议

组合一：云盘备份 + 秒传。适合「下载完自动上云做异地备份」。把阿里云盘设为目标存储，开启秒传后大文件命中直接完成；目录时间不稳定就别开目录时间检查，靠文件级对比。

组合二：飞牛库 + 自动整理。适合「NAS 用飞牛当媒体服务器」。接入飞牛后把要同步的库勾选进 sync_libraries，MoviePilot 下载整理完成即可刷新飞牛媒体库，续播列表也会出现在面板。

组合三：云盘 + 消息通知。上传或同步完成后推送到飞书、钉钉等通知渠道，异地查看进度不用一直盯着面板。

避坑排查

现象：扫码登录后不久又提示「会话失效，请重新扫码」。 可能原因：refresh_token 丢失，或应用权限范围（scope）不足。 解决办法：重新扫码，确认创建应用时勾选了user:base、file:all:read、file:all:write、file:share:write权限。

现象：飞牛影视提示「访问码校验失败」或连不上。 可能原因：host末尾的/v路径、访问码或账号密码填错。 解决办法：核对 host 是否以/v结尾（如http://<IP>:5666/v），未开访问码就留空access_code，再检查用户名密码。

现象：秒传不生效，总是走完整分片上传。 可能原因：远端没有相同文件的完整 SHA1 摘要可命中。 解决办法：属正常情况，首次上传走分片是预期行为；重复同一文件时才会命中秒传。

获取方式

用 Docker 更新或拉取 V3 镜像jxxghp/moviepilot-v3；本地源码模式可直接：

git clone https://gitcode.com/gh_mirrors/mo/MoviePilot

升级后先做两件事：进存储配置重新扫码一次阿里云盘，再到媒体服务器设置里给飞牛影视点一次连接测试，确认 MoviePilot v2.3.6 的两块新能力都生效。

【免费下载链接】MoviePilotNAS媒体库自动化管理工具项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot