MoonTV：基于 Next.js 的开源跨平台影视聚合播放器

访问 http://localhost:3000 即可开始使用。

Kvrocks/Redis 存储部署

MoonTV 支持多种存储后端，以下分别展示 Kvrocks 与 Redis 的 docker-compose.yml 示例。

Kvrocks 示例：

version: '3.8'
services:
  moontv-core:
    image: ghcr.io/moontechlab/lunatv:latest
    container_name: moontv-core
    restart: unless-stopped
    ports:
      - '3000:3000'
    environment:
      - USERNAME=admin
      - PASSWORD=admin_password
      - NEXT_PUBLIC_STORAGE_TYPE=kvrocks
      - KVROCKS_URL=redis://moontv-kvrocks:6666
    networks:
      - moontv-network
    depends_on:
      - moontv-kvrocks
  moontv-kvrocks:
    image: apache/kvrocks
    container_name: moontv-kvrocks
    restart: unless-stopped
    volumes:
      - kvrocks-data:/var/lib/kvrocks
    networks:
      - moontv-network
networks:
  moontv-network:
    driver: bridge
volumes:
  kvrocks-data:

Redis 示例：

version: '3.8'
services:
  moontv-core:
    image: ghcr.io/moontechlab/lunatv:latest
    container_name: moontv-core
    restart: unless-stopped
    ports:
      - '3000:3000'
    environment:
      - USERNAME=admin
      - PASSWORD=admin_password
      - NEXT_PUBLIC_STORAGE_TYPE=redis
      - REDIS_URL=redis://moontv-redis:6379
    networks:
      - moontv-network
    depends_on:
      - moontv-redis
  moontv-redis:
    image: redis:alpine
    container_name: moontv-redis
    restart: unless-stopped
    volumes:
      - redis-data:/data
    networks:
      - moontv-network
networks:
  moontv-network:
    driver: bridge
volumes:
  redis-data:

手动安装

若不使用容器，可直接在本地运行。

git clone https://github.com/MoonTechLab/LunaTV.git
cd LunaTV
npm install
# 配置环境变量
cp .env.example .env
nano .env
# 构建并启动
npm run build
npm start

配置说明

环境变量配置 基础配置中需设置用户名、密码及站点域名。存储类型可选择 kvrocks、redis 或 upstash。

USERNAME=admin
PASSWORD=your_strong_password
SITE_BASE=https://your-domain.com
NEXT_PUBLIC_SITE_NAME=My MoonTV
NEXT_PUBLIC_STORAGE_TYPE=kvrocks
KVROCKS_URL=redis://localhost:6666

资源站配置 通过 JSON 文件定义 API 接口与分类规则，支持自定义热门电影、美剧等分类。

主题配置 支持自定义主色调、深色模式、布局宽度及播放器默认行为（如自动播放、默认画质）。

使用指南

基本工作流

安装部署 → 资源配置 → 内容搜索 → 视频播放 → 内容管理 → 多端同步。

内容搜索与播放

1. 搜索：打开搜索界面输入关键词，可选指定源站，查看带缩略图的实时结果。
2. 播放：选择视频后查看详情，支持倍速、字幕切换及后台播放。
3. 管理：收藏喜欢的内容，查看观看历史，进行多端数据同步。

个性化设置

可在设置中调整界面主题颜色、字体样式及布局紧凑度。播放器偏好包括默认画质、字幕语言及音量记忆。通知设置支持免打扰模式与更新提醒。

多端适配

• 桌面端：浏览器直接访问或安装 PWA，支持键盘快捷键。
• 移动端：移动浏览器访问，触控优化，支持离线缓存。
• 电视端：大屏界面适配，遥控器操作友好。

应用场景

MoonTV 适用于多种场景：个人用户可搭建私有影视库，集中管理收藏；家庭用户可建立共享媒体中心，配合家长控制功能；开发者可将其作为学习 Next.js 与 TypeScript 的实战项目；小型团队可用于内部资源共享；教育机构则可建设教学媒体库，按课程组织内容。

总结

MoonTV 通过多源搜索、流畅播放、数据同步及跨平台特性，为影视内容管理提供了完整的解决方案。其基于 Next.js 与 TypeScript 的技术架构保证了项目的可维护性与扩展性。无论是自建私有云盘还是探索前端技术，MoonTV 都是一个值得尝试的开源项目。

注意事项：

• 需要自行配置合法的内容源
• 生产环境务必修改默认密码
• 定期备份数据库以防数据丢失
• 多设备使用前建议测试兼容性