MoonTV 搭建教程

2026-06-18T00:00:00.000Z

本文面向想在自有服务器上搭建 MoonTV 影视聚合播放器的用户，涵盖 Docker Compose 部署与 Upstash 云端存储配置。
适用系统： Linux（推荐 Debian / Ubuntu）
适用平台： 云服务器 / 本地 NAS / 家庭服务器

前言#

🎬 MoonTV 是一个开箱即用的、跨平台的影视聚合播放器。它基于 Next.js 14 + Tailwind CSS + TypeScript 构建，支持多资源搜索、在线播放、收藏同步、播放记录、云端存储。

本文将使用 Docker Compose + Upstash 的方式来搭建 MoonTV，无需自建数据库，数据存储在云端。

Note

本文参考了 lunatv-config 项目的配置说明。

功能特性#

🔍 多源聚合搜索：一次搜索立刻返回全源结果
📄 丰富详情页：支持剧集列表、演员、年份、简介等完整信息展示
▶️ 流畅在线播放：集成 HLS.js & ArtPlayer
❤️ 收藏 + 继续观看：支持云端存储，多端同步进度
📱 PWA：离线缓存、安装到桌面/主屏，移动端原生体验
🌗 响应式布局：桌面侧边栏 + 移动底部导航，自适应各种屏幕尺寸

Warning

部署后项目为空壳项目，无内置播放源和直播源，需要自行收集配置。

前置条件#

在开始之前，请确保你已准备好以下环境：

一台可访问的服务器（VPS、NAS、家庭服务器等）
已安装 Docker 和 Docker Compose
一个 Upstash 账号（注册地址）

第一步：注册 Upstash#

访问 Upstash 官网并注册账号
登录后，点击 Create Database

Create Database
选择 Redis 类型，名称随意填写
创建完成后，在数据库详情页找到以下信息：

查看详情
- HTTPS 点击复制（形如 https://xxx.upstash.io）
- TOKEN 点击复制（认证令牌）

Tip

请妥善保存这两个信息，后续配置需要用到。

第二步：创建 Docker Compose 配置文件#

在你的服务器上创建项目目录：

Terminal window

1
mkdir moontv && cd moontv

一键创建并写入 docker-compose.yml 文件并启动 (需要替换环境变量为自己的)：

Terminal window展开收起

1
cat > docker-compose.yml <<EOF && docker compose up -d
2
services:
3
  moontv-core:
4
    image: ghcr.io/moontechlab/lunatv:latest
5
    container_name: moontv-core
6
    restart: on-failure
7
    ports:
8
      - '33000:3000'
9
    environment:
10
      - USERNAME=admin
11
      - PASSWORD=admin_password
12
      - NEXT_PUBLIC_STORAGE_TYPE=upstash
13
      - UPSTASH_URL=https://你的HTTPS_ENDPOINT
14
      - UPSTASH_TOKEN=你的TOKEN
15
EOF

展开收起

第三步：配置环境变量#

请将以下环境变量替换为你自己的值：

变量	说明
`container_name`	容器名称
`USERNAME`	管理员账号（自定义）
`PASSWORD`	管理员密码（自定义）
`NEXT_PUBLIC_STORAGE_TYPE`	存储类型，固定为 `upstash`
`UPSTASH_URL`	Upstash 的 HTTPS ENDPOINT
`UPSTASH_TOKEN`	Upstash 的 TOKEN

Important

请务必修改 USERNAME 和 PASSWORD，使用强密码以保障安全。

第四步：启动服务#

运行以下命令启动 MoonTV：

Terminal window

1
docker compose up -d

查看容器状态：

Terminal window

1
docker compose ps

查看日志：

Terminal window

1
docker compose logs -f

启动成功后，访问 http://你的服务器IP:33000 即可打开 MoonTV。

第五步：配置播放源#

Caution

部署完成后为空壳应用，无播放源，需要在管理后台配置。

访问你的 MoonTV 地址
使用设置的管理员账号密码登录
进入管理后台的 配置文件 设置
添加播放源配置

配置文件格式示例(可直接用)：

1
{
2
  "cache_time": 7200,
3
  "api_site": {
4
    "iqiyizyapi.com": {
5
      "name": "🎬-爱奇艺-",
6
      "api": "https://iqiyizyapi.com/api.php/provide/vod",
7
      "detail": "https://iqiyizyapi.com"
8
    },
9
    "mtzy.me": {
10
      "name": "🎬茅台资源",
11
      "api": "https://caiji.maotaizy.cc/api.php/provide/vod",
12
      "detail": "https://mtzy.me"
13
    },
14
    "wolongzyw.com": {
15
      "name": "🎬卧龙资源",
16
      "api": "https://wolongzyw.com/api.php/provide/vod",
17
      "detail": "https://wolongzyw.com"
18
    },
19
    "ikunzy.com": {
20
      "name": "🎬iKun资源",
21
      "api": "https://ikunzyapi.com/api.php/provide/vod",
22
      "detail": "https://ikunzy.com"
23
    },
24
    "dyttzyapi.com": {
25
      "name": "🎬电影天堂",
26
      "api": "http://caiji.dyttzyapi.com/api.php/provide/vod",
27
      "detail": "http://caiji.dyttzyapi.com"
28
    },
29
    "www.maoyanzy.com": {
30
      "name": "🎬猫眼资源",
31
      "api": "https://api.maoyanapi.top/api.php/provide/vod",
32
      "detail": "https://www.maoyanzy.com"
33
    },
34
    "cj.lzcaiji.com": {
35
      "name": "🎬量子资源",
36
      "api": "https://cj.lzcaiji.com/api.php/provide/vod",
37
      "detail": "https://cj.lzcaiji.com"
38
    },
39
    "360zy.com": {
40
      "name": "🎬360 资源",
41
      "api": "https://360zyzz.com/api.php/provide/vod",
42
      "detail": "https://360zy.com"
43
    },
44
    "jszyapi.com": {
45
      "name": "🎬极速资源",
46
      "api": "https://jszyapi.com/api.php/provide/vod",
47
      "detail": "https://jszyapi.com"
48
    },
49
    "www.moduzy.net": {
50
      "name": "🎬魔都资源",
51
      "api": "https://www.mdzyapi.com/api.php/provide/vod",
52
      "detail": "https://www.moduzy.net"
53
    },
54
    "ffzyapi.com": {
55
      "name": "🎬非凡资源",
56
      "api": "https://api.ffzyapi.com/api.php/provide/vod",
57
      "detail": "https://cj.ffzyapi.com"
58
    },
59
    "bfzy.tv": {
60
      "name": "🎬暴风资源",
61
      "api": "https://bfzyapi.com/api.php/provide/vod",
62
      "detail": "https://bfzy.tv"
63
    },
64
    "zuida.xyz": {
65
      "name": "🎬最大资源",
66
      "api": "https://api.zuidapi.com/api.php/provide/vod",
67
      "detail": "https://zuida.xyz"
68
    },
69
    "wujinzy.me": {
70
      "name": "🎬无尽资源",
71
      "api": "https://api.wujinapi.me/api.php/provide/vod",
72
      "detail": "https://wujinzy.com"
73
    },
74
    "xinlangapi.com": {
75
      "name": "🎬新浪资源",
76
      "api": "https://api.xinlangapi.com/xinlangapi.php/provide/vod",
77
      "detail": "https://xinlangapi.com"
78
    },
79
    "api.wwzy.tv": {
80
      "name": "🎬旺旺资源",
81
      "api": "https://api.wwzy.tv/api.php/provide/vod",
82
      "detail": "https://api.wwzy.tv"
83
    },
84
    "www.subozy.com": {
85
      "name": "🎬速播资源",
86
      "api": "https://subocaiji.com/api.php/provide/vod",
87
      "detail": "https://www.subozy.com"
88
    },
89
    "jinyingzy.com": {
90
      "name": "🎬金鹰点播",
91
      "api": "https://jinyingzy.com/api.php/provide/vod",
92
      "detail": "https://jinyingzy.com"
93
    },
94
    "p2100.net": {
95
      "name": "🎬飘零资源",
96
      "api": "https://p2100.net/api.php/provide/vod",
97
      "detail": "https://p2100.net"
98
    },
99
    "api.ukuapi88.com": {
100
      "name": "🎬U酷影视",
101
      "api": "https://api.ukuapi88.com/api.php/provide/vod",
102
      "detail": "https://www.ukuzy.com"
103
    },
104
    "api.guangsuapi.com": {
105
      "name": "🎬光速资源",
106
      "api": "https://api.guangsuapi.com/api.php/provide/vod",
107
      "detail": "https://api.guangsuapi.com"
108
    },
109
    "www.hongniuzy.com": {
110
      "name": "🎬红牛资源",
111
      "api": "https://www.hongniuzy2.com/api.php/provide/vod",
112
      "detail": "https://www.hongniuzy.com"
113
    },
114
    "caiji.moduapi.cc": {
115
      "name": "🎬魔都动漫",
116
      "api": "https://caiji.moduapi.cc/api.php/provide/vod",
117
      "detail": "https://caiji.moduapi.cc"
118
    },
119
    "www.ryzyw.com": {
120
      "name": "🎬如意资源",
121
      "api": "https://pz.v88.qzz.io/?url=https://cj.rycjapi.com/api.php/provide/vod",
122
      "detail": "https://www.ryzyw.com"
123
    },
124
    "www.haohuazy.com": {
125
      "name": "🎬豪华资源",
126
      "api": "https://pz.v88.qzz.io/?url=https://hhzyapi.com/api.php/provide/vod",
127
      "detail": "https://www.haohuazy.com"
128
    },
129
    "bdzy1.com": {
130
      "name": "🎬百度云zy",
131
      "api": "https://pz.v88.qzz.io/?url=https://api.apibdzy.com/api.php/provide/vod",
132
      "detail": "https://bdzy1.com"
133
    },
134
    "lovedan.net": {
135
      "name": "🎬艾旦影视",
136
      "api": "https://pz.v88.qzz.io/?url=https://lovedan.net/api.php/provide/vod",
137
      "detail": "https://lovedan.net"
138
    }
139
  }
140
}

展开收起

订阅功能#

将完整的配置文件进行 base58 编码后提供 HTTP 服务，即为订阅链接，可在 MoonTV 后台使用。

1
https://pz.v88.qzz.io?format=2&source=jin18转

或者中转连接：

1
https://pz.v88.qzz.io?format=3&source=jin18

常见问题#

Q: 如何修改端口？#

修改 docker-compose.yml 中的端口映射：

1
ports:
2
  - '8080:3000'  # 将 33000 改为你想要的端口

XGiao博客

MoonTV 搭建教程

前言#

功能特性#

前置条件#

第一步：注册 Upstash#

第二步：创建 Docker Compose 配置文件#

第三步：配置环境变量#

第四步：启动服务#

第五步：配置播放源#

订阅功能#

常见问题#

Q: 如何修改端口？#

Q: 如何备份数据？#