LunaTV 影视聚合播放器 Docker 部署指南：3 步 5 分钟跑起私有影视站

LunaTV 影视聚合播放器 Docker 部署指南3 步 5 分钟跑起私有影视站【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV找一部剧要翻好几个站本地收藏动不动就失效换台电脑观看记录全丢。LunaTV 是基于 Next.js 14 的开源影视聚合播放器把多源搜索、在线播放、跨端收藏与观看记录同步收进一个服务里。这篇带你用 Docker 跑通完整部署一份 compose 文件、一条启动命令外加页面空白时的排障路线。开工前花 30 秒自检的 3 件事自检项怎么查达标线Docker 与 Compose 可用终端敲docker compose version能打印出版本号机器资源够看内存与磁盘剩余至少 1GB 内存、10GB 空闲磁盘端口没被占lsof -i:3000没有任何输出三项全过再往下走否则部署到一半会在同一堵墙前卡住。3 步跑起 LunaTV一份 compose 文件加一条启动命令第 1 步写下 compose 文件。新建docker-compose.yml两个容器应用本体加 Kvrocks 存储镜像构建过程可看 Docker 构建定义services: moontv-core: image: ghcr.io/moontechlab/lunatv:latest container_name: moontv-core ports: - 3000:3000 environment: - USERNAMEadmin - PASSWORD你的强密码 - NEXT_PUBLIC_STORAGE_TYPEkvrocks - KVROCKS_URLredis://moontv-kvrocks:6666 # ...其余字段保持默认... depends_on: [moontv-kvrocks] moontv-kvrocks: image: apache/kvrocks container_name: moontv-kvrocks volumes: - kvrocks-data:/var/lib/kvrocks volumes: kvrocks-data:四个关键参数的填法参数填什么为什么3000:3000左侧随意右侧固定 3000容器服务固定监听 3000只改宿主机这一侧USERNAME/PASSWORD自定义账号加强密码管理面板唯一入口靠环境变量注入NEXT_PUBLIC_STORAGE_TYPEkvrocks决定用哪个存储驱动KVROCKS_URLredis://moontv-kvrocks:6666同一 compose 网络内用服务名当主机名不能写 localhost第 2 步一条命令启动。在文件所在目录执行docker compose up -d。首次要拉两个镜像等一两分钟执行完用docker compose ps看两个容器都显示running就算过关。第 3 步浏览器验证。打开http://localhost:3000出现登录页说明主线流程走完了。首跑检查清单部署完立刻核对这 5 件✅ 用刚设置的账号进入管理面板能看到播放源配置入口✅ 搜索框先别急着试未填播放源时返回空是空壳特性不算故障✅ 随便播完一部片退出回首页能在继续观看里看到它✅docker compose restart之后再刷页面收藏和记录仍在证明卷挂对了✅docker compose logs moontv-core | tail -20里没有反复刷的错误配置深水区必配、推荐配、可选配各做什么必配不配跑不通USERNAME/PASSWORD漏了就没有管理面板入口也没有事后找回流程。存储地址KVROCKS_URL或 Redis 的REDIS_URL、Upstash 的两项漏了容器照起但收藏和观看记录全写不进去。播放源在管理面板填入苹果 CMS V10 格式的 API 地址参考 管理后台源码。不填整站就是个空壳。推荐配不配能跑但体验打折豆瓣数据代理NEXT_PUBLIC_DOUBAN_PROXY_TYPE与NEXT_PUBLIC_DOUBAN_IMAGE_PROXY_TYPE设为cmliussss-cdn-tencent。不配走内置默认站外网络下海报和详情页偶尔加载失败。数据卷kvrocks-data:/var/lib/kvrocks上面文件里这一行不能删漏挂等于每次重启清空全部数据。可选配按需NEXT_PUBLIC_SITE_NAME改站点名端口映射左侧可改 3001 等任意空闲端口。存储选型Kvrocks 稳定Redis 有丢数据风险Upstash 适合只上云不挂本地卷的场景。新手最容易踩的 5 个坑与解法端口 3000 被占lsof -i:3000看是谁占着把映射左侧改成3001:3000用新端口访问右侧保持 3000。容器起来了页面却空白先docker logs -f moontv-core看日志最常见是存储容器没起来或KVROCKS_URL里的服务名和实际对不上。重启后数据全没卷没挂或路径写错Kvrocks 的数据目录是/var/lib/kvrocks挂错目录等于没挂。密码忘了账号由环境变量注入改USERNAME/PASSWORD后docker compose up -d重建容器即可。想换存储后端先在管理面板导出数据再改STORAGE_TYPE和对应地址新旧数据不清理会互相干扰。扩展移动端、备份与更新移动端PWA 可直接装到手机桌面桌面端和移动端共用同一套数据。备份定期备份kvrocks-data卷管理面板另有一键导出。更新docker compose pull docker compose up -d切到新版数据卷不动。下一步就一件事打开管理面板把播放源地址填进去就能试播了。跑通之后记得把数据卷备份一次心里才踏实。【免费下载链接】LunaTV本项目采用 CC BY-NC-SA 协议禁止任何商业化行为任何衍生项目必须保留本项目地址并以相同协议开源项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考