VidHub 文件源是什么 理解"文件源"概念

什么是文件源

文件源 = VidHub 从哪里找视频文件的目录。

VidHub 不复制你的视频文件，不占用存储空间——它只是"记住"你告诉它的那些文件夹位置，然后扫描里面的视频文件、刮削海报和信息、整理成媒体库展示。

一个文件源可以是：本地文件夹、iCloud 云盘上的目录、阿里云盘/百度网盘的某个文件夹、通过 SMB 访问的 NAS 目录、通过 WebDAV 访问的路由器存储、甚至是 Alist 的某个挂载路径。

文件源 vs 媒体库

这是 VidHub 中最容易混淆的两个概念：

简单说：文件源是"原料"，媒体库是"成品"。你不需要手动往媒体库里拖东西——添加完文件源，媒体库自动冒出来。

为什么要理解文件源

VidHub 的使用体验好不好，90% 取决于文件源接得好不好：

• 文件夹结构乱 → 刮削不准 → 海报墙惨不忍睹
• 文件名不规范 → 刮削失败 → 全是"其他"分类
• 云盘连接不稳定 → 播放卡顿甚至打不开
• 忘了加某个文件夹 → 里面的视频永远不会出现在媒体库里

花时间把文件源规划好，是最高性价比的投入。

文件源的类型

VidHub 支持的文件源可以归为四类：

第一类：本地类

• 设备本地文件夹
• iCloud 云盘文件夹（苹果设备直接从系统 iCloud 读取）
• Android 内置存储

特点：速度最快、不需要网络、不消耗流量。如果视频文件在本地，优先用这一类。

第二类：云盘类

• 阿里云盘、百度网盘、OneDrive、Dropbox、Google Drive、Premiumize
• 115 云盘（通过 Alist 挂载）
• 移动云盘等

特点：需要在线播放或下载后离线播放、依赖云盘客户端授权登录。添加时会跳转到云盘网页进行 OAuth 授权，授权成功后 VidHub 就能访问该云盘的文件列表。

第三类：网络协议类

• SMB/CIFS（最通用，群晖/威联通/路由器都支持）
• WebDAV（HTTP 协议的网络存储访问，部分云盘和 NAS 支持）

特点：适用于局域网或公网 IP/域名访问的 NAS 和路由器。需要知道服务器地址、端口、用户名、密码。

第四类：影视服务器类

• Plex、Emby、Jellyfin、Alist、KinoFlow
• 厂商自建影视库：极空间、绿联云、飞牛、群晖 DSM 影视

特点：影视服务器自己已经做了刮削和整理——VidHub 直连后直接拿到海报墙，不需要二次刮削，体验最好。

常见问题

我把视频直接放在视频 app 里不行吗？

不行。VidHub 不会自动扫描整个设备存储，必须显式添加文件夹作为文件源。这是出于隐私和性能考虑——VidHub 不想扫描你所有的文件。

一个文件夹里只有一个视频，可以单独做文件源吗？

可以，但推荐按"一个文件源 = 一个有意义的分类文件夹"来规划。比如"电影收藏"、"电视剧-2024"这样，便于管理。

可以添加多个文件源到同一个媒体库吗？

当然。媒体库自动汇总所有已启用文件源的视频，去重后按电影/电视剧/其他分类展示。