[JS/TS] 基于Next.js与TypeScript的流媒体聚合平台开发与Docker部署指南

项目简介

这是一个现代化的影视资源聚合平台，支持 Dailymotion 视频源、豆瓣信息匹配、多源切换与智能匹配。项目采用 Next.js + TypeScript 构建，并提供了 Vercel、Docker 等多种灵活的部署方式，方便开发者快速搭建与使用。

✨ 功能特性

• 🎬 视频聚合 - 聚合 Dailymotion 等多个视频源。
• 📝 豆瓣匹配 - 自动匹配豆瓣电影信息和评分。
• 💬 弹幕功能 - 自动匹配加载弹幕，支持手动搜索。
• 🎥 高级播放器 - ArtPlayer 播放器，支持 HLS、倍速、快捷键。
• 📱 响应式设计 - 完美支持移动端和桌面端。
• 🎨 现代化 UI - Netflix 风格界面设计。
• 🔐 后台管理 - 视频源配置、频道管理 (/login)。
• 🚀 多种部署 - 支持 Vercel、Docker、VPS 一键部署。

📸 界面预览

🚀 部署方式

方式一：Vercel 部署（推荐）

无需服务器，免费托管，自动 HTTPS

步骤：

1. 点击上方按钮，Fork 项目到 Vercel。
2. 在 Vercel 控制台设置环境变量：

   MONGODB_URI=mongodb+srv://user:password@cluster.mongodb.net/kerkerker
   ADMIN_PASSWORD=your_password

3. 部署完成！

方式二：Docker Compose 部署

快速启动

# 1. 克隆项目
git clone https://github.com/unilei/kerkerker.git
cd kerkerker

# 2. 创建配置文件
cp .env.example .env

# 3. 编辑配置（可选）
nano .env

# 4. 启动服务
docker-compose up -d

# 5. 查看日志
docker-compose logs -f app

docker-compose.yml 说明

services:
  app:
    build: .
    ports:
      - "3000:3000" # 修改左侧端口号自定义访问端口
    environment:
      - ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - MONGODB_URI=mongodb://mongodb:27017/kerkerker
    depends_on:
      mongodb:
        condition: service_healthy

  mongodb:
    image: mongo:7
    volumes:
      - mongodb-data:/data/db # 数据持久化

常用命令

docker-compose up -d       # 后台启动
docker-compose down        # 停止服务
docker-compose logs -f     # 查看日志
docker-compose restart     # 重启服务
docker-compose pull        # 更新镜像

方式三：VPS 一键部署

在任何装有 Docker 的服务器上执行：

# 使用 curl
curl -fsSL https://raw.githubusercontent.com/unilei/kerkerker/master/scripts/install.sh | bash

# 使用 wget
wget -qO- https://raw.githubusercontent.com/unilei/kerkerker/master/scripts/install.sh | bash

部署后管理：

cd ~/kerkerker
./kerkerker.sh start     # 启动
./kerkerker.sh stop      # 停止
./kerkerker.sh restart   # 重启
./kerkerker.sh logs      # 日志
./kerkerker.sh update    # 更新
./kerkerker.sh backup    # 备份

⚙️ 环境变量

必需变量

变量名	说明	示例
MONGODB_URI	MongoDB 连接字符串	mongodb+srv://user:pass@cluster.mongodb.net/db

可选变量

变量名	说明	默认值
ADMIN_PASSWORD	后台管理密码	admin123
MONGODB_DB_NAME	数据库名称	kerkerker
NEXT_PUBLIC_DANMU_API_URL	弹幕 API 地址	https://danmuapi1-eight.vercel.app
NEXT_PUBLIC_DANMU_API_TOKEN	弹幕 API Token	-

MongoDB URI 示例

# Docker 内部（docker-compose 自动配置）
MONGODB_URI=mongodb://mongodb:27017/kerkerker

# 本地 MongoDB
MONGODB_URI=mongodb://localhost:27017/kerkerker

# MongoDB Atlas（云端）
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/kerkerker

💻 本地开发

使用 Docker（推荐）

# 启动开发环境（包含 MongoDB）
npm run docker:dev

# 停止服务
docker-compose -f docker-compose.dev.yml down

不使用 Docker

# 1. 安装依赖
npm install

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，设置 MONGODB_URI

# 3. 启动开发服务器
npm run dev

# 4. 访问
open http://localhost:3000

脚本说明

命令	说明
npm run dev	启动开发服务器
npm run build	构建生产版本
npm run docker:dev	Docker 开发环境（热重载）
npm run docker:prod	构建并推送 Docker 镜像

项目地址

你可以在 GitHub 上找到这个项目的完整源码：https://github.com/unilei/kerkerker/blob/master/README.md

希望这个指南能帮助你快速上手这个流媒体聚合项目。如果你想了解更多关于现代 Web 开发与部署的实践，欢迎访问 云栈社区 获取更多技术资源与讨论。