跨平台 · 聚合搜索 · 即开即用 · 自托管影视聚合播放器

基于 Next.js 14 · TypeScript · Tailwind CSS · 多源聚合 / 播放记录 / 收藏同步 / 跳过片头片尾 / PWA

MoonTV 二创延续版 · 持续维护与增强

🚀 部署 · ✨ 功能 · 🐳 Docker · ⚙️ 配置

📰 项目来源与声明

✨ 功能特性

🎬 核心播放功能

💾 数据管理

🚀 部署与扩展

🎨 用户体验

📋 技术栈

🚀 部署教程

📋 部署方式对比

🎯 方案一:Docker 单容器(推荐新手)

🔧 前置要求

📝 详细步骤

第一步:拉取镜像

# 下载最新版本镜像(支持 ARM 和 x86 架构)
docker pull ghcr.io/katelya77/katelyatv:latest

第二步:启动容器

# 一键启动(请把 your_password 改成你的密码)
docker run -d \
 --name katelyatv \
 -p 3000:3000 \
 --env PASSWORD=your_password \
 --restart unless-stopped \
 ghcr.io/katelya77/katelyatv:latest

第三步:访问应用

第四步:自定义资源站配置

🔗 获取推荐的资源站配置

📋 配置步骤

# 先停止并删除旧容器
docker stop katelyatv && docker rm katelyatv
# 重新运行并挂载配置文件
docker run -d \
 --name katelyatv \
 -p 3000:3000 \
 --env PASSWORD=your_password \
 -v /path/to/your/config.json:/app/config.json:ro \
 --restart unless-stopped \
 ghcr.io/katelya77/katelyatv:latest

🛡️ 免责声明

🛠️ 常用管理命令

# 查看运行状态
docker ps
# 查看日志
docker logs katelyatv
# 重启应用
docker restart katelyatv
# 停止应用
docker stop katelyatv
# 删除容器
docker rm katelyatv

🎯 方案二:Docker + Redis(推荐进阶)

🔧 前置要求

📝 详细步骤

第一步:创建配置文件

# 创建目录
mkdir -p /opt/katelyatv
cd /opt/katelyatv
# 创建 docker-compose.yml 文件
cat > docker-compose.yml << 'EOF'
version: '3.8'

services:
 # KatelyaTV 主应用
 katelyatv:
 image: ghcr.io/katelya77/katelyatv:latest
 container_name: katelyatv
 ports:
 - "3000:3000"
 environment:
 # 管理员账号(请修改)
 - USERNAME=admin
 - PASSWORD=your_strong_password
 # 启用 Redis 存储
 - NEXT_PUBLIC_STORAGE_TYPE=redis
 - REDIS_URL=redis://katelyatv-redis:6379
 # 允许用户注册(可选)
 - NEXT_PUBLIC_ENABLE_REGISTER=true
 depends_on:
 katelyatv-redis:
 condition: service_healthy
 restart: unless-stopped
 # 可选:挂载自定义配置
 # volumes:
 # - ./config.json:/app/config.json:ro

 # Redis 数据库
 katelyatv-redis:
 image: redis:7-alpine
 container_name: katelyatv-redis
 command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
 volumes:
 - katelyatv-redis-data:/data
 healthcheck:
 test: ["CMD", "redis-cli", "ping"]
 interval: 10s
 timeout: 3s
 retries: 3
 restart: unless-stopped

volumes:
 katelyatv-redis-data:
EOF

第二步:修改配置

第三步:启动服务

# 启动所有服务
docker compose up -d
# 查看启动状态
docker compose ps

第四步:验证部署

第五步:配置资源站

方法一:使用推荐配置文件(推荐)

方法二:管理后台配置

🛠️ 管理命令

# 查看所有服务状态
docker compose ps
# 查看日志
docker compose logs -f
# 重启所有服务
docker compose restart
# 停止所有服务
docker compose down
# 更新到最新版本
docker compose pull
docker compose up -d

💾 备份数据

# 备份 Redis 数据
docker run --rm -v katelyatv-redis-data:/data -v $(pwd):/backup alpine tar czf /backup/redis-backup-$(date +%Y%m%d).tar.gz /data
# 恢复数据(如果需要)
docker run --rm -v katelyatv-redis-data:/data -v $(pwd):/backup alpine tar xzf /backup/redis-backup-20241201.tar.gz -C /

� 方案三:Docker + Kvrocks(高可靠性推荐)

🌟 Kvrocks 优势

🔧 前置要求

📝 详细步骤

第一步:下载配置文件

# 创建项目目录
mkdir katelyatv-kvrocks && cd katelyatv-kvrocks
# 下载 Kvrocks 部署配置
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
# 复制环境变量模板
cp .env.kvrocks.example .env

第二步:配置环境变量

# 编辑环境变量文件
nano .env

# 存储类型:使用 Kvrocks
NEXT_PUBLIC_STORAGE_TYPE=kvrocks
# Kvrocks 连接配置
KVROCKS_URL=redis://kvrocks:6666
KVROCKS_PASSWORD=your_secure_password_here # 改成你的密码
KVROCKS_DATABASE=0
# NextAuth 配置
NEXTAUTH_SECRET=your_nextauth_secret_here # 改成随机字符串
NEXTAUTH_URL=http://localhost:3000 # 改成你的域名

第三步:启动服务

# 一键启动 KatelyaTV + Kvrocks
docker compose -f docker-compose.kvrocks.yml up -d
# 查看启动状态
docker compose -f docker-compose.kvrocks.yml ps

第四步:验证部署

# 检查 Kvrocks 连接
docker compose -f docker-compose.kvrocks.yml exec kvrocks redis-cli -h localhost -p 6666 ping
# 查看日志
docker compose -f docker-compose.kvrocks.yml logs -f

第五步:访问应用

🛠️ 管理命令

# 停止服务
docker compose -f docker-compose.kvrocks.yml stop
# 重启服务
docker compose -f docker-compose.kvrocks.yml restart
# 查看 Kvrocks 状态
docker compose -f docker-compose.kvrocks.yml exec kvrocks redis-cli -h localhost -p 6666 info
# 备份数据
docker compose -f docker-compose.kvrocks.yml exec kvrocks redis-cli -h localhost -p 6666 BGSAVE
# 数据量统计
docker compose -f docker-compose.kvrocks.yml exec kvrocks redis-cli -h localhost -p 6666 dbsize

🔒 数据备份与恢复

备份数据

# 自动备份(推荐)
docker run --rm \
 -v katelyatv-kvrocks_kvrocks-data:/data \
 -v $(pwd):/backup \
 alpine tar czf /backup/kvrocks-backup-$(date +%Y%m%d).tar.gz /data
# 手动触发 RocksDB 备份
docker compose -f docker-compose.kvrocks.yml exec kvrocks redis-cli -h localhost -p 6666 BGSAVE

恢复数据

# 先停止服务
docker compose -f docker-compose.kvrocks.yml down
# 恢复数据
docker run --rm \
 -v katelyatv-kvrocks_kvrocks-data:/data \
 -v $(pwd):/backup \
 alpine tar xzf /backup/kvrocks-backup-20241201.tar.gz -C /
# 重新启动
docker compose -f docker-compose.kvrocks.yml up -d

🚀 性能优化建议

⚠️ 注意事项

�🎯 方案四:Vercel 部署(免服务器)

🔧 前置要求

📝 详细步骤

第一步:Fork 仓库

第二步:部署到 Vercel

第三步:等待部署完成

第四步:访问和使用

🔧 自定义资源站

方法一:使用推荐配置(推荐)

方法二:手动配置

⚠️ 注意事项

🎯 方案五:Cloudflare Pages(进阶用户)

🔧 前置要求

📝 详细步骤

第一步:Fork 仓库并连接

第二步:配置构建设置

第三步:设置兼容性

第四步:添加环境变量

第五步:重新部署

第六步:配置资源站

推荐配置方法:

🗄️ 启用 D1 数据库(可选,支持多用户)

第一步:创建 D1 数据库

第二步:初始化数据库

第三步:绑定数据库

第四步:添加环境变量

第五步:重新部署

🆙 升级和维护

Docker 升级

# 单容器版本
docker stop katelyatv
docker rm katelyatv
docker pull ghcr.io/katelya77/katelyatv:latest
# 然后重新运行启动命令
# Compose 版本
docker compose pull
docker compose up -d

Vercel 升级

Cloudflare 升级

🚨 常见问题排查

🐳 Docker

🚀 快速开始

1. 基础部署(LocalStorage,最快验证)

# 拉取最新镜像(支持 amd64/arm64 多架构)
docker pull ghcr.io/katelya77/katelyatv:latest
# 快速启动(LocalStorage 存储)
docker run -d \
 --name katelyatv \
 -p 3000:3000 \
 --env PASSWORD=your_secure_password \
 --restart unless-stopped \
 ghcr.io/katelya77/katelyatv:latest

2. 自定义配置(挂载 config.json)

# 创建配置文件目录
mkdir -p ./katelyatv-config
# 将你的 config.json 放入该目录,然后运行:
docker run -d \
 --name katelyatv \
 -p 3000:3000 \
 --env PASSWORD=your_secure_password \
 -v ./katelyatv-config/config.json:/app/config.json:ro \
 --restart unless-stopped \
 ghcr.io/katelya77/katelyatv:latest

3. 常用运维命令

# 查看容器状态
docker ps
# 查看日志
docker logs katelyatv
# 查看实时日志
docker logs -f katelyatv

4. 升级镜像

# 停止并删除旧容器
docker stop katelyatv && docker rm katelyatv
# 拉取最新镜像
docker pull ghcr.io/katelya77/katelyatv:latest
# 重新创建容器(使用相同的配置)
docker run -d \
 --name katelyatv \
 -p 3000:3000 \
 --env PASSWORD=your_secure_password \
 --restart unless-stopped \
 ghcr.io/katelya77/katelyatv:latest

📦 镜像特性

🔧 常用操作

# 进入容器终端(调试用)
docker exec -it katelyatv /bin/sh
# 重启容器
docker restart katelyatv
# 停止容器
docker stop katelyatv
# 查看容器资源使用情况
docker stats katelyatv
# 备份容器(如果有挂载卷)
docker run --rm -v katelyatv_data:/data -v $(pwd):/backup alpine tar czf /backup/katelyatv-backup.tar.gz /data

🐙 Docker Compose 最佳实践

📚 功能使用教程

⏭️ 跳过片头片尾功能

🎯 如何使用

⚙️ 功能特点

💾 存储支持

🛠️ 使用技巧

📁 配置说明

📝 LocalStorage(基础单机)

# docker-compose.yml
version: '3.8'
services:
 katelyatv:
 image: ghcr.io/katelya77/katelyatv:latest
 container_name: katelyatv
 restart: unless-stopped
 ports:
 - '3000:3000'
 environment:
 - PASSWORD=your_secure_password
 - SITE_NAME=我的影视站
 - ANNOUNCEMENT=欢迎使用 KatelyaTV!请遵守相关法律法规。
 # 可选:挂载自定义配置
 # volumes:
 # - ./config.json:/app/config.json:ro
 healthcheck:
 test:
 [
 'CMD',
 'wget',
 '--quiet',
 '--tries=1',
 '--spider',
 'http://localhost:3000',
 ]
 interval: 30s
 timeout: 10s
 retries: 3
 start_period: 40s

# 创建并启动服务
docker compose up -d
# 查看服务状态
docker compose ps
# 查看日志
docker compose logs -f katelyatv

🔐 Redis 版本(推荐:多用户 + 同步)

# docker-compose.yml
version: '3.8'
services:
 katelyatv:
 image: ghcr.io/katelya77/katelyatv:latest
 container_name: katelyatv
 restart: unless-stopped
 ports:
 - '3000:3000'
 environment:
 # 基础配置
 - SITE_NAME=KatelyaTV 影视站
 - ANNOUNCEMENT=支持多用户注册,请合理使用!
 # 管理员账号(重要!)
 - USERNAME=admin
 - PASSWORD=admin_super_secure_password
 # Redis 存储配置
 - NEXT_PUBLIC_STORAGE_TYPE=redis
 - REDIS_URL=redis://katelyatv-redis:6379
 # 用户功能
 - NEXT_PUBLIC_ENABLE_REGISTER=true
 # 可选:搜索配置
 - NEXT_PUBLIC_SEARCH_MAX_PAGE=8
 networks:
 - katelyatv-network
 depends_on:
 katelyatv-redis:
 condition: service_healthy
 # 可选:挂载自定义配置和持久化数据
 # volumes:
 # - ./config.json:/app/config.json:ro
 # - ./logs:/app/logs
 healthcheck:
 test:
 [
 'CMD',
 'wget',
 '--quiet',
 '--tries=1',
 '--spider',
 'http://localhost:3000',
 ]
 interval: 30s
 timeout: 10s
 retries: 3
 start_period: 40s
 katelyatv-redis:
 image: redis:7-alpine
 container_name: katelyatv-redis
 restart: unless-stopped
 command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
 networks:
 - katelyatv-network
 volumes:
 # Redis 数据持久化
 - katelyatv-redis-data:/data
 healthcheck:
 test: ['CMD', 'redis-cli', 'ping']
 interval: 10s
 timeout: 3s
 retries: 3
 start_period: 10s
 # 可选:端口映射(用于外部访问 Redis)
 # ports:
 # - '6379:6379'
networks:
 katelyatv-network:
 driver: bridge
 name: katelyatv-network
volumes:
 katelyatv-redis-data:
 driver: local
 name: katelyatv-redis-data

# 1. 创建项目目录
mkdir katelyatv && cd katelyatv
# 2. 创建 docker-compose.yml 文件(复制上面的内容)
nano docker-compose.yml
# 3. 检查配置文件语法
docker compose config
# 4. 启动所有服务
docker compose up -d
# 5. 查看服务状态
docker compose ps
# 6. 查看启动日志
docker compose logs -f
# 7. 等待服务完全启动(通常需要 30-60 秒)
# 检查健康状态
docker compose ps --format "table {{.Name}}\t{{.Status}}\t{{.Ports}}"
# 8. 首次访问 http://your-server:3000
# 使用管理员账号 admin / admin_super_secure_password 登录
# 然后访问 /admin 进行管理员配置

# 验证 Redis 连接
docker compose exec katelyatv-redis redis-cli ping
# 应该返回 "PONG"
# 验证 KatelyaTV 服务
curl -I http://localhost:3000
# 应该返回 HTTP 200 状态码
# 查看服务启动顺序
docker compose logs --timestamps | grep "Ready in"

🔄 管理与维护

# 更新到最新版本
docker compose pull && docker compose up -d
# 备份 Redis 数据
docker compose exec katelyatv-redis redis-cli BGSAVE
docker run --rm -v katelyatv-redis-data:/data -v $(pwd):/backup alpine tar czf /backup/redis-backup-$(date +%Y%m%d).tar.gz /data
# 查看资源使用情况
docker compose stats
# 重启特定服务
docker compose restart katelyatv
# 查看特定服务日志
docker compose logs -f katelyatv-redis
# 进入容器调试
docker compose exec katelyatv /bin/sh
# 完全清理(注意:会删除所有数据!)
docker compose down -v --remove-orphans

🚨 重要注意事项

🛠️ 常见部署问题排查

# 检查容器状态
docker compose ps
# 查看详细错误日志
docker compose logs katelyatv
# 常见原因:端口被占用、环境变量配置错误、镜像拉取失败

# 检查 Redis 容器状态
docker compose exec katelyatv-redis redis-cli ping
# 检查网络连通性
docker compose exec katelyatv ping katelyatv-redis
# 验证环境变量
docker compose exec katelyatv env | grep REDIS

# 验证 Upstash 配置
curl -H "Authorization: Bearer YOUR_TOKEN" YOUR_UPSTASH_URL/ping
# 检查环境变量格式
echo $UPSTASH_URL # 应该是 https://xxx.upstash.io
echo $UPSTASH_TOKEN # 应该是长字符串令牌

🔄 自动同步最近更改

⚙️ 环境变量

📋 变量说明表

🔧 配置验证

� 配置说明

{
 "cache_time": 7200,
 "api_site": {
 "example": {
 "api": "https://example.com/api.php/provide/vod",
 "name": "示例资源站",
 "detail": "https://example.com"
 }
 // ...更多站点
 }
}

👨‍💼 管理员配置

🔧 视频源配置管理

📤 导出配置

📂 导入配置

📋 支持的配置格式

{
 "cache_time": 7200,
 "api_site": {
 "source_key": {
 "api": "https://example.com/api.php/provide/vod",
 "name": "视频源名称",
 "detail": "https://example.com" // 可选
 }
 }
}

✨ 其他管理功能

📱 AndroidTV 使用

🆕 v0.5.0-katelya 修复说明

📱 OrionTV 配置方法

🔍 故障排除

🗓️ Roadmap

⚠️ 安全与隐私提醒

强烈建议设置密码保护

部署建议

重要声明

📄 License

⭐ Star History

Star History Chart

💖 支持项目

💝 感谢您的支持!您的捐赠将用于项目的持续维护和功能改进。

� 推荐配置文件说明

🎯 为什么需要配置文件?

📥 获取推荐配置

✨ 配置文件特点

🛡️ 使用声明

�🙏 致谢