视频教程

如果你更喜欢通过视频学习，可以观看下面的教程。本篇博文的内容与视频同步，方便你边看边操作。

🚀 一、在飞牛 NAS 上部署 MoonTV

1. 创建项目文件夹

  1. 打开 文件管理
  2. 新建一个文件夹（例如 moontv）

2. 使用 Docker Compose 部署

  1. 打开 Docker → Compose
  2. 新建一个项目
    • 名称：随便取（例如 moontv）
    • 路径：选择刚才创建的 moontv 文件夹
  3. 将下面的 Compose 文件粘贴进去（请根据需要修改用户名和密码）：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
version: "3.8"

services:
  katelyatv:
    image: ghcr.io/katelya77/katelyatv:latest
    container_name: katelyatv
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - USERNAME=admin
      - PASSWORD=000000
      - NEXT_PUBLIC_STORAGE_TYPE=kvrocks
      - KVROCKS_URL=redis://kvrocks:6666
      - NEXT_PUBLIC_ENABLE_REGISTER=true
    depends_on:
      - kvrocks

  kvrocks:
    image: apache/kvrocks:latest
    container_name: kvrocks
    restart: unless-stopped
    ports:
      - "6666:6666"
    volumes:
      - kvrocks_data:/data

volumes:
  kvrocks_data:

⚠️ 注意：用户名和密码必须小写。
部署完成后，使用你设置的账号登录即可。

3. 添加视频源配置

  1. 登录 MoonTV 后，点击右上角的 管理面板

  2. 默认自带的几个视频源基本不可用

  3. 点击 导入 → 上传官方提供的源文件（可在项目页面获取）

到这里，飞牛 NAS 部署就完成了 ✅

🌐 二、在 Vercel 上部署 MoonTV

1. Fork 项目到自己的 GitHub

  • 打开 MoonTV 的 GitHub 页面

  • 点击右上角 Fork

2. 在 Vercel 部署

  1. 登录 Vercel 官网（使用 GitHub 账号登录）

  2. 点击 Add New Project

  3. 选择刚才 Fork 的仓库 → 点击 Import

  4. 添加以下环境变量（我会在视频简介/文档里提供）：

1
2
3
4
5
6
7
8
9
10
# 变量  
USERNAME=admin  
PASSWORD=your_password
NEXT_PUBLIC_STORAGE_TYPE=upstash 

 
UPSTASH_URL=https://xxx.upstash.io  
UPSTASH_TOKEN=your_token

然后点击 Deploy。

3. 配置数据库

  1. 打开 Supabase（或教程里指定的网站）

  2. 使用 Google 登录

  3. 创建一个数据库（区域建议选择亚洲节点）

  4. 复制数据库地址（HTTPS 版本）和 Token

  5. 回到 Vercel → 项目 Settings → 添加数据库地址和 Token

  6. Functions 区域建议改成亚洲节点

  7. 保存 → 重新部署

至此，MoonTV 已经在 Vercel 成功部署 ✅

📺 三、在 TVBox 中使用 JSON 地址

  1. 登录 MoonTV 管理页面 → 找到 TVBox 配置

  2. 复制提供的 JSON 地址

  3. 打开 TVBox → 配置地址 → 粘贴 JSON 地址

  4. 授权存储权限 → 确认

  5. 在 推荐 中将站点推荐改成「豆瓣热播」

现在就可以直接在 TVBox 中看视频了！ 🎉
（目前缺点：没有分类，需要搜索内容）

📝 总结

通过本教程你可以：

  • 在 飞牛 NAS（Docker Compose） 部署 MoonTV

  • 在 Vercel 免费部署 MoonTV

  • 生成 TVBox JSON 文件，直接在 TVBox 调用影视源

🔗 相关链接