KatelyaTV—影视聚合播放，极空间部署教程

就在前段时间，MoonTV 突然宣布封档，这意味着继LibreTV后又一视频聚合播放工具无限期停止运维。

不过幸运的是，社区另有一位作者接棒了原项目的视频播放能力，让我们可以继续沿用这款好用的视频聚合播放工具。

KatelyaTV 自「MoonTV」演进而来，为其二创/继承版本，该项目仅为多端聚合播放，不提供任何视频源。

最新补充：KatelyaTV项目近期也停更了，不过有最新修改者地址：github.com/haogege8888/KatelyaTV；修复OrionTV视频源无法播放等诸多问题

🎬 核心功能

📺 高清播放：基于 ArtPlayer 的强大播放器，支持多种格式

⏭️ 智能跳过：自动检测并跳过片头片尾，手动设置跳过时间段

🎯 断点续播：自动记录播放进度，跨设备同步观看位置

📱 响应式设计：完美适配手机、平板、电脑各种屏幕💾 数据管理

⭐ 收藏功能：收藏喜欢的影视作品，支持跨设备同步

📖 播放历史：自动记录观看历史，快速找回看过的内容

👥 多用户支持：独立的用户系统，每个用户独享个人数据

🔄 数据同步：支持多种存储后端（LocalStorage、Redis、D1、Upstash）🚀 部署特性

🐳 Docker 一键部署：提供完整的 Docker 镜像，开箱即用

☁️ 多平台支持：Vercel、Docker、Cloudflare Pages 全兼容

🔧 灵活配置：支持自定义资源站、代理设置、主题配置

📱 PWA 支持：可安装为桌面/手机应用

⭐部署机

论家庭影音服务，个人觉得极空间的极影视是最强大的。无论是刮削能力、对Strm的支持，以及近期上线的网盘挂载服务，满足了绝大多数 NAS 用户的观影需求。

极空间Z4 Pro 是一款 4盘位 NAS产品，作为极空间Z系列中的常青树产品，没有性能溢出，最适合符合用户的使用需求。

其采用 N97处理器，拥有低功耗、高性能等特点，能实现主流的视频编解码，DDR5 内存能保证系统性能高效稳定，双 2.5Gbps 网口更能满足2.5G家庭局域网的主流需求。

一、极空间部署KatelyaTV

正式部署之前，首先我们在极空间的个人空间里新建一个文件夹，并创建一个文本文件，改名为config.json。

打开docker应用，新建一个Compose项目，将下方提供的yaml代码复制到文本框内，并修改我框出来的路径。

点击文本框上方的查询路径，切换到刚才创建的文件夹，选择复制路径。（注意，如果选择了文本再复制的，那就把代码里路径后面的文件名删了）

🔻yaml代码

services:

  katelyatv:

    container_name: katelyatv

    image: ghcr.io/katelya77/katelyatv:latest

    ports:

      - 8231:3000

    volumes:

      - /路径/config.json:/app/config.json:ro

    environment:

      NEXT_PUBLIC_STORAGE_TYPE: kvrocks

      KVROCKS_URL: redis://kvrocks:6666

      KVROCKS_DATABASE: 0

      # 管理员账号密码，可以自己修改

      USERNAME: cherry

      PASSWORD: cherry

      NEXT_PUBLIC_ENABLE_REGISTER: true

    depends_on:

      - kvrocks

    restart: unless-stopped

  kvrocks:

    image: apache/kvrocks:latest

    environment:

      KVROCKS_BIND: 0.0.0.0

      KVROCKS_PORT: 6666

      KVROCKS_DIR: /var/lib/kvrocks/data

      KVROCKS_LOG_LEVEL: info

    volumes:

      - kvrocks-data:/var/lib/kvrocks/data

    restart: unless-stopped

volumes:

  kvrocks-data:

    driver: local

二、Katelya使用体验

系统部署完成以后，回到docker的容器页面。在这里找到katelyatv这个容器，点击极空间官方提供的远程访问功能，就可以实现无公网访问docker服务，极大的方便了我们。

项目首页是被封装在一个应用框里的，输入代码里配置的账号密码登录就可以来到首页。整体界面还是比较简单、直观的，上方分别是搜索功能以及影视分类。

基本上所有的数据都来源于豆瓣影视的信息介绍，包括有类型、简介、海报等。

点击右上角的头像，打开管理面板可以对项目的一些参数进行配置。

比如站点标题、公告，豆瓣、图片前端代理地址等，如果是个人使用的话保持默认就行了。

由于我这边提供的是多用户版本，可以给家庭成员也开通一些子账号。每一个子账号都可以单独配置内容过滤，有效保护影片隐私。

如果大家手头上有自己获取到的媒体信息，可以通过下面的格式去修改config.json这个配置文件。也可以通过系统里的导入功能导入使用。

{

"cache_time": 7200,

"api_site": {

"site1": {

"api": "API 地址",

"name": "API 名称",

"is_adult": false

}}}

在播放体验中，系统会自动识别所有信息源中的影片播放速率、延迟、分辨率信息，大家可以结合实际网络情况选择。

值得一提的是，项目还提供了片头片尾跳过功能，支持自动跳过、自动下一集的设置，真正做到释放双手。

当然，如果家里使用了智能电视或者投影仪的，也可以通过本项目提供的API接口调阅项目内的影音信息，实现跨终端的播放同步。

总结

本项目一般只推荐对画质要求不高，并且没有收集影片、海报墙需求的用户使用。如果想要真正打造属于自己的家庭影音服务，那还是建议大家使用极影视这种专业的影音工具。

QQ_1757060598631.png

资源方面，除了主流的 BT/PT 下载外，极空间也已经支持 阿里云盘/115生活/夸克网盘 的本地挂载，支持基于 STRM 格式的视频流信息，所以网盘用户也可以放心食用，享受美丽的影音盛宴。

QQ_1757060626587.png

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～