【飞牛Docker系列】LunaTV部署教程（避坑版）—— 矿渣玩家专属影视聚合方案

[md]# 【飞牛Docker系列】LunaTV部署教程（避坑版）—— 矿渣玩家专属影视聚合方案

适合：飞牛FNOS用户、矿渣小主机玩家、Docker新手、影视爱好者
前置要求：飞牛NAS已安装Docker容器引擎（应用中心直接搜索安装，无脑下一步即可）
各位矿渣圈的兄弟姐妹们，本期飞牛Docker系列，专门给大家安排LunaTV的部署教程！之前很多人问我，LunaTV和MoonTV到底有啥区别，其实LunaTV是基于MoonTV深度二次开发的增强版，新增了YouTube集成、网盘搜索、AI推荐、短剧、IPTV直播等60+功能，可玩性更高。

不过重点提醒：LunaTV镜像比较混乱，很多新手容易踩坑，这篇教程全程实测，避开所有镜像、启动、播放相关的坑，不管你是刚入手飞牛的小白，还是折腾惯了矿渣的老玩家，跟着步骤走，5分钟就能部署成功！

## 一、先避坑：LunaTV核心注意事项（必看！）
很多人部署LunaTV失败，不是步骤错了，而是踩了这2个坑，提前记好，少走99%弯路：

- 镜像选择：优先用官方镜像 ghcr.io/moontechlab/lunatv:latest 或 ghcr.io/anzosen/lunatv:latest，避开非官方镜像，否则容易启动失败、源失效；

- 存储选择：个人使用优先Redis存储（简单易部署），追求稳定性可选Kvrocks存储（高性能、持久化更好），新手先从Redis入手即可；

- 端口冲突：默认端口3000，若被MoonTV、Jellyfin等占用，直接修改端口即可，无需复杂配置。

## 二、前置准备（2步搞定，新手无压力）

### 1. 安装Docker（已安装的跳过）

打开飞牛NAS → 应用中心 → 搜索“Docker容器引擎” → 点击安装，等待1-2分钟，安装完成后，Docker图标会出现在应用列表，点击打开即可。

### 2. 创建存储目录（避免数据丢失）

LunaTV的配置、缓存数据需要单独存放，重启容器后数据才不会丢失，步骤如下：

- 打开飞牛“文件管理器” → 进入根目录，新建文件夹 docker（若已有则跳过）；

- 在docker文件夹内，再新建文件夹 lunatv，用于存放LunaTV的所有数据；

- 记住目录路径：/docker/lunatv，后续部署会用到。

## 三、核心部署步骤（两种方案，新手选方案一）

推荐用Docker Compose部署（最稳、最省心），同时提供两种存储方案，新手优先选方案一（Redis存储），进阶玩家可选方案二（Kvrocks存储）。
###
### 方案一：Redis存储（新手首选，简单易部署）

#### 步骤1：新建Compose项目

打开飞牛Docker → 点击左侧“Compose” → 点击“新增项目”，填写以下信息：

- 项目名称：lunatv（自定义，建议用这个，方便后续管理）；

- 项目路径：点击“选择”，找到之前创建的 /docker/lunatv 目录，选中确认；

- 勾选“创建后立即启动”（后续无需手动启动，省一步）。
####
#### 步骤2：粘贴Compose配置（只改密码，其他不动）
####
在“Compose文件”输入框中，粘贴以下配置，仅修改密码（其他配置新手无需改动，避免出错）：

```
version: '3'
services:
  lunatv-core:
    image: ghcr.io/moontechlab/lunatv:latest  # 官方镜像，稳定不翻车
    container_name: lunatv-core
    restart: unless-stopped  # 容器异常自动重启，省心
    ports:
      - '3000:3000'  # 端口映射，左侧为主机端口，冲突可改为13000:3000等
    environment:
      - USERNAME=admin  # 登录账号，可自定义，默认admin即可
      - PASSWORD=your_strong_password  # 必改！设置你的强密码，避免简单密码
      - NEXT_PUBLIC_STORAGE_TYPE=redis  # 存储类型为Redis
      - REDIS_URL=redis://lunatv-redis:6379  # 连接Redis服务
    networks:
      - lunatv-network
    depends_on:
      - lunatv-redis  # 依赖Redis，先启动Redis再启动LunaTV

  lunatv-redis:
    image: redis:alpine  # 轻量Redis镜像，适合矿渣/飞牛
    container_name: lunatv-redis
    restart: unless-stopped
    networks:
      - lunatv-network
    volumes:
      - ./redis-data:/data  # 持久化Redis数据，重启不丢失

networks:
  lunatv-network:
    driver: bridge
```

修改说明：将 your_strong_password 替换成你自己的密码（比如123456a@，建议包含字母+数字+符号，更安全）。
步骤3：启动容器，等待部署完成

点击“创建”，飞牛会自动拉取LunaTV和Redis镜像，这个过程取决于你的网络速度，一般1-3分钟（网络慢的话耐心等，不要中途停止）。

当Docker界面中，“lunatv”项目的状态显示“运行中”，且两个容器（lunatv-core、lunatv-redis）都显示“运行中”，说明部署成功！

### 方案二：Kvrocks存储（进阶可选，更稳定）

如果想追求更高的稳定性，避免Redis偶尔丢数据的情况，可选择Kvrocks存储（高性能缓存系统），步骤和方案一一致，仅替换Compose配置：

```
version: '3'
services:
  lunatv-core:
    image: ghcr.io/moontechlab/lunatv:latest
    container_name: lunatv-core
    restart: unless-stopped
    ports:
      - '3000:3000'
    environment:
      - USERNAME=admin
      - PASSWORD=your_strong_password  # 必改密码
      - NEXT_PUBLIC_STORAGE_TYPE=kvrocks  # 存储类型改为Kvrocks
      - KVROCKS_URL=redis://lunatv-kvrocks:6666  # 连接Kvrocks服务
    networks:
      - lunatv-network
    depends_on:
      - lunatv-kvrocks

  lunatv-kvrocks:
    image: apache/kvrocks
    container_name: lunatv-kvrocks
    restart: unless-stopped
    volumes:
      - kvrocks-data:/var/lib/kvrocks  # 持久化Kvrocks数据
    networks:
      - lunatv-network

networks:
  lunatv-network:
    driver: bridge
volumes:
  kvrocks-data:

```

## 四、访问与基础设置（部署完成必做）
### 1. 访问LunaTV

打开电脑/手机浏览器，输入地址：http://你的飞牛IP:3000（比如飞牛IP是192.168.1.100，就输入http://192.168.1.100:3000）。

输入账号（admin）和你设置的密码，点击登录，即可进入LunaTV首页。

### 2. 基础设置（提升体验，必做）

- 完善个人信息：登录后，点击右上角头像 → 个人设置，可修改账号、密码，开启/关闭注册功能（建议关闭，避免他人访问）；

- 配置豆瓣代理（可选）：为了更好的影视信息展示，可在环境变量中添加两条配置（编辑Compose文件，在environment中新增）：
        
NEXT_PUBLIC_DOUBAN_PROXY_TYPE=cmliussss-cdn-tencent
NEXT_PUBLIC_DOUBAN_IMAGE_PROXY_TYPE=cmliussss-cdn-tencent

- 测试播放：首页搜索任意影片，点击播放，若无法播放，切换播放源即可（LunaTV支持多源切换，总有可用源）。

## 五、新手常见问题（论坛高频坑，逐一解决）

### 1. 容器启动失败，日志显示“镜像拉取失败”？

原因：网络问题，无法拉取GitHub镜像。解决方法：飞牛Docker设置国内镜像加速器（比如阿里云加速器），重启Docker后，重新部署即可。

### 2. 能访问登录页，但登录失败？

原因：密码设置错误，或Redis/Kvrocks未正常启动。解决方法：① 检查Compose文件中密码是否正确；② 查看Redis/Kvrocks容器是否运行，若未运行，重启容器即可。

### 3. 播放影片提示“无播放源”？

原因：LunaTV本身不存储视频，仅聚合第三方源，部分源可能失效。解决方法：点击播放页的“换源”按钮，切换其他源，一般就能正常播放；也可在后台配置苹果CMS V10 API格式的播放源。

### 4. 端口冲突，启动失败？

解决方法：修改Compose文件中“ports”字段的左侧端口，比如将3000:3000改为13000:3000，保存后重新启动项目即可。

### 5. 重启容器后，收藏、播放记录丢失？

原因：未开启数据持久化。解决方法：检查Compose文件中，Redis/Kvrocks的volumes配置是否正确（参考教程中的配置），确保数据目录挂载成功。

### 六、进阶玩法（矿渣玩家可选）

- 内网穿透：通过frp、Nginx等工具，实现外网访问LunaTV，随时随地看影视；

- 多设备同步：手机、电视、盒子直接打开浏览器访问飞牛IP+端口，即可同步收藏、播放记录；

- 功能扩展：探索LunaTV的增强功能，比如YouTube集成、IPTV直播、网盘搜索等，具体可参考官方文档；

- 版本更新：执行命令 docker-compose pull && docker-compose up -d，即可更新LunaTV到最新版本，获取更多新功能。

## 七、教程总结（矿渣玩家必看）

LunaTV作为MoonTV的增强版，功能更丰富，适合喜欢折腾、追求更多玩法的矿渣/飞牛用户。部署的核心是“选对镜像、做好持久化”，避开非官方镜像的坑，新手按方案一（Redis存储）操作，基本不会翻车。

本文教程全程在飞牛NAS实测可用，所有步骤都简化到最易懂，哪怕是第一次用Docker的新手，跟着走也能成功。如果部署过程中遇到其他问题，评论区留言，我会逐一回复！

下期预告：飞牛Docker部署Jellyfin，实现海报墙+硬件硬解，敬请关注！

⚠️ 重要声明：本教程仅用于学习交流，LunaTV仅聚合第三方影视资源，不存储任何视频文件，请勿用于商业用途，使用产生的法律责任由使用者自行承担。

[/md]

感谢大佬的分享      

这种项目其实很多的，但是依然依赖源

ajeef 发表于 2026-5-22 11:18
这种项目其实很多的，但是依然依赖源

源也很多，这东西本来就是 开源的