有没有不用收费，不需要VIP的影视APP？
一、背景：为什么需要它？
在我们之前的家庭AI节点规划中，影视资源的获取和管理一直是一个绕不开的问题。无论是本地NAS存储、网盘资源，还是在线直播，它们天然分散在不同的平台和应用里——想看电影要打开一个App，想看直播要切换到另一个，想听音乐还要再换一个。资源分散本身不是问题，但每次都要在不同平台之间来回切换，会直接影响使用体验。
于是我开始寻找一个能把它们统一管理起来的方案。OmniBox正是在这个背景下进入视野的。
二、OmniBox 是什么？
OmniBox 不是一个普通的播放器，而是一个 “以聚合为核心”的家庭影音中枢。它能把多源影视、网盘资源、电视直播、音乐统一整合到一个界面中，解决资源分散、查找困难的痛点。
核心能力一览：
- 多源影视聚合：通过爬虫脚本从多个采集站抓取影视资源
- 网盘资源直连：支持阿里云盘等8种主流网盘，无需转存即可播放
- 电视直播：支持m3u直播源和虎牙、斗鱼等平台直播间
- 无损音乐播放：支持FLAC、APE、WAV等无损格式，不进行二次压缩
- 多端播放：可无缝接入TVBox，在PC、手机、电视上观看
- 丰富元数据：接入TMDB API，展示海报、评分、演员信息等
三、为什么选择 OmniBox？
从Plex、Jellyfin到各类TVBox工具，家庭影音方案看似不少，但OmniBox从一众方案中脱颖而出，主要是因为它在“聚合”这件事上做得足够彻底。
🎯 解决“资源分散”的核心痛点
对于大部分家庭用户来说，影视资源通常散落在各处：本地NAS存了一部分，百度网盘、阿里云盘里还有不少，看直播要打开虎牙或B站，追剧又得在几个视频App之间来回切换。OmniBox的核心价值就在于，它能把多源影视、网盘资源、电视源、直播源全都整合到一个界面里。部署好之后，想找什么资源直接搜索就行，不用再在不同应用之间反复横跳。
✨ 一站式聚合体验，更接近主流流媒体
相比Plex、Jellyfin这类传统的影音库方案，OmniBox的优势在于“在线聚合”——不仅能播本地存储的影片，还能整合网盘资源和在线采集站。接入TMDB API后，播放页面能直接展示分季分集的海报、剧照、剧情简介、演员信息和评分。整个观影体验更接近主流流媒体平台，而不是一个简陋的文件浏览器。
🧩 低门槛、高灵活度
- 上手简单：相比Emby、TVBox等工具，OmniBox提供了更简单的上手路径，Docker一键部署即可。
- 爬虫灵活：后台可以用JS或Python按规范自建爬虫源，然后把多个爬源自由组合成订阅，涵盖了影视、动漫、听书、音乐、直播、短剧等8大品类。
💾 网盘直连，节省本地存储
在硬盘价格持续上涨的背景下，OmniBox支持网盘直连播放，无需下载、无需转存。通过302重定向技术，网盘里的资源可以直接在线播放，完全绕过本地存储。对于不想再给NAS添硬盘的用户来说，这一点非常实用。
📱 全平台无缝观看
服务部署好后，在手机、平板、电脑或电视的浏览器上都能直接访问。OmniBox的客户端也兼容TVBox、猫源、UZ、Emby等协议，在智能电视等大屏设备上使用也很方便。
🔒 私有化部署，数据自主可控
基于Docker部署在家庭NAS或服务器上，所有数据都掌握在自己手里，没有广告干扰，也不会被平台限制。配合cpolar这类内网穿透工具后，出门在外也能随时访问家里的资源。
四、Docker 部署
OmniBox 支持 Docker 一键部署，在飞牛OS上操作非常简单。
镜像版本选择
| 版本 | 镜像标签 | 说明 |
|---|---|---|
| 完整版 | lampon/omnibox:latest | 含 Node + Python + Playwright + Chromium，支持 JS/Python 爬虫、视频嗅探，体积较大 |
| 精简版 | lampon/omnibox:lite | 仅 Node 运行时，仅支持 JS 爬虫，体积更小 |
部署步骤（Docker Compose 方式）
- 创建项目文件夹
- 在 Docker → Compose → 新增项目中，粘贴以下代码：
services:
omnibox:
image: lampon/omnibox:latest
container_name: omnibox
restart: always
environment:
- TZ=Asia/Shanghai
ports:
- "7023:7023"
volumes:
- ./data:/app/data- 点击完成，等待构建完成
- 访问
http://飞牛IP:7023进入 OmniBox
数据迁移
如果之前已有 OmniBox 数据，可将旧容器的 data 文件夹挂载到新容器相同路径，重启后配置自动继承。
五、配置影视资源：爬虫模式
OmniBox 2.0 版本之后，不再内置影视站地址，而是通过爬虫脚本自行抓取数据。首次访问时首页空白，需要配置资源源。
配置步骤
- 访问
http://飞牛IP:7023/admin进入后台管理 - 点击左侧 「爬虫管理」
- 点击 「添加源」，输入名称后保存
- 在新建的源后面点击编辑按钮，将爬虫脚本代码粘贴进去
- 保存后，将该源设置为 「首页导航」
- 回到首页刷新，即可看到影视内容
爬虫脚本来源
- GitHub 仓库：
https://github.com/Silent1566/OmniBox-Spider - 一键导入：在爬虫管理中点击「Github导入」，填入仓库地址即可批量添加
- 网盘分享：社区也有打包好的脚本合集
依赖安装
导入脚本后如提示“Cannot find module ‘xxx’”，需进入容器安装对应依赖：
docker exec -it omnibox /bin/sh -c "npm install crypto-js cheerio axios moment qs"六、音乐与无损听感：不只是“能出声”
很多人把 OmniBox 当作影视聚合工具，但它对音乐的支持同样值得认真对待。
1. 不只是 MP3，无损格式也能播
在 OmniBox 后台配置好音乐爬源后，它支持MP3、FLAC、APE、WAV、ALAC（Apple无损）等多种音频格式的在线播放和浏览器下载。你收藏的高品质音乐，不需要额外转码就能直接播放。
对于追求音质的用户来说，OmniBox 的音乐模块提供了一条比主流流媒体更“干净”的路径：无需额外安装复杂的音乐服务器（如 Navidrome、Roon），它本身就能成为一个轻量级的无损音乐播放平台。
2. 从“听个响”到“听得进去”
在实际使用中，OmniBox 播放无损格式时会保持原始采样率、声道和量化位率连续播放，不进行二次压缩。你听到的声音是文件原本的样子，而不是被转码后的“缩水版”。
一个很直观的感受是：用 OmniBox 播 FLAC 格式的古典乐或现场录音，乐器的分离度和声场定位会比播 MP3 清晰得多——小提琴的擦弦质感、钢琴的泛音细节、人声的气息转换，这些在压缩格式中容易被模糊掉的信息，在无损播放时都能保留下来。
它可能不会像 Roon 那样提供华丽的元数据管理和多房间同步，但它做对了一件事：不添乱。它不会偷偷把 FLAC 转成 128kbps 的 MP3 让你听，也不会在播放过程中插入任何广告。
3. 两种玩法：在线听 vs 本地库
- 在线聚合播放：通过配置音乐爬源，直接在 OmniBox 界面中搜索和播放网络上的音乐资源，适合“想听什么随时搜”的场景。
- 本地无损库：配合 Sqmusic 等工具，将 FLAC、APE 等无损格式直接下载到 NAS 中，构建属于自己的本地音乐库。结合 NAS 的大容量存储和 OmniBox 的统一界面，相当于拥有了一个私有化的无损音乐服务器。
OmniBox 没有把音乐功能做成一个“赠品”——它和影视、直播一样，是可以通过爬虫自由组合订阅的核心模块之一。如果你对音质有要求，又不想在多个 App 之间切换，它确实提供了一个“一个界面搞定所有视听内容”的选项。
七、IPTV 与直播源
OmniBox 支持三种直播方式：
1. 添加 m3u 电视源
在后台「电视直播」菜单中直接填入 m3u 地址。
常用公共源示例（可能失效，需自行测试）：
https://188766.xyz/itvhttps://iptv-org.github.io/iptv/countries/cn.m3u
2. 自定义平台直播
选择平台（虎牙、斗鱼、B站等），填入直播间房间号即可观看。例如虎牙房间号 660101。
3. 自动聚合直播源
如需自动维护直播源，可部署独立的 IPTV 聚合工具（如 iptv-aggregator），生成的 m3u 地址再填入 OmniBox。
关于 IPTV 的一个坦白
上面三种方式都列出来了，但说实话，IPTV 部分是整个 OmniBox 方案里体验最不稳定的一环。需要坦诚地交代这一点。
如果你已经搜过相关内容，会发现网上公开的 m3u 源地址非常不稳定，快的几天一换，慢的也撑不过一两个月。自动聚合工具（比如我部署过的 iptv-aggregator）看似省心，实际上能抓到的有效频道并不多，而且大量源受地区限制，出了特定省份或特定运营商网络就无法播放。
最终我去看直播时，最稳妥的方式反而是直接用央视官网（tv.cctv.com/live）或者“学习强国”App——它们不会失效、不需要维护、画质稳定。OmniBox 的优势在于聚合，但直播源本身如果质量参差不齐，聚合再漂亮也只是“把一堆已经失效的东西放在一个好看的面板上”。
所以我对 OmniBox 的 IPTV 功能的态度是：可以作为备用方案，但不要把它当作主力直播工具。 如果你只是偶尔想看个新闻或体育直播，它或许够用。但如果直播是你的核心需求，你可能需要另外寻找更稳定的付费源或自己抓取家庭宽带附带的IPTV信号。这部分确实不是 OmniBox 的强项。
八、TVBox 对接
OmniBox 支持无缝接入 TVBox 等播放端。
获取订阅链接
在 OmniBox 管理界面右上角找到 「订阅」 按钮，点击获取 API 链接。
在 TVBox 中配置
将订阅链接填入 TVBox 的「配置地址」中即可。支持在 PC、手机、电视上随时观看。
注意：如果在 TVBox 中提示解析错误，可尝试使用反向代理或内网穿透来解决网络访问问题。若使用 Tailscale 地址，请确保 TVBox 所在设备也接入了 Tailscale 网络。
九、踩坑与提醒
1. 版本差异
OmniBox 2.0 版本后旧配置失效，需通过爬虫模式重新添加数据源。老版本用户如无特殊需求，可不更新。
2. 镜像选择
一般使用精简版即可满足需求；如需 Python 爬虫或视频嗅探，选完整版。
3. 爬虫可用性
部分爬虫脚本可能失效，需要定期更换或更新源。目前社区较为活跃的脚本仓库持续在更新，建议优先选择最近3个月内更新过的脚本。
4. 网络问题
TVBox 对接时如遇解析错误，可尝试反向代理解决。使用 Tailscale 地址时，需确保两端设备都在同一 Tailscale 网络中。
5. 多用户限制
OmniBox 不支持多用户设置，适合家庭内部使用，不适合多用户场景。
6. 依赖安装
导入爬虫后若提示缺少依赖，需进入容器内部安装：
docker exec -it omnibox /bin/sh -c "npm install 缺失的包名"十、总结
OmniBox 的核心价值在于 “聚合” ——把分散的影视站、网盘、直播源、无损音乐统一到一个界面中管理。搭配 IPTV 自动聚合和 TVBox 多端播放，可以构成一套完整的家庭影音方案。
虽然 2.0 版本后的爬虫配置比之前的一键导入稍复杂，但这也带来了更大的灵活性——你可以只选择几个体验好的源，而不是做“囤囤鼠”。对于想搭建私有化观影平台的家庭用户来说，OmniBox 是一个值得尝试的方案。
另外，还有一些诸如网盘资源对接，进阶玩法等内容，我没用过，就不写进来了
写在最后
写完这篇，我回头想了一下：我最初为什么要折腾 OmniBox？
答案其实很简单——老婆喜欢追剧，孩子要看动画片，用飞牛影视又太慢了。每次想看点东西，都得先想“我得去找一下”，花个一天两天的下载下来，有时候忙过头了，可能就遗忘了。
不是不能看，是又慢又麻烦。
所以当我把 OmniBox 跑起来之后，老婆问了一句：“以后是不是只要打开这个就行了？”
我说差不多。
她说：“那可以。”
这个“可以”不是对技术的认可，是作为家庭成员，她感觉“这件事真的解决了问题”。
OmniBox 的技术其实并不复杂——把爬虫脚本导进去，把网盘挂上去，把直播源加进去——但它解决了一个真实存在的问题。它把分散的影视资源重新聚在了一起，让“找片子”这件事从一个分散的体力活，变成了一个统一的搜索动作。
这就是我写这篇文章的原因。不是介绍一个工具，而是记录一个想法如何从需求出发，落地成一套能用的方案，最终解决了具体的问题。
如果你也在为资源分散发愁，希望这些内容能给你提供一些参考。从一台NAS、一行 Docker 命令开始，把散落各处的视听内容重新聚到一起——这件事，可能没有你想的那么复杂。
欢迎非商业转载，但请务必保留原文链接及作者信息。