KatelyaTV 是一个跨平台的影视聚合播放器，支持聚合搜索功能，即开即用，并且可以自托管。该项目源自 MoonTV，是它的二次创作和继承版本，持续进行功能优化和体验提升。
功能特性详解
核心播放功能
- 🔍 聚合搜索：集成多个影视资源站点，实现一键全网内容搜索
- 📺 高清播放：基于 ArtPlayer 播放器技术，支持多种视频格式流畅播放
- ⏭️ 智能跳过：自动识别片头片尾，支持手动设置跳过特定时间段
- 🎯 断点续播：自动保存播放进度，支持跨设备同步观看位置
- 📱 响应式设计：完美适配手机、平板和电脑等各种屏幕尺寸
数据管理功能
- ⭐ 收藏功能：收藏喜爱的影视作品，支持跨设备同步收藏列表
- 📖 播放历史：自动记录观看历史，方便快速找回已看内容
- 👥 多用户支持：独立用户系统，每个用户享有专属个人数据空间
- 🔄 数据同步：兼容多种存储后端，包括 LocalStorage、Redis、D1 和 Upstash
- 🔒 内容过滤：智能成人内容过滤系统，默认启用安全保护机制
部署与兼容性
- 🐳 Docker 一键部署：提供完整 Docker 镜像，实现快速开箱即用
- ☁️ 多平台支持：全面兼容 Vercel、Docker 和 Cloudflare Pages 等平台
- 🔧 灵活配置：支持自定义资源站、代理设置和主题个性化配置
- 📱 PWA 支持：可安装为桌面或手机应用，提供原生应用体验
- 📺 TVBox 兼容：支持 TVBox 配置接口，扩展播放设备兼容性
部署前准备工作
访问 GitHub 项目页面：github.com/haogege8888/KatelyaTV
根据需求下载配置文件，并将其重命名为：config.json
创建专用文件夹，将 JSON 配置文件放置其中（如果不映射文件，默认仅提供少量资源源，内容可能较为有限）
详细安装步骤
KatelyaTV 提供多种部署方案选择，本文以 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 即可访问 KatelyaTV 界面。
输入先前设置的用户名和密码进行登录。
提示：如果输入的用户名和密码正确但仍登录失败，可以尝试重启容器服务。
界面设计风格简洁清新，用户体验较为舒适。
为展示不同视觉效果，此处切换为深色模式进行截图。
点击界面右上角的“管理面板”进入管理界面。
首先检查视频源配置，确认是否为映射的 JSON 文件内容。
支持视频源的导入、导出和添加操作，方便资源管理。
用户配置部分提供基本的用户管理功能。
站点配置选项，大多数设置保持默认即可正常使用。
返回首页面，点击任意电影查看播放效果。
海报墙设计效果良好，提供跳转到豆瓣页面和评分显示功能。
点击中央播放按钮后，需要短暂等待资源搜索过程。
在线播放资源数量较为丰富，进度条拖动流畅，但分辨率普遍为 1080P 格式。
页面下方提供影片详细介绍，可点击收藏按钮便于后续观看。
电视剧播放界面，选集操作直观便捷。
针对连续剧内容，可以设置自动跳过片头片尾功能。
历史观看记录功能，方便用户继续上次观看进度。
搜索功能强大，只要视频源充足，基本能找到所需影视内容。
电影分类包含豆瓣精选，帮助用户快速选择观看内容。
剧集内容大部分为 1080P 分辨率，不太建议在大屏幕设备上播放。
综艺节目测试播放正常，功能稳定。
内容过滤功能，具体细节不便详细说明。
提示：如果出现用户不存在提示，可以添加新用户并使用该账号登录进行设置。
TVBox 配置功能，无需打开网页即可直接通过 APP 观看内容。
总结与评价
KatelyaTV 作为基于 MoonTV 改进的影视聚合工具，其核心优势在于强大的聚合搜索能力，通过整合多个资源站点显著降低了用户寻找影视内容的难度。同时支持跳过片头片尾、断点续播等实用功能，进一步提升了观影便利性。不过需要注意的是，目前影视资源分辨率主要以 1080P 为主，日常追剧需求基本可以满足。如果希望在电视设备上使用，可以下载兼容 TVBox 接口的应用，并输入相应配置链接即可。
综合推荐指数：⭐⭐⭐（适合入门级影视聚合需求）
使用体验评价：⭐⭐⭐⭐（界面设计清新，功能较为丰富）
部署难度评估：⭐⭐（操作过程相对简单）