easynashub/easy-vdl repository overview
🚀 Easy-VDL 综合媒体资源管理平台
一款集视频订阅、直播录制、智能剪辑、GPU硬件加速转码与媒体服务器联动的可视化内容管理平台。
🌟 功能特色
- 🎬 多平台视频订阅与归档：支持主流短视频、长视频创作社区及海外开放流媒体（如 YouTube、X、Instagram 等），支持创作者主页、合集、发布动态的自动化检测与本地结构化归档。
- 🔴 直播自动录制与回放：全面支持各大主流互动直播平台与通用网络流媒体协议，智能轮询开播状态，开播自动录制，停播自动转码保存。支持内置网页播放器无缝时间轴回放，无需第三方播放器。
- 📜 直播弹幕同步与回放：直播录制过程中同步记录弹幕时间流，支持 WebSocket 实时推送至前端（跑马灯/列表双模式），回放时可同步浏览历史弹幕。
- 🤖 AI 智能精彩片段提取：直播结束后基于弹幕热度与情感分析自动提取精彩片段，接入大语言模型（如 DeepSeek）自动生成标题与内容摘要，打包一键导出剪辑素材。
- 🔔 智能通知推送：支持 企业微信机器人、Telegram Bot、Server酱³、Bark (iOS) 及 WebSocket 实时交互通知。
- ✈️ 大文件 Telegram 直传：内置 MTProto 底层代理直连 Telegram，支持向 Bot 传输最大 2GB 媒体文件并自动转存至本地。
- 🍿 完美联动 Emby/Jellyfin：自动生成符合 Emby/Jellyfin 标准的 NFO 元数据与精美海报墙。
- ⚡ 硬件加速解码：内置网页播放器，完美支持 Intel/AMD 核显（QSV/VAAPI）与 NVIDIA 显卡硬件加速转码，无需 Jellyfin/Emby 即可在线流畅播放。
⚡ 极速部署
支持 x86_64 (amd64) 架构设备（如 Intel / AMD 处理器的各类群晖、威联通、Unraid、TrueNAS 等 NAS 及服务器硬件）。
推荐：使用 Docker Compose 一键部署
在您存放数据的目录下创建 docker-compose.yml，复制以下内容并运行 docker-compose up -d：
version: '3.8'
services:
easy-vdl:
image: easynashub/easy-vdl:latest
container_name: easy-vdl
ports:
- "888:80" # 888 为外部访问端口，可按需修改
- "8001:8001" # 企业微信 Bot 回调端口（可选）
mem_limit: 4g # 推荐 4G，小规模订阅可降为 2G
mem_limit_swap: 4g
# 【Intel/AMD 核显硬件加速映射（默认配置，NVIDIA 用户请改用下方注释块）】：
devices:
- /dev/dri:/dev/dri # Intel/AMD 核显硬件加速映射
# NVIDIA 显卡请改用以下配置（注释上方 devices，取消下方注释）：
# deploy:
# resources:
# reservations:
# devices:
# - driver: nvidia
# count: all
# capabilities: [gpu]
cap_add:
- PERFMON # GPU 仪表盘监控负载支持
volumes:
- ./downloads:/app/downloads # 视频与媒体下载保存路径
- ./logs:/app/logs # 程序运行日志
- ./database:/app/database # 数据库与全局配置路径
environment:
- EASY_VDL_PORT=80
- PUID=1000 # 推荐修改为您宿主机用户的 UID/GID，防止出现 Permission denied 错误
- PGID=100
- EASY_VDL_ADMIN_USERNAME=admin # 预设管理员用户名
- EASY_VDL_ADMIN_PASSWORD=admin123456 # 预设管理员密码
- TZ=Asia/Shanghai
restart: unless-stopped
💡 传统的 Docker Run 部署指令
# x86_64 - Intel/AMD 核显（支持硬解与 GPU 监控）
docker run -d --name easy-vdl -p 888:80 -p 8001:8001 \
--memory=4g --memory-swap=4g \
--device=/dev/dri:/dev/dri \
--cap-add PERFMON \
-v $(pwd)/downloads:/app/downloads \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/database:/app/database \
-e EASY_VDL_PORT=80 -e PUID=1000 -e PGID=100 -e TZ=Asia/Shanghai \
-e EASY_VDL_ADMIN_USERNAME=admin -e EASY_VDL_ADMIN_PASSWORD=admin123456 \
--restart always \
easynashub/easy-vdl:latest
# x86_64 - NVIDIA 显卡（需提前安装 nvidia-container-toolkit）
docker run -d --name easy-vdl -p 888:80 -p 8001:8001 \
--memory=4g --memory-swap=4g \
--gpus all \
--cap-add PERFMON \
-v $(pwd)/downloads:/app/downloads \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/database:/app/database \
-e EASY_VDL_PORT=80 -e PUID=1000 -e PGID=100 -e TZ=Asia/Shanghai \
-e EASY_VDL_ADMIN_USERNAME=admin -e EASY_VDL_ADMIN_PASSWORD=admin123456 \
--restart always \
easynashub/easy-vdl:latest
⚙️ 环境变量与挂载参数说明
常用环境变量
| 变量名 | 说明 | 默认值 | 推荐/必选 |
|---|---|---|---|
EASY_VDL_PORT | 容器内部的服务端口 | 80 | 保持 80 |
PUID / PGID | 读写挂载目录的用户 UID/GID | 1000 / 100 | 推荐匹配您宿主机用户的实际 ID |
EASY_VDL_ADMIN_USERNAME | 默认管理员账号 | admin | 必选 |
EASY_VDL_ADMIN_PASSWORD | 默认管理员密码 | admin123456 | 必选（建议修改） |
SNIFFER_LICENSE_KEY | 高级功能授权密钥 | 无 | 可选（亦支持启动后在网页端直接粘贴激活） |
TZ | 系统时区 | Asia/Shanghai | 推荐 |
目录挂载推荐
/app/downloads➔ 挂载到您的机械硬盘或 NAS 共享存储空间（用于存放下载的庞大视频文件）。/app/database➔ 挂载到您的 SSD 固态硬盘（PostgreSQL 数据库高频读写，固态硬盘能显著提高并发同步流畅度）。
📖 三步上手指南
1️⃣ 第一步：登录控制台
部署完成后，在浏览器中访问 http://服务器IP:888，使用您在环境变量中预设的管理员账户密码进行登录。
2️⃣ 第二步：激活高级功能 (免重启)
如果您拥有高级版授权，进入 “系统设置” ➔ “授权设置” 选项卡。直接在**“图形化授权配置”**框中粘贴您的激活密钥，点击 “保存并验证”。 系统会实时秒级激活高级版专业特性（自动化任务调度引擎、媒体流持续录制守护、大模型 AI 摘要提取等），完全不需要重启容器。
3️⃣ 第三步：开始解析与订阅
- 单链解析：在首页输入框粘贴支持的媒体链接或标准分享链接，快速解析并一键下载。
- 创作者订阅：在“订阅”页面输入关注的创作者主页链接，配置检测周期，系统将按设定频率自动检查并同步新发布内容。
- 直播录制订阅：在“直播”页面添加目标直播间地址，系统全自动监控直播状态，开播即录、停播即转码归档。
💡 交流与支持：部署完成后，可在 Web 控制台顶部常驻按钮进入官方交流社群。
⚖️ 免责声明
- 技术中立性：本项目为通用的个人媒体资源管理与私有云自动化工具，旨在帮助用户对其拥有合法访问权限的媒体内容进行本地整理、格式转换、AI 辅助摘要与家庭私有云（NAS）离线归档。
- 合规使用原则：本软件仅供个人学习、研究与合理使用。用户在使用本软件过程中，应严格遵守所在国家/地区的法律法规，尊重各媒体平台的服务条款（ToS）及内容创作者的著作权与知识产权。严禁将本软件用于任何商业转售、批量非法采集、侵权盗版或侵犯第三方合法权益的行为。
- 免责条款：软件作者不提供任何内容托管或破解服务，不对用户因不当使用本软件或其衍生工具而产生的任何直接或间接法律责任承担连带责任。使用本软件即视为您已完全知悉并无保留同意此免责声明。
软件作者：bigv | 用心服务，带给您高效而优雅的媒体资源管理体验
Tag summary
Content type
Image
Digest
sha256:f84506310…
Size
1.2 GB
Last updated
1 day ago
docker pull easynashub/easy-vdl