KatelyaTV部署指南，配合TVBox与OrionTV深度联动实战

1
version: "3.8"
2
services:
3
  katelyatv:
4
    image: ghcr.io/katelya77/katelyatv:main-3ce1bd1
5
    container_name: katelyatv
6
    restart: unless-stopped
7
    ports:
8
      - "3030:3000"
9
    environment:
10
      - PASSWORD=your_password

部署方案二：Docker + Redis（推荐）#

1
version: "3.8"
2

3
services:
4
  katelyatv:
5
    image: ghcr.io/katelya77/katelyatv:main-3ce1bd1
6
    container_name: katelyatv
7
    restart: unless-stopped
8
    ports:
9
      - "3030:3000"
10
    environment:
11
      - USERNAME=admin
12
      - PASSWORD=your_secure_password
13
      - NEXT_PUBLIC_STORAGE_TYPE=redis
14
      - REDIS_URL=redis://katelyatv-redis:6379
15
      - NEXT_PUBLIC_ENABLE_REGISTER=true
16
    depends_on:
17
      - katelyatv-redis
18

19
  katelyatv-redis:
20
    image: redis:7-alpine
21
    container_name: katelyatv-redis
22
    restart: unless-stopped
23
    volumes:
24
      - redis_data:/data
25

26
volumes:
27
  redis_data:

部署方案三：Vercel + Upstash（免费）#

步骤#

Fork GitHub 项目
Vercel 导入仓库
添加环境变量：
- PASSWORD=your_password

多用户配置#

创建 Upstash 数据库，添加环境变量：

1
NEXT_PUBLIC_STORAGE_TYPE=upstash
2
UPSTASH_URL=https://xxx.upstash.io
3
UPSTASH_TOKEN=your_token
4
USERNAME=admin
5
PASSWORD=your_password

部署方案四：Cloudflare Pages + D1#

构建设置#

Build command: pnpm install --frozen-lockfile && pnpm run pages:build
Build output directory: .vercel/output/static
兼容性标志: nodejs_compat

环境变量#

1
USERNAME=admin
2
PASSWORD=your_password
3
NEXT_PUBLIC_STORAGE_TYPE=d1
4
NEXT_PUBLIC_ENABLE_REGISTER=true

TVBox 联动#

配置地址格式#

格式	地址
JSON	`https://域名/api/tvbox?format=json`
TXT	`https://域名/api/tvbox?format=txt`
XML	`https://域名/api/tvbox?format=xml`

导入步骤#

打开 TVBox 应用
进入配置页面
导入配置地址

多设备同步对比#

存储方式	同步范围	配置难度	免费程度
LocalStorage	单设备	无需配置	完全免费
Redis	全同步	需服务器	自建免费
Upstash	全同步	简单配置	有免费额度
D1	全同步	中等难度	完全免费

OpenWrt 部署#

启动 Redis#

1
docker run -d \
2
  --name katelyatv-redis \
3
  --restart unless-stopped \
4
  -v /opt/docker/redis:/data \
5
  redis:7-alpine

启动 KatelyaTV#

1
docker run -d \
2
  --name katelyatv \
3
  --restart unless-stopped \
4
  -p 3000:3000 \
5
  -e USERNAME=admin \
6
  -e PASSWORD=10000 \
7
  -e NEXT_PUBLIC_STORAGE_TYPE=redis \
8
  -e REDIS_URL=redis://katelyatv-redis:6379 \
9
  -e NEXT_PUBLIC_ENABLE_REGISTER=true \
10
  ghcr.io/katelya77/katelyatv:main-3ce1bd1

音乐

音乐

公益站点#

项目地址#

准备工作#

部署方案一：Docker 单容器#

部署方案二：Docker + Redis（推荐）#

部署方案三：Vercel + Upstash（免费）#

步骤#

多用户配置#

部署方案四：Cloudflare Pages + D1#

构建设置#

环境变量#

TVBox 联动#

配置地址格式#

导入步骤#

多设备同步对比#

OpenWrt 部署#

启动 Redis#

启动 KatelyaTV#

相关资源#

支持与分享

评论区

音乐

目录