MoonTV

作者原址：sudizer/moontv: 一个开箱即用的、跨平台的影视聚合播放站

🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、本地/云端存储，让你可以随时随地畅享海量免费影视内容。

Docker 部署

1. 直接运行（最简单，localstorage）

# 拉取预构建镜像
docker pull ghcr.io/lunatechlab/moontv:latest

# 运行容器
# -d: 后台运行  -p: 映射端口 3000 -> 3000
docker run -d --name moontv -p 3000:3000 --env PASSWORD=your_password ghcr.io/lunatechlab/moontv:latest

访问 http://服务器 IP:3000 即可。（需自行到服务器控制台放通 3000 端口）

Docker Compose 最佳实践

若你使用 docker compose 部署，以下是一些 compose 示例

local storage 版本

services:
  moontv-core:
    image: ghcr.io/lunatechlab/moontv:latest
    container_name: moontv-core
    restart: unless-stopped
    ports:
      - '3000:3000'
    environment:
      - PASSWORD=your_password
    # 如需自定义配置，可挂载文件
    # volumes:
    #   - ./config.json:/app/config.json:ro

Redis 版本（推荐，多账户数据隔离，跨设备同步）

services:
  moontv-core:
    image: ghcr.io/lunatechlab/moontv: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
      - NEXT_PUBLIC_ENABLE_REGISTER=true
    networks:
      - moontv-network
    depends_on:
      - moontv-redis
    # 如需自定义配置，可挂载文件
    # volumes:
    #   - ./config.json:/app/config.json:ro
  moontv-redis:
    image: redis:alpine
    container_name: moontv-redis
    restart: unless-stopped
    networks:
      - moontv-network
    # 如需持久化
    # volumes:
    #   - ./data:/data
networks:
  moontv-network:
    driver: bridge

自动同步最近更改

建议在 fork 的仓库中启用本仓库自带的 GitHub Actions 自动同步功能（见 .github/workflows/sync.yml）。

如需手动同步主仓库更新，也可以使用 GitHub 官方的 Sync fork 功能。

环境变量

变量	说明	可选值	默认值
USERNAME	非 localstorage 部署时的管理员账号	任意字符串	（空）
PASSWORD	非 localstorage 部署时为管理员密码	任意字符串	（空）
SITE_NAME	站点名称	任意字符串	MoonTV
ANNOUNCEMENT	站点公告	任意字符串	本网站仅提供影视信息搜索服务，所有内容均来自第三方网站。本站不存储任何视频资源，不对任何内容的准确性、合法性、完整性负责。
NEXT_PUBLIC_STORAGE_TYPE	播放记录/收藏的存储方式	localstorage、redis、d1、upstash	localstorage
REDIS_URL	redis 连接 url	连接 url	空
UPSTASH_URL	upstash redis 连接 url	连接 url	空
UPSTASH_TOKEN	upstash redis 连接 token	连接 token	空
NEXT_PUBLIC_ENABLE_REGISTER	是否开放注册，仅在非 localstorage 部署时生效	true / false	false
NEXT_PUBLIC_SEARCH_MAX_PAGE	搜索接口可拉取的最大页数	1-50	5
NEXT_PUBLIC_IMAGE_PROXY	默认的浏览器端图片代理	url prefix	(空)
NEXT_PUBLIC_DOUBAN_PROXY	默认的浏览器端豆瓣数据代理	url prefix	(空)
NEXT_PUBLIC_DISABLE_YELLOW_FILTER	关闭色情内容过滤	true/false	false

配置说明

所有可自定义项集中在根目录的 config.json 中：

{
  "cache_time": 7200,
  "api_site": {
    "dyttzy": {
      "api": "http://caiji.dyttzyapi.com/api.php/provide/vod",
      "name": "电影天堂资源",
      "detail": "http://caiji.dyttzyapi.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：热门、美剧、英剧、韩剧、日剧、国产剧、港剧、日本动画、综艺、纪录片

也可输入如 "哈利波特" 效果等同于豆瓣搜索

MoonTV 支持标准的苹果 CMS V10 API 格式。

修改后 无需重新构建，服务会在启动时读取一次。

管理员配置

该特性目前仅支持通过非 localstorage 存储的部署方式使用

支持在运行时动态变更服务配置

设置环境变量 USERNAME 和 PASSWORD 即为站长用户，站长可设置用户为管理员

站长或管理员访问 /admin 即可进行管理员配置

AndroidTV 使用

目前该项目可以配合 OrionTV 在 Android TV 上使用，可以直接作为 OrionTV 后端

暂时收藏夹与播放记录和网页端隔离，后续会支持同步用户数据

Roadmap

深色模式
持久化存储
多账户

安全与隐私提醒

请设置密码保护并关闭公网注册

为了您的安全和避免潜在的法律风险，我们要求在部署时设置密码保护并强烈建议关闭公网注册：

避免公开访问：不设置密码的实例任何人都可以访问，可能被恶意利用
防范版权风险：公开的视频搜索服务可能面临版权方的投诉举报
保护个人隐私：设置密码可以限制访问范围，保护您的使用记录

部署要求

设置环境变量 PASSWORD：为您的实例设置一个强密码
仅供个人使用：请勿将您的实例链接公开分享或传播
遵守当地法律：请确保您的使用行为符合当地法律法规

重要声明

本项目仅供学习和个人使用
请勿将部署的实例用于商业用途或公开服务
如因公开分享导致的任何法律问题，用户需自行承担责任
项目开发者不对用户的使用行为承担任何法律责任

赞赏码.png

喵pass

使用 Docker Compose 部署 moontv