飞牛 fnOS 影视库搭建

更新于 2026 年 8 月 31 日 · 适用于 HarmonyOS 6.0 及以上

新装机的时间窗：先把目录定下来

fnOS 的用户群有个和别家不太一样的特点：很多人是刚装机、正在往里迁数据。这是个稍纵即逝的好时机——片库还没堆到几百上千个文件，现在花二十分钟把目录规划好，比日后回头重命名一整个片库划算得多。

刮削这件事背后是两层分工，理解了这两层就知道该在哪儿花力气：目录结构决定「哪些文件该入库、谁是正片、哪几个文件互为版本」；文件名决定「这片子叫什么、第几季第几集」。也就是说，目录负责划分边界，文件名负责提供身份。一份能被稳定识别的片库长这样：

影视/
  电影/
    让子弹飞 (2010)/
      让子弹飞.2010.1080p.BluRay.x264.mkv
      让子弹飞.2010.chs.srt
    沙丘 (2021)/
      Dune.2021.2160p.UHD.BluRay.Remux.mkv
      Dune.2021.1080p.BluRay.x265.mkv
    蜘蛛侠 6部合集/
      蜘蛛侠1.mkv
      蜘蛛侠2.mkv
  剧集/
    三体 (2023)/
      Season 01/
        S01E01.mkv
        S01E02.mkv
      Season 02/
        S02E01.mkv

三点解释一下为什么这么摆。一部电影一个目录：同目录下的多个文件会被当成同一部片的不同版本（上面《沙丘》那两个就是），展示层只出一条主版本、取体积最大的那份，其余收进详情页的版本菜单——这正是你想要的。剧集按季分子目录：季集号主要从文件名里的 S01E02 解析，季目录名是个有力的旁证。目录名带年份：电影文件名里的年份就是上映年，对匹配帮助很大。

反过来说，这套结构不是硬性要求。杂乱的下载目录一样能扫，只是识别率会低一些。已经堆了几百个文件的话，别为了刮削去做一次大规模重命名，先扫一遍看看哪些没认出来，再针对性地改那几个——性价比高得多。完整的命名规范见电影刮削完全指南。

fnOS 侧：开一个 SMB 共享

在 fnOS 的设置里找到文件服务相关的分组，开启 SMB，然后给存影视的那个共享目录配上账号权限。建议专门建一个只读账号给播放器用：播放本来就不需要写权限，只读还能防住手机端误删。

这里不写死菜单路径——fnOS 迭代节奏快，版本之间的菜单名和层级都可能变，照着旧截图找容易扑空。在设置里搜「SMB」或「共享」，或者直接查飞牛官方帮助文档，是更可靠的做法。

另外记下两样东西：fnOS 在局域网里的 IP 地址，和那个共享目录的共享名。共享名不是它在硬盘上的完整路径，而是这个共享对外暴露的名字，下一步填地址时要用。

手机侧：三十秒加完源

「文件」页右上角点 ＋ 添加源，第一级选局域网与 NAS，第二级选 SMB。这一类顶栏有一颗扫描局域网按钮，点一下，同网段里正在跑的 SMB、NFS、WebDAV、FTP、SFTP、DLNA 服务会列在「发现的设备（点击填充）」下，点中一条就自动把地址填好，不用手打 IP。

手动填的话格式是 smb://192.168.1.5/video，末尾那段是共享名。漏掉共享名是头号连不上原因：只填到 IP 等于只说了去哪台机器，没说去哪个共享。填完用户名密码点测试并保存，它会先真连一次再存，配错了当场就知道。

如果你在 fnOS 上跑了 Emby 或 Jellyfin，也可以直接选媒体服务器那一类接进来，地址填 http://192.168.1.5:8096，元数据由服务端提供。两条路的取舍见群晖手机看电影用什么 App里那张对照表——原理与品牌无关，那篇写得最全。

纳入媒体库：海报是这一步来的

源加好之后不会自动扫描，这一步要你自己指定收录哪个目录：点进这个源，浏览到 影视/（或者分别对 电影/ 和 剧集/ 各做一次），点顶栏的纳入媒体库。按目录粒度收录是刻意设计——整盘扫会把备份、相册、Docker 目录一起卷进来。想撤销就长按同一颗按钮，选「将此目录移出媒体库（不删除文件）」，文件不会被动。

扫描之前记得先去设置 → 元数据与刮削配好数据源：「优先使用」里 TMDB 与 OMDb 二选一（两家都配就互为兜底），元数据语言默认 zh-CN。没配的话扫描只按文件名入库，有条目但没有海报——这是「扫完了怎么一张海报都没有」最常见的答案。OMDb 只有英文数据，且免费 key 每天 1000 次请求，扫大库容易打满，中文片库建议以 TMDB 为主。

扫完就有海报墙了：电影按片名年份归位，剧集按季分集，TMDB 的官方电影系列（比如「哈利·波特系列」）还会在合集页里自动归组。这份库存在手机本地的数据库里，不会往 fnOS 上写任何文件——不生成 .nfo、不生成 poster.jpg，NAS 那边保持原样。

刮削不准时，先看是哪一类问题

识别失败分两种，处理方式完全不同。结构类问题（该入库的没进来、不该入库的进来了）改目录；身份类问题（认成了别的片、季集号不对）改文件名，或者直接手动纠正。

手动纠正的入口容易找错：在媒体库页长按海报卡片，菜单里选「重新匹配元数据…」，输入正确片名搜索，选中候选就改过来了。注意是媒体库页长按卡片，不在详情页里。同一个菜单里还有「标记为已看/未看」和「加入合集…」。

常见问题

一部剧裂成了两张卡片

典型症状是二十多集的剧被拆成「大部分集」加「零星两集」。原因是剧集分组认的是条目 id 而不是剧名：部分集刮到了 id、部分没刮到时，没 id 的那几集会另起一张卡。对这部剧重新刮削一次通常能合回去（设置 → 元数据与刮削页最下方有重新刮削媒体库）。

某几集被刮成了幕后纪录片

这是个很隐蔽的坑，值得知道原理：剧集文件名里的年份是这一季的播出年，而元数据库按首播年索引。拿第二季的年份去做精确过滤，正剧本身第一个就被排除掉了，剩下的全是那一年首播的同名衍生剧——而热门 IP 下同名前缀的衍生剧成堆。真实案例是《曼达洛人》里唯二文件名带 2020 的两集，被刮成了 2020 年首播的幕后纪录剧集《Disney Gallery: Star Wars: The Mandalorian》。应用侧已经用「带年份、不带年份两路各算分再比」兜住了这个问题，但如果你在别处遇到类似现象，知道根因在哪会省很多事。电影侧不存在这个问题，电影文件名里的年份就是上映年，很有用。

合集目录里的片被认成了完全无关的电影

像 蜘蛛侠 8部合集/英雄归来 这种，单独拿「英雄归来」去搜会命中 2018 年的法国片《英雄归来》，「蜘蛛1」会命中 1919 年的德国默片《蜘蛛》。麻烦在于这是假阳性而不是搜不到，「搜不到再降级」的兜底逻辑根本轮不上。做法是从目录名里认出「N部曲 / N部合集 /【N部】」这类标记，取出系列名再和文件名拼起来搜。所以合集目录名里保留「N部合集」字样是有用的，别把它删干净。

花絮、样片也被扫进来了吗

基本不会。判据是时长而不是目录名黑名单：「这棵子树里最长的片子还不到同一部作品正片时长的四分之一」就判为附属目录（花絮、样片、菜单片段）。这比维护一张目录名清单可靠得多——发布组起的名字千奇百怪（Sample、Screens、External AC3、中文的「奥斯卡获奖动画长片」），名单永远追不上。另外时长不足六分钟的视频一律不进媒体库，但在「文件」页里仍然可见可播。

fnOS 上还要不要装它自带的影视应用

看人。多人共用一份片库、想要一份大家共享的观看进度，服务端方案更合适；就自己看、主要在手机平板上看，客户端直连更省事，NAS 上少一个要维护的服务。两者并存也完全没问题，客户端这边只读文件，不碰对方的库。

4K 原盘卡顿

按顺序查：网络带宽（4K Remux 常见 80Mbps 以上）、编码能否被设备硬解、NAS 读取速度。直连不转码，fnOS 的 CPU 不是瓶颈。详细的码率与带宽对照见威联通手机播放 4K 原盘。另外如实说一句：当前版本不做 HDR 送显，HDR 片源能播但以 SDR 呈现，这一项还在验证中。