Docker 部署katelyatv

📋 部署方案

拉取镜像

docker pull ghcr.io/katelya77/katelyatv:latest
x86镜像
docker pull registry.cn-hangzhou.aliyuncs.com/qiluo-images/katelyatv:latest
arm架构
docker pull registry.cn-hangzhou.aliyuncs.com/qiluo-images/linux_arm64_katelyatv:latest

方案一：Docker 单容器（最简单）

特点：5 分钟部署，个人使用，无多用户功能

export KATELYA_PASSWORD="your_password"
docker run -d \
  --name katelyatv \
  -p 3000:3000 \
  -e PASSWORD=your_password \
  --restart unless-stopped \
  registry.cn-hangzhou.aliyuncs.com/qiluo-images/katelyatv:latest

挂载自定义配置（可选）：

docker run -d \
  --name katelyatv \
  -p 3000:3000 \
  -e PASSWORD=your_password \
  -v $(pwd)/config.json:/app/config.json:ro \
  --restart unless-stopped \
  ghcr.io/katelya77/katelyatv:latest

方案二：Docker + Redis（推荐家庭使用）

特点：完整功能，多用户支持，成人内容过滤

# 1. 下载配置文件
curl -O https://raw.githubusercontent.com/katelya77/KatelyaTV/main/docker-compose.redis.yml
curl -O https://raw.githubusercontent.com/katelya77/KatelyaTV/main/.env.redis.example

# 2. 配置环境变量
cp .env.redis.example .env

编辑 .env 文件：

# 管理员账号（必填）
USERNAME=admin
PASSWORD=your_secure_password

# 存储配置
NEXT_PUBLIC_STORAGE_TYPE=redis
REDIS_URL=redis://katelyatv-redis:6379

# 功能开关
NEXT_PUBLIC_ENABLE_REGISTER=true

# 3. 启动服务
docker compose -f docker-compose.redis.yml up -d

方案三：Docker + Kvrocks（生产环境）

特点：极高可靠性，数据持久化到磁盘，节省内存

# 1. 下载配置文件
curl -O https://raw.githubusercontent.com/katelya77/KatelyaTV/main/docker-compose.kvrocks.yml
curl -O https://raw.githubusercontent.com/katelya77/KatelyaTV/main/.env.kvrocks.example

# 2. 配置环境变量
cp .env.kvrocks.example .env

编辑 .env 文件：

# 管理员账号（必填，否则无法登录）
USERNAME=admin
PASSWORD=your_secure_password

# 存储配置
NEXT_PUBLIC_STORAGE_TYPE=kvrocks
KVROCKS_URL=redis://kvrocks:6666

# 功能开关
NEXT_PUBLIC_ENABLE_REGISTER=true

# 3. 启动服务
docker compose -f docker-compose.kvrocks.yml up -d

环境变量说明

变量名	必填	说明	示例值
USERNAME	是*	管理员用户名	admin
PASSWORD	是	访问密码	your_password
NEXT_PUBLIC_STORAGE_TYPE	否	存储类型	redis/d1/upstash
NEXT_PUBLIC_ENABLE_REGISTER	否	用户注册	true/false
REDIS_URL	否**	Redis 连接	redis://localhost:6379
UPSTASH_URL	否**	Upstash 地址	https://xxx.upstash.io
UPSTASH_TOKEN	否**	Upstash 令牌	AX_xxx

*多用户部署必填 **对应存储类型必填

推荐配置文件

• 基础版（20+站点）：config_isadult.json
• 增强版（94 站点）：configplus_isadult.json

配置方式

1. Docker：挂载到 /app/config.json
2. Vercel/Cloudflare：提交到仓库根目录
3. 管理员界面：访问 /admin 上传配置

配置格式

{
  "cache_time": 7200,
  "api_site": {
    "site1": {
      "api": "https://api.example.com/provide/vod",
      "name": "资源站名称",
      "is_adult": false
    }
  }
}