前言

在当前流媒体平台高度分散的背景下，影视、直播、音乐等内容被分割在不同的应用程序中，用户常常需要在多个平台间频繁切换，不仅操作繁琐，还受制于会员限制和设备生态的约束。是否存在一种方法，能够将所有资源统一整合，实现“一个后台，跨端畅享”？这正是 OmniBox 的核心理念。

OmniBox 2.0 是一款面向进阶用户设计的一站式资源聚合平台，通过自建爬虫源与订阅机制，将分散的影视、直播、音乐等内容进行集中管理。你可以使用 JavaScript 或 Python 按照规范开发专属资源源，将多个数据源自由组合成订阅，并在网页端、手机、电视等不同设备上无缝访问，真正实现跨平台、多终端的一体化体验。

此外，OmniBox 还兼容多种主流播放协议与生态，如 TVBox、猫源、Emby 等，让你能根据个人习惯选择客户端，无论是安卓手机、Android TV，还是 iOS、macOS、Apple TV，都能轻松接入。同时，它还支持电视直播源与多平台直播间接入，进一步拓宽娱乐边界。

本教程将指导你基于 VPS 或飞牛 NAS，通过 Docker 一键部署最新版 OmniBox 2.0，涵盖环境搭建、爬虫源配置、多端接入与使用等环节，手把手教你打造专属的全平台影视资源中心，实现“一个后台，全盘搞定”的目标。

视频教程

B站

YouTube

核心功能

自建爬虫源 · 订阅组合

使用 JavaScript 或 Python 按照 OmniBox 规范开发一套爬虫源，即可接入你的自有数据源或站点。
在管理后台中，你可以选择性地将多个爬虫源组合成一个订阅，一份订阅可在多个客户端间共享。
支持采集站资源、网盘资源、视频网站解析等，一次配置即可在多端观看。

全平台客户端

覆盖网页端和 App 端：安卓手机、Android TV、iOS、macOS、Apple TV 等。
只要客户端支持 TVBox、猫源、UZ、Emby 等协议，即可添加订阅地址，实现全平台观影。

直播资源

电视直播：添加电视直播源，直接观看直播频道。
直播间：支持添加六大平台直播间，在客户端内观看直播。

其他体验

在线浏览、历史播放记录、跳过片头片尾、AI刮削、匹配弹幕等。

Docker Hub 提供完整版与精简版镜像，开箱即用。

有关截图

首页

影视站

电视直播

儿歌专区

音乐

短剧

教育

小结

该项目与之前分享的 moontv、libreTV 和 KatelyaTV 类似，都属于空壳应用。
它需要配置后台接口，包括影视接口、直播接口、弹幕接口和 TMDB，还需配合 pansou 项目才能正常使用。本教程分享的是 OmniBox 2.0 的最新版本。
新版本增加了爬虫管理功能，配置起来相对简单，但可能仍存在一些不完善之处或 bug。如果你想体验 1 版本，可以参考我之前的教程。

部署方法

使用Docker安装

本教程采用 Docker 方式进行安装部署，操作简单便捷。

准备条件

1）一台服务器

我们将使用莱卡云 VPS 和飞牛云 NAS 进行演示。

如果需要 VPS，可以参考以下资源占用情况。
莱卡云官网

本期 Docker 容器的资源占用情况如下（仅供参考），不到 200M。

2）本项目使用到的项目

本教程使用的官方 Docker Hub 地址。
https://hub.docker.com/r/lampon/omnibox
omnibox官网
本教程演示的是最简单的 SQLite 版本，其他数据库版本请自行访问官网了解更多功能。

类型	说明	默认
SQLite	单文件数据库，零配置，适合个人或小规模使用	✅ 默认
MySQL	需自建 MySQL 服务，适合多实例或已有 MySQL 的环境	—
PostgreSQL	需自建 PostgreSQL 服务，适合多实例或已有 PG 的环境	—

3）接口

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

如果无法访问 GitHub，可以直接将接口文件下载到本地。

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

4）域名(可选)

根据个人需求决定。

① VPS部署

一、Docker环境部署

在 VPS 上安装 Docker 和 Docker-Compose。
Docker 官方安装文档（英文）。
https://duan.yyzq.eu.org/docker-001
Docker-Compose 官方安装文档（英文）。
https://duan.yyzq.eu.org/docker-002
Centos 安装 Docker 和 Docker-compose（中文）。
https://duan.yyzq.eu.org//03
Ubuntu 安装 Docker 和 Docker-compose（中文）。
https://duan.yyzq.eu.org//04

推荐直接使用一键脚本。

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

二、部署命令

登录服务器，使用 root 账户执行以下步骤。

2.1docker run命令

docker run -d 
  --name omnibox 
  --restart always 
  -e TZ=Asia/Shanghai 
  -p 7023:7023 
  -v $(pwd)/omnibox/data:/app/data 
  --network media-net 
  lampon/omnibox:latest

2.2docker-compose命令

mkdir  omnibox ;cd omnibox

然后新建 docker-compose.yml 文件。

vim docker-compose.yml

services:
  omnibox:
    image: lampon/omnibox:latest  # 使用最新的 Omnibox 镜像
    container_name: omnibox  # 容器名称为 omnibox
    restart: always  # 容器自动重启策略设置为总是重启
    environment:
      - TZ=Asia/Shanghai  # 设置时区为上海
    ports:
      - "7023:7023"  # 映射本地端口 7023 到容器的 7023 端口
    volumes:
      - ./omnibox/data:/app/data  # 将本地的 ./omnibox/data 目录挂载到容器的 /app/data 目录
    networks:
      - media-net  # 使用内部网络 media-net 进行通信
networks:
  media-net:
    driver: bridge  # 使用默认的桥接网络驱动

三、执行容器运行命令

docker-compose up -d #运行容器

docker-compose ps  #查看是否启动成功

正常启动后的效果如下所示。

docker-compose ps
NAME      IMAGE                   COMMAND    SERVICE   CREATED          STATUS          PORTS
omnibox   lampon/omnibox:latest   "./main"   omnibox   17 minutes ago   Up 17 minutes   0.0.0.0:7023->7023/tcp, [::]:7023->7023/tcp