连接常用网盘服务
首批支持 WebDAV、光鸭、阿里云盘与百度网盘，并按服务分别保存扫描目录和配置。
网盘连接信息由 Fly云助手凭据库加密保存，仅供扫描任务使用。
Docker / NAS
Fly云助手
FlyCloudHelper
把网盘扫描与媒体整理，交给自己的 NAS。
把网盘扫描与刮削交给 NAS，让多台设备共享同一份媒体目录。
连接自己的网盘服务，在常驻设备上完成影视扫描、TMDB 刮削与目录持久化，再由 Flymby 读取已经整理好的媒体结果。
ABOUT FLYCLOUDHELPER
让扫描与整理留在自己的设备上。
Fly云助手是面向 Flymby 客户端的自部署云端媒体扫描、刮削和目录服务。它运行在 NAS 或服务器中，负责连接用户创建的网盘服务、识别影视文件、获取元数据并保存媒体目录，让多台设备读取同一份整理结果。
FEATURES
让媒体整理成为常驻能力
云端扫描与 TMDB 刮削
识别电影与节目，获取海报、标题、年份等元数据，把原始文件整理成可浏览的影视目录。
TMDB Key 由部署者在管理后台配置。任务进度与断点继续
查看当前路径和扫描进度，支持暂停、继续、终止、删除及失败重试。
WebDAV 扫描任务支持检查点恢复。多用户与多服务隔离
一个实例可以服务多个用户，每位用户可以创建多个相互独立的云端服务和媒体库。
服务、任务和媒体目录直接按用户归属。Web 管理与媒体海报墙
通过浏览器管理用户、服务、任务和系统配置，也可以浏览已入库内容并进行手动匹配。
Web 管理端用于目录管理，不提供在线播放。为 Flymby 提供目录结果
Flymby 登录云助手后，可以选择自己的云端服务并读取已经完成扫描和刮削的媒体目录。
新设备仍需完成对应网盘的本地播放授权。HOW IT WORKS
部署一次，让整理持续发生。
Fly云助手把原本依赖单台客户端完成的扫描工作放到常驻服务中，设备只需读取已经整理好的目录结果。
- 01
部署服务
在支持 Docker 的 NAS 或服务器上启动 Fly云助手，并持久化 /data 数据目录。
- 02
创建服务
登录 Web 管理端或 Flymby，添加网盘连接、扫描路径与影视刮削配置。
- 03
云端整理
扫描 Worker 持续完成文件发现、影视识别、元数据匹配和媒体目录入库。
- 04
多端读取
不同 Flymby 设备登录同一账号，选择同一服务即可读取共享的扫描结果。
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。
当前支持音乐和有声书扫描吗？
当前版本只开放影视扫描与刮削。音乐和有声书只保留数据模型与扩展接口，尚未作为可用功能开放。
为什么新设备仍然需要网盘授权？
Fly云助手不会把服务端保存的网盘凭据下发给客户端。新设备可以浏览云端目录，但播放前仍需在本机完成对应网盘授权。