DecoTV：构建个性化跨平台影视聚合站的完整指南

DecoTV构建个性化跨平台影视聚合站的完整指南【免费下载链接】DecoTV基于最新版LunaTV二次开发的一个开箱即用的、跨平台的影视聚合播放站。【原KatelyaTV】项目地址: https://gitcode.com/gh_mirrors/de/DecoTV在数字娱乐需求日益增长的今天如何快速搭建一个功能完善、界面美观的影视聚合平台同时保持数据私密性和多设备同步能力成为许多技术爱好者和家庭媒体中心管理者的共同挑战。DecoTV 应运而生这是一个基于最新版 LunaTV 二次开发的开源项目为这一难题提供了优雅的解决方案。项目定位与核心价值DecoTV 是一款专为技术爱好者和媒体中心管理者设计的现代化影视聚合播放器。它采用 Next.js 16、Tailwind CSS 4 和 TypeScript 5 构建不仅提供了开箱即用的部署体验更在数据隐私、多端同步和功能扩展性方面进行了深度优化。与传统的影视聚合方案不同DecoTV 强调可定制、可控制、可扩展的设计理念让用户完全掌控自己的观影体验。目标用户群体DecoTV 适合三类用户群体技术爱好者希望搭建个性化影视平台享受完全控制权家庭媒体中心管理者需要为家庭成员提供统一的多设备观影体验隐私敏感用户希望数据完全自托管避免第三方监控功能特性深度解析核心播放体验DecoTV 的核心播放功能建立在现代 Web 技术之上支持 HLS.js 和 ArtPlayer 双引擎确保在不同设备和网络环境下的流畅播放体验。多音轨切换功能智能识别视频中的音轨数量仅在存在多条音轨时显示切换按钮保持界面简洁。明亮模式界面适合白天使用提供清新简洁的视觉体验数据同步与存储策略项目最大的亮点在于其灵活的存储架构设计。DecoTV 支持四种存储模式满足不同场景需求存储模式适用场景数据持久性多设备同步部署复杂度本地存储单机体验、快速测试浏览器级别不支持最低Kvrocks生产环境、小型团队磁盘持久化支持中等Redis高性能场景内存持久化支持中等Upstash云原生部署云端托管支持中等智能内容发现系统DecoTV 集成了豆瓣和 TMDB 双元数据源通过智能匹配算法为影视内容补充完整的元数据信息。系统采用中文优先、英文回退的策略确保华语内容的准确性同时兼顾欧美内容的完整性。私人影库集成对于拥有自建媒体服务器的用户DecoTV 提供了无缝的集成方案。支持 OpenList、小雅 Alist、Emby 和 Jellyfin 等多种媒体服务器通过服务端代理保护流地址和鉴权信息确保私有媒体资源的安全性。实战部署从零到一的完整流程环境准备与基础部署部署 DecoTV 需要满足以下基础要求Docker 环境推荐 Docker 20.10至少 1GB 可用内存稳定的网络连接基本的命令行操作能力第一步获取项目代码# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/de/DecoTV cd DecoTV第二步选择适合的部署模式场景一快速体验与单机使用对于初次接触或仅需单机使用的用户推荐使用本地存储模式docker run -d \ --name decotv \ -p 3000:3000 \ -v decotv-downloads:/app/.cache/ffmpeg-downloads \ -e PASSWORDyour_strong_password \ ghcr.io/decohererk/decotv:latest场景二家庭多设备同步对于家庭用户建议使用 Kvrocks 存储模式配置 docker-compose.ymlservices: decotv-core: image: ghcr.io/decohererk/decotv:latest container_name: decotv-core restart: on-failure ports: - 3000:3000 environment: - USERNAMEadmin - PASSWORDadmin_password - NEXT_PUBLIC_STORAGE_TYPEkvrocks - KVROCKS_URLredis://decotv-kvrocks:6666 depends_on: - decotv-kvrocks decotv-kvrocks: image: apache/kvrocks container_name: decotv-kvrocks restart: unless-stopped volumes: - kvrocks-data:/var/lib/kvrocks volumes: kvrocks-data:第三步访问与初始化部署完成后通过浏览器访问http://localhost:3000使用设置的管理密码登录系统。首次登录后系统将引导您完成基础配置。配置影视资源库DecoTV 部署后默认不包含任何影视资源需要手动配置资源站点。这是项目设计的核心理念之一让用户完全控制内容来源避免法律风险。基础配置文件示例{ cache_time: 7200, api_site: { dyttzy: { api: http://example.com/api.php/provide/vod, name: 示例资源站, detail: http://example.com } }, custom_category: [ { name: 华语电影, type: movie, query: 华语 }, { name: 美剧推荐, type: tv, query: 美剧 } ] }配置解析cache_time接口缓存时间秒建议设置为 2 小时7200 秒api_site资源站点配置支持多个站点并行custom_category自定义分类可基于类型和关键词创建个性化导航高级功能配置指南弹幕功能集成DecoTV 支持弹弹play开放平台的弹幕服务提供三种接入方式公共中继模式Vercel 部署默认无需配置使用项目公共中继自有凭证模式在弹弹play DevCenter 申请凭证后配置自定义中继模式自建中继服务并配置地址自有凭证配置示例DANDANPLAY_APP_IDyour_app_id DANDANPLAY_APP_SECRETyour_app_secret网盘搜索配置集成 PanSou 网盘搜索功能需要先部署独立的 PanSou 服务部署 PanSou 服务并确保健康检查接口可访问在 DecoTV 后台配置 PanSou 服务地址如需鉴权配置对应的 Token 或用户名密码TMDB 元数据增强TMDB 作为豆瓣的补充数据源特别适合欧美和日韩内容在 TMDB 官网申请 API Key配置环境变量或后台设置执行连通性测试验证配置性能优化与最佳实践存储方案选择指南选择存储方案时需要综合考虑使用场景、数据量和性能需求本地存储模式适用场景单用户、单设备使用临时测试环境对数据持久性要求不高的场景Kvrocks 存储模式优势数据持久化到磁盘重启不丢失支持多设备同步性能优于 Redis 在某些场景内存占用更友好生产环境推荐配置# docker-compose.prod.yml services: decotv: image: ghcr.io/decohererk/decotv:v1.0.0 # 固定版本避免意外更新 container_name: decotv restart: unless-stopped ports: - 3000:3000 environment: - USERNAME${ADMIN_USERNAME} - PASSWORD${ADMIN_PASSWORD} - NEXT_PUBLIC_STORAGE_TYPEkvrocks - KVROCKS_URLredis://kvrocks:6666 - SITE_BASE${SITE_URL} volumes: - downloads:/app/.cache/ffmpeg-downloads depends_on: kvrocks: condition: service_healthy kvrocks: image: apache/kvrocks container_name: kvrocks restart: unless-stopped volumes: - kvrocks-data:/var/lib/kvrocks healthcheck: test: [CMD, redis-cli, -p, 6666, ping] interval: 30s timeout: 10s retries: 3 volumes: kvrocks-data: downloads:安全配置建议访问控制策略公网部署必须设置强密码避免使用弱密码或默认密码谨慎开启用户注册功能仅在可信环境中使用使用 HTTPS 反向代理确保数据传输安全配置防火墙规则限制不必要的端口访问内容过滤配置DecoTV 内置成人内容过滤机制可通过 URL 参数灵活控制家庭安全模式自动过滤成人内容和敏感关键词完整内容模式显示所有内容需在 URL 中添加/adult/前缀OrionTV 集成配置示例# 家庭安全模式 API 地址: https://your-domain.com/ # 完整内容模式 API 地址: https://your-domain.com/adult/下载功能优化DecoTV 提供两种下载模式满足不同场景需求浏览器分片下载适合大部分 Web 部署场景无需服务端 FFmpeg 支持自动解析 m3u8 分片并合并FFmpeg 转存下载官方 Docker 镜像内置 FFmpeg支持格式转换和优化需要挂载持久化存储卷推荐挂载配置volumes: - decotv-downloads:/app/.cache/ffmpeg-downloads故障排除与性能调优常见问题解决方案问题一登录后仍提示 401 Unauthorized可能原因及解决方案浏览器 Cookie 问题清除浏览器 Cookie 后重新登录残留数据库配置检查是否设置了冲突的存储环境变量反向代理配置错误确保正确传递X-Forwarded-Proto头部问题二播放卡顿或加载缓慢优化建议检查网络连接确保资源站点可正常访问调整缓存策略适当增加cache_time值启用 CDN 加速对静态资源使用 CDN 服务优化资源站点选择选择响应速度快的资源站点问题三TVBox 配置失效解决方案# 启用远程 spider.jar ALLOW_REMOTE_SPIDER_JARtrue SPIDER_JAR_URLhttps://trusted-source/spider.jar SPIDER_JAR_SHA256your_jar_sha256_hash性能监控指标建议定期监控以下关键指标内存使用量确保不超过容器限制CPU 使用率关注高峰时段负载网络流量监控入站和出站流量存储空间确保下载缓存目录有足够空间扩展功能与集成方案Android TV 集成DecoTV 可与 OrionTV 配合使用实现在 Android TV 上的完美体验在 Android TV 上安装 OrionTV配置 DecoTV 作为后端服务地址享受大屏观影体验播放记录自动同步暗夜模式界面适合夜间使用有效保护视力并提升观影沉浸感移动端 PWA 支持DecoTV 支持渐进式 Web 应用PWA特性可将应用安装到手机主屏在移动浏览器中访问 DecoTV点击浏览器菜单中的添加到主屏幕享受接近原生应用的体验多语言与国际化虽然当前版本主要支持中文界面但项目架构已为国际化做好准备。技术栈采用 TypeScript 和现代 React 架构便于未来添加多语言支持。版本管理与升级策略Docker 镜像标签策略DecoTV 提供灵活的版本管理方案标签类型说明使用场景latest最新构建版本开发环境、体验新功能v1.0.0特定版本号生产环境、稳定部署v0.9.0历史版本版本回滚、兼容性测试生产环境推荐使用版本号标签docker pull ghcr.io/decohererk/decotv:v1.0.0自动更新方案使用 Watchtower 实现容器自动更新# 安装 Watchtower docker run -d \ --name watchtower \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --interval 3600 \ decotv架构设计与技术实现前端技术栈DecoTV 采用现代化的前端技术栈Next.js 16提供服务器端渲染和静态生成能力Tailwind CSS 4原子化 CSS 框架确保样式一致性TypeScript 5类型安全的开发体验ArtPlayer HLS.js专业的视频播放解决方案后端架构项目采用无状态架构设计所有状态通过存储层管理API 路由基于 Next.js 的 App Router存储抽象层支持多种存储后端代理中间件处理跨域和安全限制安全架构DecoTV 采用多层安全防护输入验证对所有用户输入进行严格验证输出编码防止 XSS 攻击CORS 控制限制跨域请求内容过滤内置成人内容过滤机制SSRF 防护代理接口多重防护社区生态与未来发展项目路线图DecoTV 持续演进未来规划包括多语言国际化支持更多数据库存储选择移动端原生应用开发智能推荐算法优化用户评分系统完善贡献指南项目采用标准的开源协作流程Fork 项目仓库创建功能分支提交代码变更创建 Pull Request通过代码审查和测试获取支持与反馈问题报告通过项目 Issue 页面提交功能建议参与项目讨论区技术交流参考项目文档和示例总结与建议DecoTV 作为一个现代化的影视聚合解决方案在易用性、功能性和可扩展性之间取得了良好平衡。无论是个人使用还是家庭共享都能提供优质的观影体验。部署建议总结个人使用推荐本地存储模式简单快捷家庭共享使用 Kvrocks 存储实现多设备同步生产环境采用固定版本标签配合健康检查和监控内容安全合理配置访问控制和内容过滤通过本文的完整指南您应该已经掌握了 DecoTV 的核心概念、部署方法和最佳实践。现在可以开始构建属于您自己的个性化影视聚合平台享受完全掌控的数字娱乐体验。DecoTV 采用科幻星空设计语言象征着探索无限可能的内容世界记住成功的部署不仅需要技术实现更需要合理的规划和持续的维护。建议从简单配置开始逐步添加高级功能确保系统的稳定性和安全性。随着对系统理解的深入您可以根据实际需求调整配置打造最适合自己的影视聚合解决方案。【免费下载链接】DecoTV基于最新版LunaTV二次开发的一个开箱即用的、跨平台的影视聚合播放站。【原KatelyaTV】项目地址: https://gitcode.com/gh_mirrors/de/DecoTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考