项目介绍
OmniBox 把多类媒体来源放在统一入口中,适合整理已有服务与资源。实际支持的播放、刮削和客户端能力取决于所用版本,不把来源文章的宣传描述当作全部已具备的功能。
OmniBox 的资料涉及多种来源与播放入口,部署时应把来源配置、搜索结果和实际播放分别测试。不同版本是否支持本地库、网盘接入或元数据处理,需要按当前项目说明确认,不能把它直接当作已有媒体服务器的完整替代。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 来源接入 | 配置实际可访问入口 |
| 统一检索 | 寻找对应条目 |
| 媒体详情 | 核对海报与简介 |
| 播放检查 | 测试实际地址 |
| 分类组织 | 按内容用途整理 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 配置指南 |
| 分类 | 影音与下载 |
| 整理日期 | 2026-11-14 |
安装或使用条件
先确认所用项目版本、操作系统与依赖,准备独立测试目录及可恢复的数据副本。本文中的操作流程需与对应版本的官方说明配合使用。
安装与使用步骤
- 先核对发行版本的正式说明,列出需要接入的本地目录、网盘或外部接口。只配置一类测试来源,避免同时排查多个系统。
- 检查检索、详情、封面与播放链路,确认实际可访问的上游地址与授权。需要登录的信息单独保存在后台。
- 为内容建立合理分类与命名规则,确认重启后配置保留;再逐步增加其他来源,记录失败接口与原因。
按来源逐项验证
先只接入一个自己有权使用的测试来源,检查搜索、详情和播放三个环节;这一条链路正常后,再添加其他来源。记录来源地址、更新时间与所需凭据,避免一次导入大量陌生接口后无法定位故障。
搜索能返回记录但不能播放时,分别检查链接是否过期、网络能否到达资源、播放器是否支持对应格式,以及访问是否需要登录。封面或说明缺失属于元数据链路,不要通过反复重装播放器解决。移动端与电视端另做一次访问测试,备份保留来源与用户设置,不只保留容器定义。
首次使用与操作检查
添加一类测试来源,分别检查搜索、详情和播放,重启后核对配置。
参数以实际发行版为准。账号信息不进入公开页面,不能按原文宣传推断全部能力。
配置与常见问题
- 媒体聚合工具不提供所有内容,第三方接口失效时应单独处理,不通过不断换来源掩盖问题。
更新与备份
保存配置、分类与媒体元数据,原始媒体与网盘凭据分别管理。