Jellyfin 与 Emby 兼容接口
为每个媒体库提供独立访问地址和账号体系，让兼容播放器可以像连接媒体服务器一样浏览、搜索、查看详情、进入剧集并发起播放。
当前覆盖常用浏览与播放流程；不等同于完整的 Jellyfin 或 Emby Server，也不提供转码。
Docker / NAS
Fly云助手
FlyCloudHelper
把网盘，变成播放器可直接连接的媒体库。
把网盘整理成 Jellyfin、Emby、Navidrome / Subsonic 播放器可直接连接的个人媒体库。
连接自己的网盘服务，在 NAS 上完成影视或音乐扫描、元数据整理与目录持久化，并通过 Jellyfin、Emby、Navidrome / Subsonic 兼容接口提供给播放器直接浏览和播放。
ABOUT FLYCLOUDHELPER
让网盘，成为播放器可直接连接的媒体库。
Fly云助手是可部署在 NAS 或服务器中的网盘媒体协议与目录服务。它连接用户创建的网盘服务，完成影视或音乐扫描、元数据整理和媒体目录持久化，再以 Jellyfin、Emby、Navidrome / Subsonic 兼容接口把整理后的媒体库直接交给播放器使用。
FEATURES
让媒体整理成为常驻能力
Navidrome / Subsonic 音乐协议
为音乐媒体库提供 Navidrome / Subsonic 兼容地址，支持账号校验、歌曲播放、封面、歌词、搜索、收藏与播放列表，让音乐播放器也能直接使用网盘音乐库。
仅适用于音乐类型服务；音频保持原始播放，不提供转码。连接常用网盘服务
首批支持 WebDAV、光鸭、阿里云盘与百度网盘，并按服务分别保存扫描目录和配置。
网盘连接信息由 Fly云助手凭据库加密保存，仅供扫描任务使用。云端扫描与 TMDB 刮削
识别电影与节目，获取海报、标题、年份等元数据，把原始文件整理成可浏览的影视目录。
TMDB Key 由部署者在管理后台配置。任务进度与断点继续
查看当前路径和扫描进度，支持暂停、继续、终止、删除及失败重试。
WebDAV 扫描任务支持检查点恢复。多用户与多服务隔离
一个实例可以服务多个用户，每位用户可以创建多个相互独立的云端服务和媒体库。
服务、任务和媒体目录直接按用户归属。直连优先，也可选择中转播放
播放器可获取网盘临时直链；当来源需要保留访问头或无法直连时，也可按服务设置由云助手进行字节流中转，并保留 Range 请求。
中转播放会占用部署设备的上下行带宽；云助手只转发字节流，不转码也不缓存影片正文。多播放器与多账号各自独立
同一媒体库可按协议创建多个访问账号；会话、最近播放、观看进度、已播放状态和收藏都分别保存。
Flymby 已完成适配；其他播放器需具备对应 Jellyfin 或 Emby 协议兼容能力。READY FOR PLAYERS
网盘服务，不必只能在原始 App 里播放。
完成扫描与整理后，Fly云助手把网盘目录转换为播放器熟悉的媒体库接口。视频可在兼容客户端中看到海报、详情、剧集、搜索和继续观看；音乐也可通过常用的 Subsonic 协议客户端直接访问。
接入 Jellyfin 播放器
支持账号登录、媒体库浏览、搜索、详情、季集、图片、播放定位、直连或中转播放，以及观看状态上报。
接入 Emby 播放器
支持独立 Emby 账号与会话，并覆盖常用媒体库浏览、海报、详情、剧集、播放与观看状态流程。
接入音乐播放器
面向音乐库提供账号校验、歌曲流、封面、歌词、搜索、收藏和播放列表，可接入兼容 Navidrome / Subsonic 的客户端。
HOW IT WORKS
部署一次，让网盘成为媒体库。
Fly云助手把网盘扫描、影视整理和协议兼容放到常驻设备中，播放器只需连接媒体库地址，就能读取已经整理好的内容。
- 01
部署服务
在支持 Docker 的 NAS 或服务器上启动 Fly云助手，并持久化 /data 数据目录。
- 02
创建服务
登录 Web 管理端或 Flymby，添加网盘连接、扫描路径与影视刮削配置。
- 03
云端整理
扫描 Worker 持续完成文件发现、影视识别、元数据匹配和媒体目录入库。
- 04
交给播放器
在 Jellyfin、Emby、Navidrome / Subsonic 等兼容播放器中添加媒体库地址，直接浏览和播放已经整理好的网盘内容。
MEDIA CATALOG
扫描结果，也可以清晰浏览。
管理端提供个人、全局和单服务媒体海报墙，可按匹配状态筛选内容，并处理需要人工确认的条目。
SELF-HOSTED
为 NAS 与家庭服务器准备。
官方 Docker 镜像同时提供 amd64 与 arm64 架构。默认使用内置 SQLite，也可以连接已有 PostgreSQL 或 MySQL；API、Web 管理端和扫描 Worker 由同一服务提供。
- 部署方式
- Docker / Docker Compose
- 支持架构
- linux/amd64、linux/arm64
- 默认端口
- 9934
- 数据库
- SQLite、PostgreSQL、MySQL
- 数据持久化
- /data 数据卷
FAQ
常见问题
Fly云助手会保存我的媒体文件吗？
不会。它保存服务配置、扫描任务、元数据和媒体目录，不存储媒体文件，也不进行转码。按服务设置开启中转播放时，只会转发当前播放所需的字节流。
必须安装外部数据库吗？
不需要。默认使用 SQLite；需要独立数据库时，可以改用 PostgreSQL 或 MySQL。
当前支持音乐和有声书扫描吗？
音乐服务可进行扫描与元数据整理，并通过 Navidrome / Subsonic 兼容地址提供歌曲、封面、歌词、搜索、收藏和播放列表能力；有声书仍处于扩展阶段，尚未作为独立可用功能开放。
可以使用 Jellyfin 或 Emby 客户端吗？
可以。Fly云助手为媒体库提供 Jellyfin 与 Emby 兼容接口，可在支持相应协议的播放器中添加访问地址与账号。当前以常用浏览和播放流程为目标，不承诺覆盖完整服务端的全部插件或扩展能力。