🎬 LunaTV Enhanced Edition 是基于 MoonTV 深度二次开发的全功能影视聚合播放平台。在原版基础上新增了 YouTube 集成、网盘搜索、AI 推荐、短剧功能、IPTV 直播、Bangumi 动漫、播放统计、弹幕系统等 60+ 重大功能增强，打造极致的在线观影体验。
本项目是在 MoonTV 基础上进行的深度二次开发版本，从 v4.3.1 版本开始，持续迭代至当前 v6.6.5，累计新增 60+ 重大功能模块，400+ 细节优化。所有新增功能详见 CHANGELOG。
本项目仅供学习交流使用，请勿用于商业用途。所有视频内容均来自第三方平台，本项目不存储任何视频文件。使用本项目产生的任何法律责任由使用者自行承担。
- 多人观影房：支持同步播放、屏幕共享、实时聊天、语音通话，WebRTC 实时传输，画质预设可调 → 详细文档
- Emby 私有库：完整的 Emby 媒体服务器集成，支持免密登录、认证模式切换和多音轨播放 → 详细文档
- YouTube 集成：完整的 YouTube 搜索、播放、直播功能，支持热门视频和地区选择器
- Bilibili 集成：Bilibili 搜索和播放功能，支持 UP主视频、热门视频、QR码登录、Cookie管理
- 网盘搜索：集成高级筛选和缓存管理的网盘资源搜索，PanSou 支持身份认证
- ACG 种子搜索：Mikan Project 双源系统 + Nyaa 搜索，支持种子下载链接导出，丰富的动漫资源
- IPTV 直播：m3u/m3u8 订阅、FLV 直播流、EPG 节目单、M3U 导入导出
- Bangumi 动漫：动漫信息智能检测、API 集成
- 繁体中文搜索：智能繁简转换、多策略搜索
- 搜索列表视图：支持列表/网格双视图模式切换，列表模式带图片预览和快捷播放
- 豆瓣快速信息面板：移动端 ActionSheet 接入豆瓣详情，支持 quick-info 和 suggest API
- TMDB Hero Banner：播放页以 TMDB backdrop 为主视觉，展示 logo、海报、评分、简介，支持多季徽章
- 剧集选择器增强：手动速度测试功能，实时显示源状态徽章（可用/不可用/测试中）
- 控制栏透明度控制：可自定义控制栏遮挡度（10-80%），实时调整透明度和模糊效果，改善字幕可见性
- 快进快退按钮：可自定义时间间隔的快进快退按钮，Netflix 风格设计，响应式布局
- 超宽显示器适配：视频显示模式控制，完美支持超宽显示器
- 片头片尾跳过预设：灵活的片头片尾模板系统，支持导入导出和验证
- 播放速率持久化：记住播放速率设置，跨会话保持
- 多音轨支持：Emby 播放自动选择浏览器兼容音轨，支持音轨切换；支持自定义 X-Emby-Authorization 请求头
- 视频分辨率筛选：自动推断视频流分辨率并支持按分辨率筛选源
- HLS 并发分片预取：主加载同时预取后续 2-3 个分片，缓冲速度提升 2-4 倍；50MB 缓存上限与失败熔断，保留广告过滤
- 大分片并发下载：大于 512KB 的 TS 分片自动切 4 块 Range 并发下载，突破源站单连接限速
- 即将上映提醒：完整的即将上映内容关注列表和提醒系统
- 自动发布通知：收藏内容发布时自动推送通知
- 邀请码系统：支持邀请码注册、历史记录和管理功能
- AI 智能助手：支持 GPT-5/o 系列模型，流式传输 → 详细文档
- Tavily 搜索模式：无需 AI API 的搜索模式
- TMDB 演员搜索：完整的演员搜索、过滤和缓存
- 发布日历：即将上映内容预览和跟踪
- 第三方弹幕 API：集成腾讯、爱奇艺、优酷、B站等主流平台
- 智能性能优化：分级渲染、Web Worker 加速
- 手动弹幕匹配：精准获取对应弹幕
- 综合设置面板：完整的弹幕配置
- 性能监控仪表板：完整的 API 性能监控系统
- 流量监控系统：真实流量监控、域名分解
- 播放统计增强：记录用户登入 IP、归属地（城市/省份/国家）、设备类型、浏览器及操作系统，管理员可在统计面板查看
- Kvrocks 持久化：高性能缓存系统
- TanStack Query 全面集成：
- 智能数据缓存和自动重新验证
- 无限滚动优化（豆瓣、短剧页面）
- 虚拟滚动提升大列表性能
- 统一的 API 缓存策略（2小时）
- 减少不必要的网络请求和重复渲染
# 克隆项目
git clone https://github.com/SzeMeng76/LunaTV.git
cd LunaTV
# 复制环境变量配置
cp .env.example .env
# 编辑 .env 文件，配置必要的环境变量
nano .env
# 启动服务
docker-compose up -d访问 http://localhost:3000 即可使用。
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev详细部署指南：查看完整部署文档
- 📖 完整文档中心 - 所有文档的导航页
- 🚀 部署指南 - Docker、Vercel 等部署方式
- ⚙️ 配置说明 - 环境变量和功能配置
- 📱 移动端使用 - 移动端 APP 和 AndroidTV 使用
- 🔐 OIDC 认证
- 💬 Telegram 认证
- 🌐 可信网络
- 前端框架：Next.js 16.3.6 + React 19.3.0
- 开发语言：TypeScript 5.8.3
- 样式方案：TailwindCSS 4.1.18
- 视频播放：ArtPlayer 5.4.0 + HLS.js 1.7.3
- 状态管理：TanStack Query 5.103.1（全面迁移完成，优化数据获取和缓存）
- 数据库：Upstash Redis / Kvrocks / SQLite（三种存储后端可选）
- 部署方案：Docker / Vercel / Render / 腾讯云 EdgeOne
查看 CHANGELOG 了解所有版本更新内容。
详细的安全配置和隐私保护说明请查看 安全文档。
本项目采用 CC BY-NC-SA 4.0 协议 开源。
这意味着：
- ✅ 您可以自由地分享、复制和修改本项目
- ✅ 您必须给予适当的署名，提供指向本许可协议的链接
- ❌ 您不得将本项目用于商业目的
⚠️ 若您修改、转换或以本项目为基础进行创作，您必须以相同的许可协议分发您的作品
© 2025-2026 LunaTV Enhanced Edition & Contributors
基于 MoonTV 进行二次开发。
- MoonTV — 项目原始版本
- Selene — 官方移动端 APP（iOS / Android 手机）
- Selene-TV — 官方 Android TV 客户端，针对遥控器设备优化
- LibreTV — 灵感来源
- Next.js — React 框架
- ArtPlayer — 强大的网页视频播放器
- HLS.js — HLS 流媒体支持
- TanStack Virtual — 虚拟滚动组件
- Tailwind CSS — CSS 框架
本项目在开发过程中参考了以下优秀开源项目的设计思路和实现方案：
- MoonTVPlus — 观影室同步播放、移动端优化等功能实现参考
- DecoTV — TVBox 安全策略、性能优化、UI 设计等实现参考
感谢这些项目及其作者的开源贡献和优秀实现！
- 所有提供免费影视接口的站点
- 开源社区的贡献者们
- 使用并反馈问题的用户们
如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！
Made with ❤️ by LunaTV Enhanced Edition Team