一、项目简介
MoonTV是由社区开发者打造的跨平台影视聚合播放器，支持Web端、移动端及Android TV设备使用。项目采用Next.js
14作为前端框架，配合Tailwind
CSS实现响应式布局，使用TypeScript提升代码可维护性。它的核心功能是通过聚合多个免费资源站点，为用户提供统一的观影入口，同时支持播放记录、收藏同步、智能去广告等实用功能。
二、项目优势
1、多源聚合搜索，省去四处翻站的麻烦
MoonTV内置了数十个免费资源站点，用户只需输入关键词，就能立刻返回全站搜索结果。比如想找2023年的新片，系统会同时从多个站点抓取相关资源，避免了传统方式下“大海捞针”的尴尬。
2、流畅在线播放体验
不同于传统影视网站需要跳转到第三方页面，MoonTV直接集成ArtPlayer播放器与HLS.js技术，支持流畅的视频播放。无论是1080P还是4K蓝光资源，都能在浏览器中稳定加载，而且播放过程中还能自动跳过切片广告（实验性功能）。
3、响应式布局，适配所有屏幕尺寸
MoonTV的界面设计非常人性化，电脑端采用侧边栏布局，移动端则切换为底部导航栏，最大程度适应不同设备。而且PWA功能支持离线缓存，用户即使断网也能继续观影，还能直接安装到桌面或主屏，体验堪比原生应用。
4、云同步功能，跨设备追剧无压力
如果你用的是Docker部署方式，MoonTV还能支持Redis作为存储后端。这意味着你的收藏夹、播放记录和观看进度可以实时同步到多个设备。比如在手机上看到一半，直接到电视上继续看，完全不需要手动记录。
三、部署流程
MoonTV支持多种部署方式，老铁们可以根据需求选择适合自己的方案。
· 推荐部署方式：Docker一键启动
如果你有一台NAS、群晖或者自建服务器，推荐使用Docker部署。只需要一条命令就能启动完整服务，而且配置灵活。
· 本地存储版（最简单）
· 拉取镜像
docker pull ghcr.io/senshinya/moontv:latest· 运行容器
docker run -d --name moontv -p 3000:3000 ghcr.io/senshinya/moontv:latest访问地址： http://服务器IP:3000 ，就能直接使用。
· Redis版（推荐）
如果你希望实现多账户数据隔离，或者在多设备间同步观看进度，建议使用Redis版本的部署方式。需要同时启动Redis容器：
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
moontv-redis:
image:redis
container_name:moontv-redis
restart:unless-stopped
networks:
-moontv-network
volumes:
-./data:/data· 其他部署方式
如果你想用Vercel部署，只需要Fork仓库并设置 PASSWORD
环境变量即可，系统会自动完成后续步骤。Cloudflare部署则需要导入仓库并配置构建命令，但整体流程和Vercel类似。
四、使用展示
1、如何搜索影视资源
部署完成后，老铁们可以在首页输入关键词进行搜索。比如输入“肖申克的救赎”，系统会自动从内置资源站点抓取相关视频资源，并展示片名、年份、简介、演员信息等。还能直接看到不同站点提供的观看链接，操作非常直观。
2、收藏与继续观看功能
如果你发现某部电影特别好，可以直接点击“收藏”按钮，之后就能在收藏夹里快速找到。支持Redis存储的小伙伴还能在不同设备间同步播放进度，比如在手机上看一半，切换到电视上还能继续观看。
3、多平台使用演示
MoonTV支持Web端、移动端和Android
TV设备使用。移动端使用时，PWA功能让老铁们可以离线观看，安装到桌面上就像本地软件一样方便。Android
TV用户则可以把它当作OrionTV的后端，实现更流畅的观影体验。
五、总结
MoonTV确实是一个非常实用的工具，尤其适合Docker爱好者和喜欢折腾技术的老铁们。它用极简的部署流程解决了传统影视聚合网站的痛点，无论是多源搜索、播放流媒体，还是跨平台同步，都能满足大部分需求。不过需要提醒的是，项目提供的资源均来自第三方网站，老铁们在使用时要注意遵守相关法律法规，避免造成不必要的麻烦。