项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Node.js 环境与 pnpm 包管理器(本地运行 pnpm run start:web 需要)
- Docker 与 Docker Compose(容器方式部署需要)
- 可访问 GitHub Container Registry 的网络(使用 ghcr.io 镜像时)
- 磁盘空间用于存放下载的视频与转录数据库
安装与启动步骤
-
1获取桌面客户端
不想折腾环境的话,直接到官网下载页获取对应平台的安装包,安装后即可使用。
-
2克隆项目源码
本地运行或自行构建镜像前,先把仓库拉到本地,并进入项目目录。
git clone https://github.com/nexmoe/VidBee.git cd VidBee -
3本地启动 Web+API
该命令会同时启动 apps/api 与 apps/web 两个服务,适合本地开发调试。
pnpm run start:web -
4Docker 构建启动
在项目根目录执行,会基于 compose 构建并后台启动 api 与 web 容器。
docker compose up -d --build -
5用预构建镜像部署
把 README 中的 compose 配置保存为 docker-compose.yml,再执行启动命令拉取 ghcr 镜像。
docker compose up -d -
6访问 Web 界面
容器启动后,浏览器访问本机 3000 端口的 Web 客户端,API 服务在 3100 端口。
-
7停止服务
需要关闭时在 compose 目录执行,数据保留在命名卷中不会丢失。
docker compose down
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
VIDBEE_API_HOST | 否 | API 服务监听地址,容器内需设为 0.0.0.0 才能对外访问 | 0.0.0.0 |
VIDBEE_API_PORT | 否 | API 服务端口,需与 compose 端口映射保持一致 | 3100 |
VIDBEE_WEB_PORT | 否 | Web 客户端端口,可通过 .env 覆盖 | 3000 |
VIDBEE_DOWNLOAD_DIR | 否 | 下载文件保存目录,建议挂载到主机或 NAS 便于查看 | /data/downloads |
VIDBEE_DATA_DIR | 否 | 应用数据存放目录,用于持久化运行数据 | /data/vidbee |
VIDBEE_HISTORY_STORE_PATH | 否 | 历史记录数据库文件路径,存放下载与转录记录 | /data/vidbee/vidbee.db |
如何确认成功
执行 docker compose ps 确认 api 与 web 容器均在运行,浏览器打开 http://localhost:3000 能看到 Web 界面即成功。
常见问题
Q:只想用桌面版,需要装 Docker 吗?
A:不需要。直接访问 vidbee.org/download 下载对应平台安装包即可,Docker 方式面向自建 Web 与 API 服务的用户。
Q:3000 或 3100 端口被占用怎么办?
A:在 .env 中修改 VIDBEE_WEB_PORT、VIDBEE_API_PORT,并同步调整 compose 里的端口映射,再重新 up。
Q:下载的视频在哪里找?
A:默认在 vidbee-downloads 命名卷中;若要在主机或 NAS 上直接看到文件,把卷换成 /path/on/your/NAS:/data/downloads 这类宿主机路径挂载。
Q:执行 docker compose down 会丢数据吗?
A:不会。下载文件与数据库都在命名卷 vidbee-downloads、vidbee-data 中,down 只停止并移除容器。
Q:项目遇到问题怎么反馈?
A:项目仍在活跃开发中,可在 GitHub 仓库的 issues 页面提交反馈。
注意事项
- README 未给出 Node.js 与 pnpm 的具体版本要求,本地运行前请自行确认环境可用。
- 用预构建镜像方式时,api 的 environment 变量与端口映射需与 web 端访问地址匹配。
- 生产或 NAS 场景建议把下载目录改为宿主机绝对路径挂载,方便直接访问文件。
- 桌面客户端与 Web/Docker 是两种使用形态,按需选择其一即可。
核心亮点
- 支持 1000+ 站点下载,覆盖面远超单一平台工具
- 下载后本地生成可搜索转录稿,长视频内容可快速定位
- AI 服务商可自选,摘要、翻译、问答灵活接入
不足之处
- 依赖第三方站点结构,平台改版可能导致下载失效
- AI 功能需用户自备 API 或本地模型,有使用门槛
适用场景
- 把 B 站或 YouTube 长课程下载后转写,快速生成摘要复习
- 下载外语视频并翻译转录稿,辅助语言学习
- 收集竞品或行业视频素材,建立可搜索的本地内容库
替代项目
yt-dlp、cobalt、Buzz
上一篇:amazon-transcribe-live-meeting-assistant
下一篇:没有了!
同类项目推荐
sunshine-control-panel
开源
一站式管理游戏库、监控内存,AI 助手加持,让大屏启动更高效。
Sunshine Foundation 大屏桌面管理器 | Tauri + Vue 3,游戏库管理、米塔AI助手、内存监控···
Stirling PDF
开源
本地部署 PDF 工具箱
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
obsidian-md2wechat
开源
一键将 Obsidian 笔记排版成公众号文章,告别手动调格式
Obsidian → WeChat | Obsidian 插件一键排版发布到微信公众号,键排版发布到微信公众号:···
pdf2md
开源
浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。
Browser based tool to convert PDFs to Markdown
