大家好,分享一个自己用AI写的飞牛 fnOS 应用:骏耀K歌,一套跑在 NAS 上的局域网 K 歌系统,不用额外买点歌机,手机扫码就能点歌,电视/投影仪全屏出画面。
首先叠个甲:我完全不懂编程,我只提要求,全部是AI做的!全部是AI做的!全部是AI做的!
我一直想找一款合适的K歌应用,无奈找不到合适的,论坛里也有人提过需求,一咬牙自己整~
开源地址:https://github.com/ma303973022/junyao-ktv
这是什么
把 NAS 变成一台家庭 KTV 点歌机:手机连上家里 WiFi,扫码打开点歌页面,点完歌电视/投影仪那边自动全屏播放 MV,走廊里放个平板当点歌台也行。曲库和数据统一存在 NAS 的共享目录里,不用来回倒腾硬盘。
主要功能
- 📱 手机扫码点歌:不用装 App,扫码即用
- 📺 电视端全屏播放:投影仪/电视浏览器打开即可,适合客厅大屏
- 🎤 原唱/伴唱一键切换:基于 HLS 多音轨实现,切换不卡顿、不重新加载、进度保留
- ⚡ 硬件转码优先:优先用核显 VAAPI 转码,没有的话自动回退软件编码,减轻 NAS CPU 压力
- 🎬 支持格式广:
.mp4 .mkv .avi .flv .mov .webm .mpg 都能直接入库播放
- 🧹 HLS 缓存自动清理:转码产物每天自动清理过期/**缓存,不会把硬盘越占越满
- 🔍 渐进式扫描/转码:曲库很大也不用等全部扫完才能点歌,边扫边转边播
- 🔐 曲库管理后台:增删改歌曲、密码保护,防止误操作
运行环境
- 飞牛 fnOS(Docker 应用形式)
- 支持架构:x86_64 / aarch64
- 建议 NAS 带核显(Intel 核显 VAAPI 硬解硬编效果最好),没有核显也能跑,走软件转码
安装方式
- 从 GitHub 拉取源码,或者直接去 Releases 页面下载已经打包好的
.fpk 安装包(当前最新 v1.0.8)
- 飞牛 fnOS 应用中心 → 手动安装 → 选择下载的
.fpk 文件,按提示安装即可
- 首次打开「曲库管理」时会要求设置一个管理密码,设置好之后就能开始导入 MV 曲库了
- 曲库目录、数据库都会落在应用的默认共享目录下,方便备份
- 曲库默认识别格式:“歌手 - 歌曲名.xxx",需要自己先把文件资源整理好哦
如果你想自己改代码、自己打包,仓库 README 里也写了怎么用飞牛官方的 fnpack 工具本地构建 .fpk,源码是全公开的。
v1.0.8 更新了什么
- 新增
.mpg 格式曲库支持,老 MV 曲库常见的 mpg 源文件现在也能直接入库播放
- 新增 HLS 转码缓存每日自动清理机制:曲库转码产物如果超过一定天数没再被点唱,会自动清掉释放空间;对应歌曲被删掉的**缓存也会一并清理,不影响原始 MV 文件,下次点唱会自动重新生成
更早版本的更新记录见仓库 README 和提交历史。
反馈 & 交流
用起来有问题、发现 bug、或者想要什么功能,欢迎直接去仓库提 Issue,或者在这个帖子下面留言,我看到可能大概也许改,主要看AI给不给力……
小声逼逼:本应用对1920*1080 240dpi和320dpi分辨率做过优化,因为我家电视是这个分辨率,其他的不确定,可能界面会乱……没有能力兼顾,希望有大神可以继续优化下去~~








