LunaTV Docker 部署教程：3 步启动自建影视聚合站

LunaTV Docker 部署教程3 步启动自建影视聚合站【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV电影站 A 有一部、站 B 有另一部进度还互不相通——LunaTV 就是为了解决这件事。它是一个可自建的影视聚合播放平台一次 Docker 部署就能把多个影视资源站合并成一个能搜索、能播放、收藏与进度跨端同步的站点。先认识LunaTV 能干什么一句话把分散的影视 API 资源站装进一个统一的网页播放器里。聚合多资源站一次搜索出结果在线播放支持选集与一键换源收藏、继续观看跨设备同步部署前环境自检开始之前花 1 分钟确认这三项能避开后面大部分坑检查项最低要求确认方式Docker 与 Compose均已安装终端执行版本命令两者都能正常输出版本号内存 / 磁盘≥1GB 内存、≥10GB 可用空间用系统自带的内存与磁盘查看命令确认网络能拉取 Docker 镜像随便拉一个测试镜像如 hello-world成功即可三步完成 LunaTV Docker 部署第 1 步保存 Docker 配置文件新建一个目录在里面保存docker-compose.yml内容如下services: moontv-core: image: ghcr.io/moontechlab/lunatv:latest container_name: moontv-core restart: on-failure ports: - 3000:3000 environment: - USERNAMEadmin - PASSWORD请改成你的强密码 - NEXT_PUBLIC_STORAGE_TYPEkvrocks - KVROCKS_URLredis://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:几个关键字段逐条说明imageLunaTV 主服务与 Kvrocks 数据库的官方镜像latest 会跟随最新版本ports3000 是对外访问端口被占用时改成8080:3000这种形式即可USERNAME/PASSWORD管理员账号密码别用默认值NEXT_PUBLIC_STORAGE_TYPEkvrocks决定收藏和播放记录存到哪里这里选 KvrocksKVROCKS_URL数据库容器的内网地址容器之间自动可达无需修改kvrocks-data数据卷把数据库文件写到磁盘重启不丢数据第 2 步一条命令启动 LunaTV 容器在配置文件所在目录执行docker-compose up -d→ 首次会自动拉取两个镜像等一两分钟再执行docker ps→ 两个容器状态都显示 Up说明 LunaTV 配置已生效、服务起来了。第 3 步浏览器访问验证打开http://localhost:3000→ 出现登录页说明服务已经在线远程服务器则把 localhost 换成服务器 IP。首次登录后台与存储后端登录页输入刚才设置的 USERNAME 和 PASSWORD进入管理后台对应源码 src/app/admin/page.tsx顺手核对三件事账号密码与配置文件一致能正常进入后台存储后端是 Kvrocks它协议兼容 Redis但数据落在磁盘上重启、升级都不丢Redis 有一定丢数据风险Upstash 适合纯云场景密码足够强实例地址不要公开传播⚙️ 接入播放源让站里有可播的内容部署完的 LunaTV 是个空壳这步是全文最关键的操作。入口在管理后台的「配置文件设置」核心是填写资源站的 API 地址LunaTV 播放源兼容标准苹果 CMS V10 API 格式即api.php/provide/vod这类接口任何提供该格式的资源站都能直接接入各字段含义见 README 配置章节。保存配置后回到首页影视内容就会加载出来。上线自测清单跑一遍下面 4 项全部通过才算部署完成测试项预期结果异常处理首页加载「继续观看」「热门电影」正常展示无内容 → 回后台检查播放源是否保存搜索影片返回聚合自多个资源站的结果无结果 → 逐个验证 API 地址是否可访问播放影片能起播右侧可换清晰度、换源某源黑屏 → 选另一个源或更新播放源收藏与进度刷新、换设备后进度保留丢失 → 检查存储后端与数据卷配置 常见问题排错速查现象原因解决办法端口被占用起不来3000 端口已有服务占用映射改为 8080:3000重启容器登录后台失败账号密码与配置不一致核对 USERNAME / PASSWORD 后重试首页没有任何内容播放源未配置或 API 地址失效后台填写有效的苹果 CMS V10 地址影片无法播放所选源链接失效用换源列表切换到其他资源站收藏进度丢失存储后端未持久化确认选 Kvrocks 且已挂数据卷收尾你的 LunaTV 自建站已就位到这里搜索、播放、收藏、进度同步这一整套就跑通了日常只需定期备份 kvrocks-data 数据卷。想进一步升级体验可以在手机上配合 Selene 客户端使用收藏与播放记录和网页端完全同步通勤路上也能接着看。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考