# DecoTV **Repository Path**: ahxhly/DecoTV ## Basic Information - **Project Name**: DecoTV - **Description**: 基于最新版LunaTV二次开发的一个开箱即用的、跨平台的影视聚合播放站。【原KatelyaTV】 - **Primary Language**: TypeScript - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-01-22 - **Last Updated**: 2026-01-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # DecoTV
> 🎬 **DecoTV** 是一个开箱即用的、跨平台的影视聚合播放器。它基于 **Next.js 14** + **Tailwind CSS** + **TypeScript** 构建，支持多资源搜索、在线播放、收藏同步、播放记录、云端存储，让你可以随时随地畅享海量免费影视内容。
![Next.js](https://img.shields.io/badge/Next.js-14-000?logo=nextdotjs) ![TailwindCSS](https://img.shields.io/badge/TailwindCSS-3-38bdf8?logo=tailwindcss) ![TypeScript](https://img.shields.io/badge/TypeScript-4.x-3178c6?logo=typescript) ![License](https://img.shields.io/badge/License-MIT-green) ![Docker Ready](https://img.shields.io/badge/Docker-ready-blue?logo=docker)
--- ## 🎬 项目展示
明亮模式
明亮模式 		暗夜模式
暗夜模式
--- ### ⚠️ 重要提醒 > **注意**：部署后项目为空壳项目，无内置播放源和直播源，需要自行收集配置。 > **免责声明**：请不要在 B 站、小红书、微信公众号、抖音、今日头条或其他中国大陆社交平台发布视频或文章宣传本项目，不授权任何"科技周刊/月刊"类项目或站点收录本项目。 ## ✨ 功能特性 - 🔍 **多源聚合搜索**：一次搜索立刻返回全源结果。 - 📄 **丰富详情页**：支持剧集列表、演员、年份、简介等完整信息展示。 - ▶️ **流畅在线播放**：集成 HLS.js & ArtPlayer。 - ❤️ **收藏 + 继续观看**：支持 Kvrocks/Redis/Upstash 存储，多端同步进度。 - � **用户注册系统**：支持用户自助注册（可选），带图形验证码防机器人。 - �📱 **PWA**：离线缓存、安装到桌面/主屏，移动端原生体验。 - 🌗 **响应式布局**：桌面侧边栏 + 移动底部导航，自适应各种屏幕尺寸。 - 👿 **智能去广告**：自动跳过视频中的切片广告（实验性）。 ### 注意：部署后项目为空壳项目，无内置播放源和直播源，需要自行收集
点击查看项目截图 项目截图 项目截图
### 请不要在 B 站、小红书、微信公众号、抖音、今日头条或其他中国大陆社交平台发布视频或文章宣传本项目，不授权任何“科技周刊/月刊”类项目或站点收录本项目。 ## 🗺 目录 - [🎬 项目展示](#-项目展示) - [✨ 功能特性](#-功能特性) - [🛠 技术栈](#-技术栈) - [🚀 部署](#-部署) - [⚙️ 配置文件](#️-配置文件) - [🔄 自动更新](#-自动更新) - [🌍 环境变量](#-环境变量) - [Roadmap](#roadmap) - [📺 AndroidTV 使用](#-androidtv-使用) - [🔒 安全与隐私提醒](#-安全与隐私提醒) - [📄 License](#-license) - [🙏 致谢](#-致谢) - [📈 Star History](#-star-history) - [💝 赞赏支持](#-赞赏支持) ## 🛠 技术栈 | 分类 | 主要依赖 | | --------- | ----------------------------------------------------------------------------------------------------- | | 前端框架 | [Next.js 14](https://nextjs.org/) · App Router | | UI & 样式 | [Tailwind CSS 3](https://tailwindcss.com/) | | 语言 | TypeScript 4 | | 播放器 | [ArtPlayer](https://github.com/zhw2590582/ArtPlayer) · [HLS.js](https://github.com/video-dev/hls.js/) | | 代码质量 | ESLint · Prettier · Jest | | 部署 | Docker | ## 🚀 部署 本项目**仅支持 Docker 或其他基于 Docker 的平台** 部署。 ### 📦 Docker 镜像标签 DecoTV 提供以下 Docker 镜像标签： | 标签 | 说明 | 使用场景 | | -------- | ------------ | -------------------------------- | | `latest` | 最新构建版本 | 总是使用最新代码，包含所有小更新 | | `v0.4.0` | 特定版本号 | 固定版本部署，便于版本管理和回滚 | **推荐使用方式**： ```bash # 方式1：使用 latest 标签（自动获取最新更新） docker pull ghcr.io/decohererk/decotv:latest # 方式2：使用特定版本号（生产环境推荐） docker pull ghcr.io/decohererk/decotv:v0.4.0 # 方式3：回滚到旧版本 docker pull ghcr.io/decohererk/decotv:v0.3.0 ``` **版本号标签优势**： - ✅ 清楚知道运行的版本，方便对比 GitHub 最新版 - ✅ 可以固定版本号，避免意外更新影响生产环境 - ✅ 支持版本回滚，遇到问题可快速恢复到旧版本 - ✅ 便于团队协作时统一环境版本 > **注意**：使用 `latest` 标签时，重启容器不会自动拉取新镜像，需要手动执行 `docker pull` 才能获取更新。使用版本号标签可以明确控制何时更新。 ### Kvrocks 存储（推荐） ```yml services: decotv-core: image: ghcr.io/decohererk/decotv:latest # 或使用 :v0.4.0 固定版本 container_name: decotv-core restart: on-failure ports: - '3000:3000' environment: - USERNAME=admin - PASSWORD=admin_password - NEXT_PUBLIC_STORAGE_TYPE=kvrocks - KVROCKS_URL=redis://decotv-kvrocks:6666 networks: - decotv-network depends_on: - decotv-kvrocks decotv-kvrocks: image: apache/kvrocks container_name: decotv-kvrocks restart: unless-stopped volumes: - kvrocks-data:/var/lib/kvrocks networks: - decotv-network networks: decotv-network: driver: bridge volumes: kvrocks-data: ``` ### Redis 存储（有一定的丢数据风险） ```yml services: decotv-core: image: ghcr.io/decohererk/decotv:latest # 或使用 :v0.4.0 固定版本 container_name: decotv-core restart: on-failure ports: - '3000:3000' environment: - USERNAME=admin - PASSWORD=admin_password - NEXT_PUBLIC_STORAGE_TYPE=redis - REDIS_URL=redis://decotv-redis:6379 networks: - decotv-network depends_on: - decotv-redis decotv-redis: image: redis:alpine container_name: decotv-redis restart: unless-stopped networks: - decotv-network # 请开启持久化，否则升级/重启后数据丢失 volumes: - ./data:/data networks: decotv-network: driver: bridge ``` ### Upstash 存储 1. 在 [upstash](https://upstash.com/) 注册账号并新建一个 Redis 实例，名称任意。 2. 复制新数据库的 **HTTPS ENDPOINT 和 TOKEN** 3. 使用如下 docker compose ```yml services: decotv-core: image: ghcr.io/decohererk/decotv:latest # 或使用 :v0.4.0 固定版本 container_name: decotv-core restart: on-failure ports: - '3000:3000' environment: - USERNAME=admin - PASSWORD=admin_password - NEXT_PUBLIC_STORAGE_TYPE=upstash - UPSTASH_URL=上面 https 开头的 HTTPS ENDPOINT - UPSTASH_TOKEN=上面的 TOKEN ``` ## ⚙️ 配置文件 完成部署后为空壳应用，无播放源，需要站长在管理后台的配置文件设置中填写配置文件（后续会支持订阅） 配置文件示例如下： ```json { "cache_time": 7200, "api_site": { "dyttzy": { "api": "http://xxx.com/api.php/provide/vod", "name": "示例资源", "detail": "http://xxx.com" } // ...更多站点 }, "custom_category": [ { "name": "华语", "type": "movie", "query": "华语" } ] } ``` - `cache_time`：接口缓存时间（秒）。 - `api_site`：你可以增删或替换任何资源站，字段说明： - `key`：唯一标识，保持小写字母/数字。 - `api`：资源站提供的 `vod` JSON API 根地址。 - `name`：在人机界面中展示的名称。 - `detail`：（可选）部分无法通过 API 获取剧集详情的站点，需要提供网页详情根 URL，用于爬取。 - `custom_category`：自定义分类配置，用于在导航中添加个性化的影视分类。以 type + query 作为唯一标识。支持以下字段： - `name`：分类显示名称（可选，如不提供则使用 query 作为显示名） - `type`：分类类型，支持 `movie`（电影）或 `tv`（电视剧） - `query`：搜索关键词，用于在豆瓣 API 中搜索相关内容 custom_category 支持的自定义分类已知如下： - movie：热门、最新、经典、豆瓣高分、冷门佳片、华语、欧美、韩国、日本、动作、喜剧、爱情、科幻、悬疑、恐怖、治愈 - tv：热门、美剧、英剧、韩剧、日剧、国产剧、港剧、日本动画、综艺、纪录片 也可输入如 "哈利波特" 效果等同于豆瓣搜索 DecoTV 支持标准的苹果 CMS V10 API 格式。 ## 🔄 自动更新 可借助 [watchtower](https://github.com/containrrr/watchtower) 自动更新镜像容器 dockge/komodo 等 docker compose UI 也有自动更新功能 ## 🌍 环境变量 ### 基础配置 | 变量 | 说明 | 可选值 | 默认值 | | --------------------- | ---------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | USERNAME | 管理员账号 | 任意字符串 | 无默认，**必填** | | PASSWORD | 管理员密码 | 任意字符串 | 无默认，**必填** | | SITE_BASE | 站点 URL | 形如 https://example.com | 空 | | NEXT_PUBLIC_SITE_NAME | 站点名称 | 任意字符串 | DecoTV | | ANNOUNCEMENT | 站点公告 | 任意字符串 | 本网站仅提供影视信息搜索服务，所有内容均来自第三方网站。本站不存储任何视频资源，不对任何内容的准确性、合法性、完整性负责。 | ### 存储配置 | 变量 | 说明 | 可选值 | 默认值 | 备注 | | ------------------------ | ----------------------- | ----------------------- | ---------------- | ------------------------------ | | NEXT_PUBLIC_STORAGE_TYPE | 存储类型 | redis、kvrocks、upstash | 无默认，**必填** | 三选一，推荐使用 kvrocks | | KVROCKS_URL | Kvrocks 数据库连接地址 | redis://host:port | 空 | 当 STORAGE_TYPE=kvrocks 时必填 | | REDIS_URL | Redis 数据库连接地址 | redis://host:port | 空 | 当 STORAGE_TYPE=redis 时必填 | | UPSTASH_URL | Upstash Redis REST URL | https://xxx.upstash.io | 空 | 当 STORAGE_TYPE=upstash 时必填 | | UPSTASH_TOKEN | Upstash Redis REST 令牌 | AUxxxx... | 空 | 当 STORAGE_TYPE=upstash 时必填 | > **注意**：Upstash 使用 REST API 连接，需要填写 `UPSTASH_URL`（HTTPS ENDPOINT）和 `UPSTASH_TOKEN`，不是传统的 Redis 连接字符串。 ### 用户注册配置 | 变量 | 说明 | 可选值 | 默认值 | 备注 | | ------------------------------- | ---------------- | ---------- | ------ | ------------------------------------ | | NEXT_PUBLIC_ENABLE_REGISTRATION | 是否开启用户注册 | true/false | false | 开启后用户可以自助注册，建议用完即关 | > **安全提示**：注册功能默认关闭，仅在需要时临时开启。建议注册完成后立即设置为 `false` 或删除该变量。详见 [用户注册功能说明](./docs/用户注册功能说明.md) ### 高级配置 | 变量 | 说明 | 可选值 | 默认值 | 备注 | | ----------------------------------- | ------------------------ | ---------- | ------ | --------------- | | NEXT_PUBLIC_SEARCH_MAX_PAGE | 搜索接口可拉取的最大页数 | 1-50 | 5 | 数值越大越慢 | | NEXT_PUBLIC_DOUBAN_PROXY_TYPE | 豆瓣数据源请求方式 | 见下方说明 | direct | - | | NEXT_PUBLIC_DOUBAN_PROXY | 自定义豆瓣数据代理 URL | URL prefix | 空 | custom 模式使用 | | NEXT_PUBLIC_DOUBAN_IMAGE_PROXY_TYPE | 豆瓣图片代理类型 | 见下方说明 | direct | - | | NEXT_PUBLIC_DOUBAN_IMAGE_PROXY | 自定义豆瓣图片代理 URL | URL prefix | 空 | custom 模式使用 | | NEXT_PUBLIC_DISABLE_YELLOW_FILTER | 关闭色情内容过滤 | true/false | false | 不建议开启 | | NEXT_PUBLIC_FLUID_SEARCH | 是否开启搜索接口流式输出 | true/false | true | - | #### NEXT_PUBLIC_DOUBAN_PROXY_TYPE 可选值 | 值 | 说明 | | --------------------- | ---------------------------------------------------------------------------------- | | direct | 服务器直接请求豆瓣源站（默认） | | cors-proxy-zwei | 浏览器通过 [Zwei](https://github.com/bestzwei) 提供的 CORS Proxy 请求豆瓣数据 | | cmliussss-cdn-tencent | 浏览器通过 [CMLiussss](https://github.com/cmliu) 提供的腾讯云 CDN 加速请求豆瓣数据 | | cmliussss-cdn-ali | 浏览器通过 [CMLiussss](https://github.com/cmliu) 提供的阿里云 CDN 加速请求豆瓣数据 | | custom | 使用自定义代理（需配置 NEXT_PUBLIC_DOUBAN_PROXY） | #### NEXT_PUBLIC_DOUBAN_IMAGE_PROXY_TYPE 可选值 | 值 | 说明 | | --------------------- | ----------------------------------------------------------- | | direct | 浏览器直接请求豆瓣图片域名（默认） | | server | 服务器代理请求豆瓣图片 | | img3 | 使用豆瓣官方精品 CDN（阿里云） | | cmliussss-cdn-tencent | 使用 [CMLiussss](https://github.com/cmliu) 提供的腾讯云 CDN | | cmliussss-cdn-ali | 使用 [CMLiussss](https://github.com/cmliu) 提供的阿里云 CDN | | custom | 使用自定义代理（需配置 NEXT_PUBLIC_DOUBAN_IMAGE_PROXY） | ## Roadmap - [ ] 多语言国际化支持 - [ ] 更多数据库存储选择 - [ ] 手机端 APP 开发 - [ ] 智能推荐算法 - [ ] 用户评分系统 - [ ] 弹幕功能 - [ ] 离线下载功能 ## 📺 AndroidTV 使用 目前该项目可以配合 [OrionTV](https://github.com/zimplexing/OrionTV) 在 Android TV 上使用，可以直接作为 OrionTV 后端 已实现播放记录和网页端同步 **详细配置指南**： - 📖 [OrionTV 使用指南](./docs/OrionTV使用指南.md) - 🔒 [成人内容过滤使用指南](./docs/成人内容过滤使用指南.md) - **支持通过 URL 参数灵活控制成人内容过滤** **OrionTV 成人内容过滤快速配置**：
点击查看 OrionTV 过滤配置示例 ### 🎯 推荐方式：使用路径前缀 #### 家庭安全模式（推荐家庭使用） ``` API 地址: https://your-domain.com/ ``` ✅ 自动过滤成人资源源和敏感关键词 #### 完整内容模式（成人用户） ``` API 地址: https://your-domain.com/adult/ ``` ✅ 显示所有内容（包括成人资源） > 💡 **工作原理**: > > - 路径前缀 `/adult/` 会被自动识别并重写 > - 例如: `/adult/api/search` → `/api/search?adult=1` > - OrionTV 无需额外配置，开箱即用 ### 备用方式：使用 URL 参数 **注意**: 此方式仅适用于 Web 端，OrionTV 可能不支持 #### 家庭安全模式 ``` API 地址: https://your-domain.com ``` #### 完整内容模式 ``` API 地址: https://your-domain.com?adult=1 ``` 详细说明请参阅 [成人内容过滤使用指南](./docs/成人内容过滤使用指南.md)
## 🎥 TVbox 配置 具体可见 [TVBox 配置优化说明](https://github.com/Decohererk/DecoTV/blob/main/TVBox%E9%85%8D%E7%BD%AE%E4%BC%98%E5%8C%96%E8%AF%B4%E6%98%8E.md) ,详细功能见/admin 管理页面 **TVbox 配置** ## � 用户注册功能 DecoTV 支持用户自助注册功能（可选），适合需要允许用户自行创建账号的场景。 **功能特性**： - ✅ 图形验证码防机器人注册 - ✅ 严格的用户名和密码验证 - ✅ 环境变量一键开关（默认关闭） - ✅ 仅支持 Redis/Upstash/Kvrocks 存储模式 **详细使用指南**：[用户注册功能说明](./docs/用户注册功能说明.md) **快速启用**： ```bash # 在环境变量中设置 NEXT_PUBLIC_ENABLE_REGISTRATION=true NEXT_PUBLIC_STORAGE_TYPE=redis # 或 upstash、kvrocks ``` > ⚠️ **安全提示**：建议默认关闭注册，仅在需要时临时开启，注册完成后立即关闭。 ## �🔒 安全与隐私提醒 ### 请设置密码保护并关闭公网注册 为了您的安全和避免潜在的法律风险，我们要求在部署时**强烈建议关闭公网注册**： ### 部署要求 1. **设置环境变量 `PASSWORD`**：为您的实例设置一个强密码 2. **仅供个人使用**：请勿将您的实例链接公开分享或传播 3. **遵守当地法律**：请确保您的使用行为符合当地法律法规 ### 重要声明 - 本项目仅供学习和个人使用 - 请勿将部署的实例用于商业用途或公开服务 - 如因公开分享导致的任何法律问题，用户需自行承担责任 - 项目开发者不对用户的使用行为承担任何法律责任 - 本项目不在中国大陆地区提供服务。如有该项目在向中国大陆地区提供服务，属个人行为。在该地区使用所产生的法律风险及责任，属于用户个人行为，与本项目无关，须自行承担全部责任。特此声明 ## 📄 License [MIT](LICENSE) © 2025 DecoTV & Contributors ## 🙏 致谢 - [ts-nextjs-tailwind-starter](https://github.com/theodorusclarence/ts-nextjs-tailwind-starter) — 项目最初基于该脚手架。 - [LibreTV](https://github.com/LibreSpark/LibreTV) — 由此启发，站在巨人的肩膀上。 - [ArtPlayer](https://github.com/zhw2590582/ArtPlayer) — 提供强大的网页视频播放器。 - [HLS.js](https://github.com/video-dev/hls.js) — 实现 HLS 流媒体在浏览器中的播放支持。 - [Zwei](https://github.com/bestzwei) — 提供获取豆瓣数据的 cors proxy - [CMLiussss](https://github.com/cmliu) — 提供豆瓣 CDN 服务 - 感谢所有提供免费影视接口的站点。 ## 📈 Star History
Star History Chart
## 💝 赞赏支持 如果这个项目对你有所帮助，欢迎 Star ⭐ 本项目或请作者喝杯咖啡 ☕
微信赞赏
🎨 微信赞赏
---

🌟 如果觉得项目有用，请点个 Star 支持一下！🌟

Made with ❤️ by Decohererk and Contributors