项目简介
MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建,支持多资源搜索、在线播放、收藏同步、播放记录、本地/云端存储,让你可以随时随地畅享海量免费影视内容。
✨ 功能特性
-
🔍 多源聚合搜索:内置数十个免费资源站点,一次搜索立刻返回全源结果。 -
📄 丰富详情页:支持剧集列表、演员、年份、简介等完整信息展示。 -
▶️ 流畅在线播放:集成 HLS.js & ArtPlayer。 -
❤️ 收藏 + 继续观看:Docker 部署支持 Redis 存储,多端同步进度。 -
📱 PWA:离线缓存、安装到桌面/主屏,移动端原生体验。 -
🌗 响应式布局:桌面侧边栏 + 移动底部导航,自适应各种屏幕尺寸。 -
🚀 极简部署:一条 Docker 命令即可将完整服务跑起来,或免费部署到 Vercel。 -
👿 智能去广告:自动跳过视频中的切片广告(实验性)
部署
本项目支持 Vercel、Docker 和 Cloudflare 部署。
Vercel 部署
推荐使用,零运维成本,免费额度足够个人使用。
-
Fork 本仓库到你的 GitHub 账户。 -
登陆 Vercel,点击 Add New → Project,选择 Fork 后的仓库。 -
(强烈建议)设置 PASSWORD 环境变量。 -
保持默认设置完成首次部署。 -
如需自定义 config.json
,请直接修改 Fork 后仓库中该文件。 -
每次 Push 到 main
分支将自动触发重新构建。
部署完成后即可通过分配的域名访问,也可以绑定自定义域名。
Cloudflare 部署
-
Fork 本仓库到你的 GitHub 账户。 -
登陆 Cloudflare,点击 计算(Workers)-> Workers 和 Pages,点击创建 -
选择 Pages,导入现有的 Git 存储库,选择 Fork 后的仓库 -
构建命令填写 pnpm install –frozen-lockfile && pnpm run pages:build,预设框架为无,构建输出目录保持空 -
保持默认设置完成首次部署。 -
(强烈建议)首次部署完成后进入设置,新增 PASSWORD 密钥(变量和机密下),而后重试部署。 -
如需自定义 config.json
,请直接修改 Fork 后仓库中该文件。 -
每次 Push 到 main
分支将自动触发重新构建。
Docker 部署
适用于自建服务器 / NAS / 群晖等场景。
1. 直接运行(最简单)
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
# 拉取预构建镜像
docker pull ghcr.io/senshinya/moontv:latest
# 运行容器
# -d: 后台运行 -p: 映射端口 3000 -> 3000
docker run -d --name moontv -p 3000:3000 ghcr.io/senshinya/moontv:latest
访问 http://服务器 IP:3000
即可。
Docker Compose 最佳实践
若你使用 docker compose 部署,以下是一些 compose 示例
local storage 版本
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
services:
moontv:
image: ghcr.io/senshinya/moontv:latest
container_name: moontv
restart: unless-stopped
ports:
- '3000:3000'
environment:
- PASSWORD=your_password
# 如需自定义配置,可挂载文件
# volumes:
# - ./config.json:/app/config.json:ro
Redis 版本(推荐,多账户数据隔离,跨设备同步)
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
services:
moontv-core:
image: ghcr.io/senshinya/moontv:latest
container_name: moontv
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
container_name: moontv-redis
restart: unless-stopped
networks:
- moontv-network
# 如需持久化
# volumes:
# - ./data:/data
networks:
moontv-network:
driver: bridge
项目地址
https://github.com/senshinya/MoonTV/blob/main/README.md
扫码加入技术交流群,备注「开发语言-城市-昵称」
(文:GitHubStore)