一、前言
大家好，我是攻城狮阿程。之前写过一篇Pansou容器相关的文章，但是Pansou本身只能找到资源并转存后用NAS自带播放器播放，没法直接播放，于是带着问题发现了一款可以引入Pansou资源引擎的家庭影视综艺资源容器——OmniBox，本来是打算写一个简单科普分享类的文章，但是边测试边写的过程中发现这个平台能配置的内容还蛮多，比之前的Mooncake和LibreTV都要多，于是写成了一个大综合……
码字不易，喜欢我的教程欢迎各位多提建议多评论，畅所欲言，涉及破解、打倒美帝走近科学和资源分享的教程容易被和谐，也欢迎各位关注我的公众号和博客，以防走丢。
公众号：攻城狮阿程
知乎：攻城狮阿程
小红书：南星北月
个人博客：strider1230.cn
淘宝：阿程数码
抖音：南星北月
B站：-南星北月-
1.1 软件介绍
OmniBox 是一个功能强大的影视综合站，解决了资源分散、查找困难的问题，为影视爱好者提供一站式的观影解决方案。它整合了常见的采集站、网盘资源、IPTV 直播源、各大直播平台等，无论您是付费会员、还是习惯于搜索免费资源，它都能满足您的需求。
1.2 软件特点
OmniBox 主要有以下 7 个特色：
多源聚合：支持采集站、网盘资源在线观看
IPTV 支持：支持
IPTV源观看，不错过电视直播直播集成：支持
6大主流直播平台的同步观看全能解析：支持解析各大主流视频站的链接
跨平台观看：提供网页、移动端、
TV端等多种观看方式弹幕互动：所有客户端均支持弹幕功能，增加观影乐趣
高清画质：支持在线观看
4K超高清视频
1.3 适用人群
厌倦了在不同视频 App 之间切换，或者受不了网上免费影视站的广告和不稳定性，又或者觉得 Emby、TVBox 等工具配置复杂
对资源质量要求不高，不刻意追求4K、杜比、蓝光，有的看就行
1.4 支持的网盘类型
1.5 部署容器前你可能需要一块固态硬盘
我教程内展示的容器都是配置在固态硬盘上的，建议想多搭容器及虚拟机的朋友在执行教程前先准备一块固态硬盘，容器、虚拟机安装在固态硬盘的好处如下：
不会干扰机械硬盘的休眠，使得机械硬盘始终扮演数据保存的角色
部署在固态硬盘内的容器、虚拟机调用以及响应的速度都比机械硬盘好
容器若发生泄漏，不会污染、破坏你的机械硬盘内的数据
1.6 M.2接口 SSD 固态硬盘的适配
以极空间为例，Z4系列的M.2接口支持高速存储、只读缓存等功能，如果是在固态硬盘内部署虚拟机、容器服务等，需要选择高速存储功能；
仅支持M.2接口 NVMe 2280 的SSD固态硬盘，其中
2280指的是长度；官方说由于PCIe4.0自身的兼容性问题，极空间暂时不支持PCIe4.0的SSD，但是实验下来是支持PCIe4.0的固态的，只是安装上去以后该固态硬盘的温度会比PCIe3.0的固态硬盘高10℃左右，
因此买的时候要还是建议选择PCIe3.0的SSD，但由于PCIe3.0的固态硬盘几乎均已停产，所以还是老老实实去买PCIe4.0的固态硬盘吧；设置只读缓存时，Z4系列8G-16G内存的产品建议选购256G容量；16G及以上内存的产品建议选购512G容量；（PS：极空间Z4Pro 是支持单根 DDR5 64G 4800MHz的笔记本电脑内存哦）
设置高速存储时，SSD不得小于32GB，最大支持4T；
建议选购大品牌的SSD，
这里推荐：梵想或者致钛TiPlus7000 1TB/2TB，京东和淘宝上都有货源，鉴于目前存储类产品离谱的溢价，除非是刚性需要，否则不建议在2025年12月-2027年9月初期间购置任何存储类产品。
* 请选择耐用 SSD。由于 SSD 的寿命受限于有限的写入次数，请确保使用耐用性更高的 SSD，以防止潜在风险。
1.7 应用截图
二、部署 OmniBox 容器
官方推荐使用 docker-compose 进行安装。因此我以极空间 NAS 为例部署。推荐使用 docker-compose 进行安装。
2.1 部署前的准备
先准备好域名，阿程这里用 CloudFlare 做反代处理。
其中：
192.168.31.194为极空间NAS的IP；7023是准备分配给OmniBox的端口；
2.2 Docker-Compose 方式部署
1️⃣ 打开极空间 Docker 程序界面，可以看到左侧边栏 Compose 选项卡。
2️⃣ 在 Docker-Compose 界面点击新增项目按钮。
3️⃣ 在项目名称处填写容器应用名，将下方我配好的 Compose 代码复制黏贴进下图对应位置，勾选创建项目后立即启动，最后点击创建按钮完成配置，耐心等待容器镜像拉取即可。
截图内参数如下：
services:
omnibox:
image: lampon/omnibox:latest
container_name: omnibox
restart: unless-stopped
ports:
- "7023:7023"
volumes:
- 你的磁盘路径/data/Docker/omnibox/data:/app/data三、 程序测试
3.1 测试登录程序
在浏览器中输入反代的域名，例如： https://omnibox.alibb.com 就能看到登录界面。
随便搜一搜，你会发现你什么都搜不到，这是因为本质上OmniBox只是个平台，还需要我们设置资源订阅链接。
3.2 测试通过极空间自带的远程登录功能进行访问
使用极空间远程访问功能测试可以打开和搜索。
四、OmniBox 的使用
4.1 导入影视站资源订阅链接
1️⃣ 影视站默认打开是空的，如下图所示，因此需要我们导入影视站的资源订阅链接。
2️⃣ 在微信公众号后台回复 omnibox，获取最新的采集站资源订阅文件的下载链接（目前最新版本为 sites_export_2025-11-08.txt）。（自动回复有效期2025.12.10-2026.03.10）
3️⃣ 进入 我的 –> 管理 –> 影视站资源 –> 导入/导出，将刚刚下载的资源导入，并看到提示导入了XX个站点。
4️⃣ 再次搜索就可以出结果并播放了。
4.2 导入网盘资源
1️⃣ 如果希望搜索网盘资源，需要用到之前介绍的pansou容器，进入 我的 –> 管理 –> 网盘资源 –> 盘搜应用 –> 配置应用地址，进行配置。
应用地址：输入
pansou的地址，例如：http://192.168.31.194:18111网盘类型：全选
2️⃣ 接着就可以进行搜索了，你会发现这搜索的同时也会搜索网盘资源，如果要转存、播放，还需要对网盘进行授权。
3️⃣ 现在打开影视站，左侧就是不同的影视网站了。
4.3 导入电视/平台直播源
4.3.1 导入电视直播源
直接打开电视栏目也是没有内容的，需要进入 我的 –> 管理 –> 直播资源 –> 电视直播 –> 配置应用地址 –> 配置应用地址栏目下导入电视直播源订阅链接，只要电视直播源订阅链接没问题，播放一般也不会有问题，另外划重点，电视直播源的订阅链接是可以通过搭建IPTV相关的容器获取的。
4.3.2 导入平台直播源
虽然打开直播栏目可以看到OmniBox支持虎牙、抖音、B站、斗鱼等平台，但同样是没有内容的，需要进入 我的 –> 管理 –> 直播资源 –> 平台直播 –> 配置应用地址 –> 配置应用地址栏目下导入平台直播源地址，只要平台直播源没问题，播放一般也不会有问题。
4.4 导入解析站资源
OmniBox的解析站和影视站资源的订阅并不重复，解析站的作用是进一步丰富平台资源的解析渠道和下载渠道。
4.5 联动安卓智能电视app的影视订阅功能
值的一提的是OmniBox是可以联动安卓智能电视app的，比如TVBox、猫影视、UZ订阅等电视app，将下图生成的订阅链接填入对应app的订阅地址栏中即可。（开启联动需要保证OmniBox和以上app在同一局域网网段内或者以上电视app是可以访问到所搭建在公网上的OmniBOX的）
4.6 配置网盘资源监测系统
4.6.1 PanCheck 简介
PanCheck 是一个网盘链接有效性检测系统，专为用户提供批量检测多种主流网盘平台分享链接的有效性。它能够快速确认链接是否仍然可用，从而帮助用户管理和维护网盘资源。
4.6.2 PanCheck 部署
PanCheck的部署和OmniBox相近，也是通过Compose方式部署，这里只强调一个点，由于我的容器服务较多，redis服务是不同容器不同部署的，因此如果你只有这一个容器使用redis服务，端口号可以使用默认的6379，我的redis服务比较多，为了确保数据间不混淆，我的OmniBox的redis服务端口号是6380，同理MySQL也是一样的处理方式，这里附上部署截图和代码：
services:
pancheck:
image: lampon/pancheck:latest
container_name: pancheck
ports:
- "18774:8080"
environment:
- SERVER_PORT=8080 # 服务端口
- SERVER_MODE=release # 服务模式
- SERVER_CORS_ORIGINS=* # 跨域请求允许的源
- DATABASE_TYPE=mysql # 数据库类型
- DATABASE_HOST=db # 数据库地址
- DATABASE_PORT=3306 # 数据库端口
- DATABASE_USER=root # 数据库用户名
- DATABASE_PASSWORD=your_password # 数据库密码
- DATABASE_DATABASE=pancheck # 数据库名称
- DATABASE_CHARSET=utf8mb4 # 数据库字符集
- CHECKER_DEFAULT_CONCURRENCY=5 # 默认并发数
- CHECKER_TIMEOUT=30 # 超时时间（秒）
- REDIS_ENABLED=true # 是否启用Redis
- REDIS_HOST=redis # Redis地址
- REDIS_PORT=6380 # Redis端口
- REDIS_USERNAME= # Redis用户名
- REDIS_PASSWORD= # Redis密码
- REDIS_INVALID_TTL=168 # 失效链接缓存时间（小时）
- ADMIN_PASSWORD=admin123 # 后台管理密码
volumes:
- 你的磁盘路径/pancheck/data:/app/data
restart: unless-stopped
depends_on:
- db
- redis
healthcheck:
test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/api/v1/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s
db:
image: mysql:8.0
container_name: pancheck-db
environment:
- MYSQL_ROOT_PASSWORD=your_password
- MYSQL_DATABASE=pancheck
- MYSQL_CHARACTER_SET_SERVER=utf8mb4
- MYSQL_COLLATION_SERVER=utf8mb4_unicode_ci
volumes:
- 你的磁盘路径/mysql:/var/lib/mysql
restart: unless-stopped
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$$MYSQL_ROOT_PASSWORD"]
interval: 10s
timeout: 5s
retries: 5
redis:
image: redis:latest
container_name: pancheck-redis
ports:
- "6379:6379"
volumes:
- 你的磁盘路径/pancheckredis:/data
restart: unless-stopped
command: redis-server --appendonly yes
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 10s
timeout: 3s
retries: 3关于环境变量，列表进行简单说明：
容器初始化的时间有点长，首次启动请耐心等待。
4.6.3 PanCheck 使用
1️⃣ PanCheck 的使用非常简单，丟入一个网盘链接，很快就能检测出结果。
2️⃣ PanCheck 的后台服务需要在浏览器中输入 http://NAS IP:18774/admin/login 就能看到如下登录界面。
3️⃣ 输入登录密码，密码为环境变量ADMIN_PASSWORD 中设定的值，登录成功后的主界面如下，可以在这里对Pancheck进一步进行参数设置，可以看到失效链接数符合我们在前端看到的结果。
4.6.4 导入监测系统到 OmniBox
1️⃣ 在OmniBox的管理后台，设置网盘检测。
2️⃣ 启用网盘检测后，前端进行搜索的时候会启用PancCheck应用进行无效链接过滤。
3️⃣ 而未启用网盘检测时，可以搜到更多结果，从数量上看，多了4个，说明有4个链接是无效的。
4.7 OmniBox 一些常见问题解答：
Q1：我的固态硬盘容量小，可以把这个容器的录制内容存放路径改到机械硬盘上吗？
A：可以，只要你能忍受机械硬盘不休眠后产生的噪音。
Q2：这个容器搜索的资源种类丰富吗？
A：是否丰富取决于你订阅链接内的解析站点丰富度以及网盘资源的数量，与容器本身无关。
Q3：这个容器可以通过极空间远程访问功能深度使用吗？
A：可以，该容器支持极空间远程访问功能。
Q4：这个容器需要科学上网使用吗？
A：非必要，当然如果具备条件，也可以在前端页面进行设置指派。
Q5：这个容器后端管理台上配置的其他容器的地址也需要是内网穿透后的域名型地址吗？
A：不需要，如果有外部域名访问需求，同时又不想使用极空间远程访问的朋友，只需要配置一下OmniBox前端的内网穿透即可，后端的容器联动由于容器都在同一局域网内，没有必要配置穿透后的域名地址。
五、结语
如果厌倦了在不同视频应用之间切换，或者受不了网上免费影视站的广告，又或者觉得 Emby、TVBox 等工具配置复杂，那么 OmniBox 将是一个不错的选择。它通过整合多平台，提供了一个稳定、便捷、功能丰富的私有化影视剧综漫的观看平台。需要的朋友可以自己部署体验下。
如果你看完教程觉得部署很困难，也可以扫描下方二维码进入我的淘宝小店——阿程数码，直接购买对应的极空间 Docker 服务，我会远程帮你有偿部署。
评论区