LunaTV
10,941
Stars
9,259
Forks
44
Watchers
10
Open Issues
NOASSERTION
许可证
TypeScript
语言
2025-08-12
创建时间
2026-09-10
最近更新
项目能做什么
采用 CC BY-NC-SA 协议开源的项目，严格禁止任何商业化行为及违规衍生。
来源：AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
中文使用说明暂未生成。下面保留原仓库 README 摘录，命令与配置均以原文为准。
原始 README 摘录（英文原文，节选前 3000 字符）
# MoonTV
<div align="center">
<img src="public/logo.png" alt="MoonTV Logo" width="120">
</div>
> 🎬 **MoonTV** 是一个开箱即用的、跨平台的影视聚合播放器。它基于 **Next.js 14** + **Tailwind CSS** + **TypeScript** 构建，支持多资源搜索、在线播放、收藏同步、播放记录、云端存储，让你可以随时随地畅享海量免费影视内容。
<div align="center">
</div>
---
## ✨ 功能特性
- 🔍 **多源聚合搜索**：一次搜索立刻返回全源结果。
- 📄 **丰富详情页**：支持剧集列表、演员、年份、简介等完整信息展示。
- ▶️ **流畅在线播放**：集成 HLS.js & ArtPlayer。
- ❤️ **收藏 + 继续观看**：支持 Kvrocks/Redis/Upstash 存储，多端同步进度。
- 📱 **PWA**：离线缓存、安装到桌面/主屏，移动端原生体验。
- 🌗 **响应式布局**：桌面侧边栏 + 移动底部导航，自适应各种屏幕尺寸。
- 👿 **智能去广告**：自动跳过视频中的切片广告（实验性）。
### 注意：部署后项目为空壳项目，无内置播放源和直播源，需要自行收集
<details>
<summary>点击查看项目截图</summary>
<img src="public/screenshot1.png" alt="项目截图" style="max-width:600px">
<img src="public/screenshot2.png" alt="项目截图" style="max-width:600px">
<img src="public/screenshot3.png" alt="项目截图" style="max-width:600px">
</details>
### 请不要在 B站、小红书、微信公众号、抖音、今日头条或其他中国大陆社交平台发布视频或文章宣传本项目，不授权任何“科技周刊/月刊”类项目或站点收录本项目。
## 🗺 目录
- [技术栈](#技术栈)
- [部署](#部署)
- [一键部署](#zeabur-一键部署)
- [Docker 部署](#Kvrocks-存储推荐)
- [配置文件](#配置文件)
- [订阅](#订阅)
- [自动更新](#自动更新)
- [环境变量](#环境变量)
- [客户端](#客户端)
- [AndroidTV 使用](#AndroidTV-使用)
- [Roadmap](#roadmap)
- [安全与隐私提醒](#安全与隐私提醒)
- [License](#license)
- [致谢](#致谢)
## 技术栈
| 分类 | 主要依赖 |
| --------- | ----------------------------------------------------------------------------------------------------- |
| 前端框架 | [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 的平台** 部署。
### zeabur 一键部署
点击下方按钮即可一键部署，自动配置 LunaTV + Kvrocks 数据库：
[](https://zeabur.com/templates/8MPTQU/deploy)
**优势**：
- ✅ 无需配置，一键启动（自动部署完整环境）
- ✅ 自动 HTTPS 和全球 CDN 加速
- ✅ 持久化存储，数据永不丢失
- ✅ 免费额度足够个人使用
**⚠️ 重要提示**：部署完成后，需要在 Zeabur 中为 LunaTV 服务设置访问域名（Domain）才能在浏览器中访问。详见下方 [设置访问域名](#5-设置访问域名必须) 步骤。
### Kvrocks 存储（推荐）
```yml
services:
moontv-core:
image: ghcr.io/moontechlab/lunatv:late
阅读完整原文
项目深度分析 AI 生成
云服务厂商模版推荐与分销分成
| 产品构想 | 利用项目提供的 Zeabur 等一键部署按钮和 Docker 模板，通过云平台推荐链接（Affiliate）赚取佣金，严格保持项目开源非商用属性。 |
| 核心功能 | 一键拉起 Docker + Kvrocks 环境、开箱即用的域名与 CDN 加速、配置引导文档。 |
| 目标用户 | 没有自建服务器、希望一键获得云端私人影音库的小白用户。 |
| 难度/周期 | 低 · 1周内 · 成本：极低（仅需维护模板与外链推广） |
| 收费模式 | 云服务商返佣（CPS模式） |
| 竞争风险 | 政策与合规风险，若引流过多易遭平台下架；依赖第三方云厂商政策变更。 |
| 依据 | 已验证事实 |
合规本地流媒体播放器/管理工具（重新实现）
| 产品构想 | 完全规避本项目代码与协议限制，借鉴其 PWA + 现代 Web 播放器 UI 架构，重写一套专用于个人自建合规媒体库（如 WebDAV、Jellyfin、Emby、本地 NAS）的第三方独立客户端。 |
| 核心功能 | WebDAV/SMB 挂载、本地刮削元数据、ArtPlayer 增强播放、PWA/Android TV 适配。 |
| 目标用户 | NAS 用户、局域网高清视频收藏者、多终端串流需求者。 |
| 难度/周期 | 中等 · 1-3个月 · 成本：个人全栈开发时间成本、少量测试设备采购 |
| 收费模式 | 买断制独立客户端、高级功能订阅（跨网络穿透加速、专属转码插件） |
| 竞争风险 | 开发周期长；开源与免费替代品众多（如 Infuse、VidHub、Jellyfin 客户端），竞争激烈。 |
| 依据 | 尚需验证的假设 |
自建媒体私有化运维与技术咨询服务
| 产品构想 | 不直接销售影视软件，转为家庭用户或工作室提供家庭影音服务器搭建、Docker 环境运维、数据多端备份等一对一专业技术服务。 |
| 核心功能 | 私有化部署实施、远程故障排查、自动化数据备份与灾备方案设计。 |
| 目标用户 | 有家庭影音需求但缺乏技术知识的高净值用户、中小工作室。 |
| 难度/周期 | 低 · 即时开展 · 成本：人力工时与沟通成本 |
| 收费模式 | 按次技术服务费、按年维护托管费 |
| 竞争风险 | 用户涉及版权源纠纷时可能牵连服务提供方；难以规模化交付。 |
| 依据 | AI推测 |
AI 基于仓库公开数据分析生成，含推测成分，不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
相似项目数据正在完善中，暂不展示（避免误导）
项目优势与风险
| 技术成熟度 | 创建于 2025-08-12，最近推送 2026-09-10，发布过 29 个 Release |
| 社区活跃 | Star 10,941 / Fork 9,259 / Issue 10（数据支持，可自行核实） |
| 许可证 | NOASSERTION |
| 主要风险 | 上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价 |
安装与使用
快速开始（以仓库 README 为准）
git clone https://github.com/MoonTechLab/LunaTV.git cd LunaTV docker compose up -d # 或参考 README 中的 docker run 命令
术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。