KatelyaTV：
一款跨平台、聚合搜索、即开即用，自托管影视聚合播放器。项目自「MoonTV」演进而来，为其二创/继承版本，持续维护与改进功能与体验。
功能特性：
🎬 核心功能
- • 🔍 聚合搜索：整合多个影视资源站，一键搜索全网内容
- • 📺 高清播放：基于 ArtPlayer 的强大播放器，支持多种格式
- • ⏭️ 智能跳过：自动检测并跳过片头片尾，手动设置跳过时间段
- • 🎯 断点续播：自动记录播放进度，跨设备同步观看位置
- • 📱 响应式设计：完美适配手机、平板、电脑各种屏幕
💾 数据管理
- • ⭐ 收藏功能：收藏喜欢的影视作品，支持跨设备同步
- • 📖 播放历史：自动记录观看历史，快速找回看过的内容
- • 👥 多用户支持：独立的用户系统，每个用户独享个人数据
- • 🔄 数据同步：支持多种存储后端（LocalStorage、Redis、D1、Upstash）
- • 🔒 内容过滤：智能成人内容过滤系统，默认开启安全保护
🚀 部署特性
- • 🐳 Docker 一键部署：提供完整的 Docker 镜像，开箱即用
- • ☁️ 多平台支持：Vercel、Docker、Cloudflare Pages 全兼容
- • 🔧 灵活配置：支持自定义资源站、代理设置、主题配置
- • 📱 PWA 支持：可安装为桌面/手机应用
- • 📺 TVBox 兼容：支持 TVBox 配置接口
准备
来到 GitHub 项目地址：github.com/haogege8888/KatelyaTV
根据需要下载配置文件，重命名为：config.json
创建文件夹，将 JSON 文件放到里面（不映射文件，默认只有几个源，资源会比较少）
安装
提供选择的部署方案有很多，我选择的是 Docker + Redis
项目作者也给出对应部署方法，感兴趣的可以看看
为了方便部署，可以用下面模板（官方基础上精简了一些非必须参数）
services:
katelyatv:
image: ghcr.io/katelya77/katelyatv:latest
container_name: katelyatv
ports:
- 3000:3000
volumes:
- ./config.json:/app/config.json
environment:
NEXT_PUBLIC_STORAGE_TYPE: redis
REDIS_URL: redis://katelyatv-redis:6379
REDIS_DATABASE: 0
USERNAME: admin
PASSWORD: 123456
NEXTAUTH_SECRET: tMXpoftPQJt3Zfxj4Sa84BTEJYcostrw
NEXTAUTH_URL: http://localhost:3000
depends_on:
- katelyatv-redis
restart: unless-stopped
katelyatv-redis:
image: redis:7-alpine
container_name: katelyatv-redis
command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
volumes:
- ./redis:/data
restart: unless-stopped
参数说明（更多参数建议去看文档）
:::USERNAME（环境变量）：站点访问账号
PASSWORD（环境变量）：站点访问密码
NEXTAUTH_SECRET（环境变量）：加密密钥
NEXTAUTH_URL（环境变量）：基础 URL
:::
有可能映射的 config.json 会有权限不足，导致启动有问题，给一下权限就行
sudo chmod 777 /vol1/1000/docker/katelyatv/config.json
使用
浏览器中输入 http://NAS的IP:3000 就能看到界面
输入前面设置的账号和密码
TIP：如果输入账号和密码都没问题，但就是登录失败，可以重启一下容器试试
界面看起来还是挺不错的，清爽清新
为了截图效果，这里我切换为深色模式了
右上角，点击“管理面板”
先检查一下视频源，看看是否为映射的 JSON 文件
支持视频源导入，导出和添加
用户配置，有简单的用户管理
站点配置，这些配置默认就行
回到首页，点击一部电影看看效果
这个海报墙还是可以的，有跳转到豆瓣页面和评分
点击中间播放按钮，需要等待一下搜索
**资源还挺多的，拖动进度条倒是很流畅，不过分辨率普遍都是 1080P
滑动到下面还有关于影片的介绍，可以点击收藏按钮方便下次观看
电视剧的效果，选集非常直观方便
对于连续剧，可以设置跳过片头片尾
有历史观看记录，方便下次继续观看
搜索，只要视频源足够多，基本都能找到想要的影片
电影，有豆瓣精选分类，不用纠结看什么了
剧集，因为大部分都是 1080P 所以不太建议在大屏设备播放
综艺，试过了都能正常播放
内容过滤，懂得都懂不详细说了
TIP：有可能会提示用户不存在，添加一个用户用这个账号登录就可以设置了
TVBox 配置，不用打开网页也可以直接用 APP 观看了
总结
KatelyaTV 是一款基于 MoonTV 改进的影视聚合工具，核心亮点在于聚合搜索能力，通过整合极大降低了用户寻找影视内容的门槛，还支持跳过片头片尾、断点续播等功能，进一步提升了观影便捷性。不过上面影视资源分辨率大部分都是以 1080P 为主，日常简单追剧都是没问题的。如果是想在电视 TV 上使用，可以下载兼容 TVBox 接口的应用，输入配置链接就行了。
综合推荐：⭐⭐⭐（适合入门级影视聚合需求）
使用体验：⭐⭐⭐⭐（界面清新，功能丰富）
部署难易：⭐⭐（简单）︎
