影视自由一步实现，手把手教你在 NAS 上部署 KatelyaTV
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 接口的应用，输入配置链接就行了。
综合推荐：⭐⭐⭐（适合入门级影视聚合需求）
使用体验：⭐⭐⭐⭐（界面清新，功能丰富）
部署难易：⭐⭐（简单）︎