DecoTV - 免费在线视频搜索与观看平台（基于 LibreTV 二次创作）

<div align="center"> <img src="image/logo.png" alt="DecoTV Logo" width="120"> <br> <p><strong>🎬 自由观影 • 畅享精彩 • 无限可能 🎬</strong></p> <p>基于 <strong>LibreTV</strong> 二次创作 • 致敬原作者</p>

GitHub release GitHub stars GitHub forks Docker Pulls

</div>

✨ 项目特色

🎨 视觉升级

霓虹灯特效：酷炫的霓虹光晕效果和渐变动画
玻璃磨砂设计：现代化的玻璃质感界面
卡片化布局：优雅的内容展示方式
响应式设计：完美适配各种设备屏幕

🚀 功能增强

20+ 视频源：整合多个优质视频接口
折叠式侧边栏：便捷的历史记录和设置面板
智能搜索：快速精准的内容查找
多部署方式：支持 Docker、Vercel、Cloudflare Pages 等

📺 项目简介

DecoTV 是一个轻量级、免费的在线视频搜索与观看平台，提供来自多个视频源的内容搜索与播放服务。无需注册，即开即用，支持多种设备访问。项目结合了前端技术和后端代理功能，可部署在支持服务端功能的各类网站托管服务上。

本项目为对 LibreTV 的二次创作，向原作者致敬，并在 UI、品牌与交互体验上进行全面增强。

<details> <summary>🖼️ 点击查看项目截图</summary> <img src="https://github.com/user-attachments/assets/df485345-e83b-4564-adf7-0680be92d3c7" alt="项目截图" style="max-width:600px"> </details>

🚀 快速部署

🐳 Docker 部署 (推荐)

# 方式一：使用预构建镜像 (最快)
docker run -p 3000:3000 ghcr.io/katelya77/decotv:latest

# 方式二：本地构建
git clone https://github.com/katelya77/DecoTV.git
cd DecoTV
npm run docker:build && npm run docker:run

☁️ 云平台一键部署

选择以下任一平台，点击一键部署按钮，即可快速创建自己的 DecoTV 实例：

💻 本地部署

git clone https://github.com/katelya77/DecoTV.git
cd DecoTV
npm install
npm start

📋 详细部署指南

🐳 Docker 部署详解

快速启动

# 拉取并运行最新版本
docker run -d -p 3000:3000 --name decotv ghcr.io/katelya77/decotv:latest

# 带密码保护
docker run -d -p 3000:3000 -e PASSWORD=your_password --name decotv ghcr.io/katelya77/decotv:latest

Docker Compose 部署

创建 docker-compose.yml:

version: '3.8'
services:
  decotv:
    image: ghcr.io/katelya77/decotv:latest
    ports:
      - "3000:3000"
    environment:
      - PASSWORD=your_secure_password  # 可选
      - PORT=3000
    restart: unless-stopped
    container_name: decotv

启动服务：

docker-compose up -d

☁️ 云平台部署详解

Vercel 部署

点击 Deploy 按钮或访问 Vercel
导入 GitHub 仓库：https://github.com/katelya77/DecoTV
配置环境变量（可选）：
- PASSWORD: 设置访问密码
点击 Deploy 完成部署

Netlify 部署

点击 Deploy 按钮或访问 Netlify
连接 GitHub 账户并选择仓库
构建设置：
- Build command: npm run build (如果有)
- Publish directory: ./
环境变量设置：
- PASSWORD: 访问密码

Render 部署

访问 Render 并连接 GitHub
选择 katelya77/DecoTV 仓库
配置服务：
- Environment: Node
- Build Command: npm install
- Start Command: npm start
设置环境变量：
- PASSWORD: 访问密码

Railway 部署

# 安装 Railway CLI
npm install -g @railway/cli

# 登录并部署
railway login
railway init
railway up

Heroku 部署

# 安装 Heroku CLI 后
heroku create your-app-name
git push heroku main
heroku config:set PASSWORD=your_password

🏠 VPS/服务器部署

Ubuntu/Debian 系统

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 部署项目
git clone https://github.com/katelya77/DecoTV.git
cd DecoTV
npm install
npm start

# 使用 PM2 守护进程
npm install -g pm2
pm2 start server.mjs --name "decotv"
pm2 startup
pm2 save

CentOS/RHEL 系统

# 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# 其他步骤同上

Nginx 反向代理配置

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

� 移动端部署优化

PWA 支持

项目已内置 PWA 支持，用户可：

添加到主屏幕
离线访问基本功能
类原生应用体验

移动端特性

响应式设计，完美适配手机/平板
触摸优化的界面交互
移动端专用的搜索体验

� 完整部署指南: 查看 DEPLOYMENT.md

方式1：Docker Compose（推荐）

克隆仓库：

git clone https://github.com/katelya77/DecoTV.git
cd DecoTV

复制环境变量文件：

cp .env.example .env

编辑 .env 文件，设置您的密码：

PASSWORD=your_secure_password_here

启动服务：

# 开发环境（本地构建）
docker-compose up -d

# 生产环境（使用预构建镜像）
docker-compose --profile prod up -d

访问 http://localhost:8080

方式2：直接运行 Docker 容器

# 使用本地构建
docker build -t decotv .
docker run -d \
  --name decotv \
  -p 8080:8080 \
  -e PASSWORD=your_secure_password_here \
  decotv

# 或使用预构建镜像
docker run -d \
  --name decotv \
  -p 8080:8080 \
  -e PASSWORD=your_secure_password_here \
  katelya77/decotv:latest

☁️ Cloudflare Pages

Fork 或克隆本仓库到您的 GitHub 账户
登录 Cloudflare Dashboard，进入 Pages 服务
点击"创建项目"，连接您的 GitHub 仓库
使用以下设置：
- 构建命令：留空（无需构建）
- 输出目录：留空（默认为根目录）
⚠️ 重要：在"设置" > "环境变量"中添加 PASSWORD 变量（必须设置）
点击"保存并部署"

▲ Vercel

Fork 或克隆本仓库到您的 GitHub/GitLab 账户
登录 Vercel，点击"New Project"
导入您的仓库，使用默认设置
⚠️ 重要：在"Settings" > "Environment Variables"中添加 PASSWORD 变量（必须设置）
点击"Deploy"

🌐 Netlify

Fork 本仓库到您的 GitHub 账户
登录 Netlify，点击"New site from Git"
选择您的仓库，使用默认设置
⚠️ 重要：在"Site settings" > "Environment variables"中添加 PASSWORD 变量

🎯 Render

Fork 本仓库到您的 GitHub 账户
登录 Render，点击"New" > "Web Service"
连接您的仓库，使用默认设置
⚠️ 重要：在"Environment"部分添加 PASSWORD 变量

🔧 本地开发

克隆仓库：

git clone https://github.com/katelya77/DecoTV.git
cd DecoTV

安装依赖：

npm install

设置环境变量：

cp .env.example .env
# 编辑 .env 文件，添加 PASSWORD=your_password

启动开发服务器：

npm run dev

访问 http://localhost:8080

🔑 环境变量配置

在部署时，请确保设置以下环境变量：

| 变量名 | 必需 | 默认值 | 说明 | |--------|------|--------|------| | PASSWORD | ✅ | - | 访问密码（强烈建议设置） | | PORT | ❌ | 8080 | 服务器端口 | | CORS_ORIGIN | ❌ | * | CORS 允许源 | | DEBUG | ❌ | false | 调试模式 |

📱 功能特色

🎨 视觉效果

霓虹灯特效：动感十足的霓虹光晕和渐变效果
玻璃磨砂质感：现代化的毛玻璃界面设计
流畅动画：丝滑的过渡效果和交互反馈
响应式布局：完美适配手机、平板、电脑

🔧 实用功能

智能搜索：支持模糊搜索和快速筛选
观看历史：自动记录观看记录，便于快速回看
多源整合：整合20+优质视频资源接口
设置面板：丰富的个性化配置选项

🛠️ 技术特点

无需注册：开箱即用，保护用户隐私
轻量级：精简代码，快速加载
多端支持：跨平台部署，灵活便捷
开源免费：MIT 协议，自由使用和修改

🔍 使用指南

首次访问：如设置了密码保护，请输入密码进行验证
搜索内容：在搜索框中输入想观看的影片名称
选择资源：点击搜索结果中的影片，选择播放源
开始观看：选择清晰度和播放线路，享受观影体验
设置配置：点击右上角设置按钮，自定义API源和功能选项

🔐 安全说明

项目强制要求设置 PASSWORD 环境变量以保护部署实例
建议使用强密码，避免简单易猜的密码组合
请勿在公共场所或社交媒体分享部署链接和密码
定期更换访问密码以确保安全性

🤝 贡献指南

我们欢迎所有形式的贡献！

如何贡献

Fork 本仓库
创建功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

贡献类型

🐛 Bug 修复
✨ 新功能开发
📝 文档改进
🎨 UI/UX 优化
🔧 代码重构
🌐 多语言支持

📞 联系方式

作者邮箱：katelya77@gmail.com
项目主页：GitHub Repository
问题反馈：Issues
功能建议：Discussions

⭐ Star History

如果本项目对您有帮助，请给个 Star ⭐ 支持一下！

📄 开源协议

本项目采用 MIT License 开源协议。

🙏 鸣谢

感谢 LibreTV 原项目提供的基础框架
感谢所有为项目贡献代码和建议的开发者们
感谢开源社区提供的优秀工具和库

<div align="center"> <p>⚡ 由 <strong>katelya77</strong> 用 ❤️ 制作</p> <p>🎬 <strong>DecoTV - 自由观影，畅享精彩</strong> 🎬</p> </div>

services:
  libretv:
    image: bestzwei/libretv:latest
    container_name: libretv
    ports:
      - "8899:8080" # 将内部 8080 端口映射到主机的 8899 端口
    environment:
      - PASSWORD=${PASSWORD:-111111} # 可将 111111 修改为你想要的密码，默认为 your_password
    restart: unless-stopped

启动 DecoTV：

docker compose up -d

访问 http://localhost:8899 即可使用。

本地开发环境

项目包含后端代理功能，需要支持服务器端功能的环境：

# 首先，通过复制示例来设置 .env 文件（可选）
cp .env.example .env

# 安装依赖
npm install

# 启动开发服务器
npm run dev

访问 http://localhost:8080 即可使用（端口可在.env文件中通过PORT变量修改）。

⚠️ 注意：使用简单静态服务器（如 python -m http.server 或 npx http-server）时，视频代理功能将不可用，视频无法正常播放。完整功能测试请使用 Node.js 开发服务器。

🔧 自定义配置

密码保护

重要提示: 为确保安全，所有部署都必须设置 PASSWORD 环境变量，否则用户将看到设置密码的提示。

API兼容性

DecoTV 支持标准的苹果 CMS V10 API 格式（与上游兼容）。添加自定义 API 时需遵循以下格式：

搜索接口: https://example.com/api.php/provide/vod/?ac=videolist&wd=关键词
详情接口: https://example.com/api.php/provide/vod/?ac=detail&ids=视频ID

添加 CMS 源:

在设置面板中选择"自定义接口"
接口地址: https://example.com/api.php/provide/vod

⌨️ 键盘快捷键

播放器支持以下键盘快捷键：

空格键: 播放/暂停
左右箭头: 快退/快进
上下箭头: 音量增加/减小
M 键: 静音/取消静音
F 键: 全屏/退出全屏
Esc 键: 退出全屏

🛠️ 技术栈

HTML5 + CSS3 + JavaScript (ES6+)
Tailwind CSS
HLS.js 用于 HLS 流处理
DPlayer 视频播放器核心
Cloudflare/Vercel/Netlify Serverless Functions
服务端 HLS 代理和处理技术
localStorage 本地存储

⚠️ 免责声明

DecoTV 仅作为视频搜索工具，不存储、上传或分发任何视频内容。所有视频均来自第三方 API 接口提供的搜索结果。如有侵权内容，请联系相应的内容提供方。

本项目开发者不对使用本项目产生的任何后果负责。使用本项目时，您必须遵守当地的法律法规。

📝 致谢与说明

本项目基于 LibreTV 二次创作，原项目地址：`https://github.com/LibreSpark/LibreT

DecoTV

Install / Use

README