影视自由一步实现，手把手教你在 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 接口的应用，输入配置链接就行了。

综合推荐：⭐⭐⭐（适合入门级影视聚合需求）

使用体验：⭐⭐⭐⭐（界面清新，功能丰富）

部署难易：⭐⭐（简单）︎