619 字

2 分钟

MoonTVPlus 影视聚合播放器 Docker 部署教程

2026-08-26

Server

Docker

/

影视

MoonTVPlus 影视聚合播放器 Docker 部署教程#

简介#

MoonTVPlus 是基于 MoonTV v100 二次开发的增强版影视聚合播放器。相比原版，它新增了外部播放器跳转、视频超分（Anime4K）、弹幕系统、豆瓣评论抓取、观影室、服务器离线下载、私人影库等实用功能。

WARNING
部署后的项目是一个空壳，不内置任何播放源与直播源，需要站长在管理后台自行配置资源站接口。且项目声明仅供个人学习使用，请勿公开分享实例或在中国大陆地区提供服务。

技术栈#

分类	主要依赖
前端框架	Next.js 14（App Router）
样式	Tailwind CSS 3
语言	TypeScript 4
播放器	ArtPlayer · HLS.js
部署	Docker · Vercel · Netlify · Cloudflare Workers · EdgeOne Pages

Docker 部署#

官方镜像为 ghcr.io/mtvpls/moontvplus:latest，默认端口 3000。存储后端支持 Kvrocks（推荐）、SQLite、Redis、Upstash 等，通过环境变量 NEXT_PUBLIC_STORAGE_TYPE 切换。

Kvrocks 存储（推荐）#

1
services:
2
  moontv-core:
3
    image: ghcr.io/mtvpls/moontvplus:latest
4
    container_name: moontv-core
5
    restart: on-failure
6
    ports:
7
      - '3000:3000'
8
    environment:
9
      - USERNAME=admin
10
      - PASSWORD=admin_password
11
      - NEXT_PUBLIC_STORAGE_TYPE=kvrocks
12
      - KVROCKS_URL=redis://moontv-kvrocks:6666
13
    networks:
14
      - moontv-network
15
    depends_on:
16
      - moontv-kvrocks
17
  moontv-kvrocks:
18
    image: apache/kvrocks
19
    container_name: moontv-kvrocks
20
    restart: unless-stopped
21
    volumes:
22
      - kvrocks-data:/var/lib/kvrocks/db
23
    networks:
24
      - moontv-network
25
networks:
26
  moontv-network:
27
    driver: bridge
28
volumes:
29
  kvrocks-data:

NOTE
若自行指定 kvrocks-data 宿主机目录，需将该目录权限调整为 777，否则可能导致数据库创建失败。

SQLite 存储#

1
services:
2
  moontv-core:
3
    image: ghcr.io/mtvpls/moontvplus:latest
4
    container_name: moontv-core
5
    restart: on-failure
6
    ports:
7
      - '3000:3000'
8
    environment:
9
      - USERNAME=admin
10
      - PASSWORD=admin_password
11
      - NEXT_PUBLIC_STORAGE_TYPE=d1
12
      - SQLITE_DB_PATH=/app/.data/moontv.db
13
    volumes:
14
      - ./data:/app/.data

Redis 存储#

1
services:
2
  moontv-core:
3
    image: ghcr.io/mtvpls/moontvplus:latest
4
    container_name: moontv-core
5
    restart: on-failure
6
    ports:
7
      - '3000:3000'
8
    environment:
9
      - USERNAME=admin
10
      - PASSWORD=admin_password
11
      - NEXT_PUBLIC_STORAGE_TYPE=redis
12
      - REDIS_URL=redis://moontv-redis:6379
13
    networks:
14
      - moontv-network
15
    depends_on:
16
      - moontv-redis
17
  moontv-redis:
18
    image: redis:alpine
19
    container_name: moontv-redis
20
    restart: unless-stopped
21
    networks:
22
      - moontv-network
23
    volumes:
24
      - ./data:/data
25
networks:
26
  moontv-network:
27
    driver: bridge

WARNING
Redis 存储有一定丢数据风险，请务必开启持久化（如上挂载 ./data），否则升级/重启后数据可能丢失。

Upstash 存储#

在 Upstash 注册并新建 Redis 实例。
复制其 HTTPS ENDPOINT 与 TOKEN。
使用如下 docker-compose.yml：

1
services:
2
  moontv-core:
3
    image: ghcr.io/mtvpls/moontvplus:latest
4
    container_name: moontv-core
5
    restart: on-failure
6
    ports:
7
      - '3000:3000'
8
    environment:
9
      - USERNAME=admin
10
      - PASSWORD=admin_password
11
      - NEXT_PUBLIC_STORAGE_TYPE=upstash
12
      - UPSTASH_URL=上面 https 开头的 HTTPS ENDPOINT
13
      - UPSTASH_TOKEN=上面的 TOKEN

Lite 镜像说明#

ghcr.io/mtvpls/moontvplus-lite:latest 体积更小，但不支持内置观影室服务，也不支持 SQLite（d1）自动初始化。其余用法与标准镜像一致。

环境变量要点#

变量	说明	必填
`USERNAME`	站长账号	是
`PASSWORD`	站长密码	是
`NEXT_PUBLIC_STORAGE_TYPE`	存储方式：`redis`/`kvrocks`/`upstash`/`d1`/`turso`/`postgres`	是
`KVROCKS_URL` / `REDIS_URL` / `UPSTASH_URL` / `TURSO_URL`	对应存储连接地址	视存储类型
`NEXT_PUBLIC_SITE_NAME`	站点名称（默认 MoonTV）	否
`ANNOUNCEMENT`	站点公告	否
`INIT_CONFIG`	初始配置（JSON，含 `api_site`/`custom_category`/`lives`）	否

初始化播放源配置#

启动后进入管理后台的「配置文件」设置，填写资源站。示例：

1
{
2
  "cache_time": 7200,
3
  "api_site": {
4
    "dyttzy": {
5
      "api": "http://xxx.com/api.php/provide/vod",
6
      "name": "示例资源",
7
      "detail": "http://xxx.com"
8
    }
9
  },
10
  "custom_category": [
11
    {
12
      "name": "华语",
13
      "type": "movie",
14
      "query": "华语"
15
    }
16
  ]
17
}

api_site：苹果 CMS V10 标准的 vod JSON API，可增删多个源。
custom_category：自定义导航分类，type 支持 movie/tv，query 为豆瓣搜索词。

自动更新#

可借助 watchtower 或 dockge/komodo 等 compose UI 的自动更新功能保持镜像为最新版本。

祝你天天开心！

MoonTVPlus 影视聚合播放器 Docker 部署教程

https://blog.sywan.top/posts/moontvplus/

作者

屿

发布于

2026-08-26

许可协议

CC BY-NC-SA 4.0

部分信息可能已经过时

NodeCrypt 端到端加密聊天系统部署教程

mc指令

王煜是傻蛋,阮冉祥too

MoonTVPlus 影视聚合播放器 Docker 部署教程#

简介#

技术栈#

Docker 部署#

Kvrocks 存储（推荐）#

SQLite 存储#

Redis 存储#

Upstash 存储#

Lite 镜像说明#

环境变量要点#

初始化播放源配置#

自动更新#