> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/nexmoe/VidBee) · [上游 README](https://github.com/nexmoe/VidBee/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
VidBee 是一款现代化的开源视频下载器，可让你从全球 1000+ 个网站下载视频和音频。基于 Electron 构建，并由 yt-dlp 驱动，VidBee 提供简洁直观的界面以及强大的下载功能，满足你的各类下载需求，包括 RSS 自动下载自动化——可自动订阅订阅源，并在后台从你喜爱的创作者处下载新视频。
## 👋🏻 入门指南
VidBee 目前仍在积极开发中，欢迎就遇到的任何 [issue](https://github.com/nexmoe/VidBee/issues) 提供反馈。
[📥 下载 VidBee](https://vidbee.org/download/) | [📚 文档](https://docs.vidbee.org)
> [!IMPORTANT]
>
> **为我们点 Star**，你将第一时间收到 GitHub 上的所有版本发布通知 ~
## ✨ 功能特性
### 🌍 全球视频下载支持
通过强大的 yt-dlp 引擎，从全球几乎任何网站下载视频。支持 1000+ 个站点，包括 YouTube、TikTok、Instagram、Twitter 等。
### 🎨 一流的 UI 体验
现代化、简洁的界面，操作直观。支持一键暂停/恢复/重试、实时进度跟踪，以及完善的下载队列管理。
### 📡 RSS 自动下载
自动订阅 RSS 订阅源，并在后台从你喜爱的创作者处自动下载新视频，覆盖 YouTube、TikTok 等平台。只需配置一次 RSS 订阅，VidBee 便会自动下载新上传内容，无需手动操作，非常适合持续关注你喜爱的频道和创作者。
### 🎞️ 可配置的输出容器
可在 **Auto (MP4/MKV)**、**MP4**、**MKV**、**WebM** 或 yt-dlp 的 **Original** 默认选项之间选择，实现一键下载——再也不用纠结最终会拿到 MP4 还是 WebM。完整说明见 [Formats & Containers](https://docs.vidbee.org/formats)。
## 🌐 支持的网站
VidBee 通过 yt-dlp 支持 1000+ 个视频和音频平台。完整支持列表请访问 [https://vidbee.org/supported-sites/](https://vidbee.org/supported-sites/)
## 🧱 Web + API（支持 Docker）
此 monorepo 现已包含：
- `packages/downloader-core`：共享的 yt-dlp/ffmpeg 下载核心
- `apps/api`：基于 Fastify 的 API 服务器，支持 oRPC 与 SSE 事件
- `apps/web`：使用 oRPC 的 TanStack Start Web 客户端
本地运行：
```bash
pnpm run start:web
```
该命令会同时启动 `apps/api` 和 `apps/web`。
使用 Docker 运行：
```bash
docker compose up -d --build
```
使用 GitHub Container Registry 镜像运行：
```yaml
services:
api:
image: ghcr.io/nexmoe/vidbee-api:latest
environment:
VIDBEE_API_HOST: 0.0.0.0
VIDBEE_API_PORT: 3100
VIDBEE_DOWNLOAD_DIR: /data/downloads
VIDBEE_HISTORY_STORE_PATH: /data/vidbee/vidbee.db
ports:
- "3100:3100"
volumes:
- vidbee-downloads:/data/downloads
- vidbee-data:/data/vidbee
restart: unless-stopped
web:
image: ghcr.io/nexmoe/vidbee-web:latest
depends_on:
- api
ports:
- "3000:3000"
restart: unless-stopped
volumes:
vidbee-downloads:
vidbee-data:
```
停止服务：
```bash
docker compose down
```
可选环境变量（通过 `.env`）：
```bash
VIDBEE_API_PORT=3100
VIDBEE_WEB_PORT=3000
VITE_API_URL=http://localhost:3100
```
## 🤝 参与贡献
欢迎加入开源社区，一起共建。更多详情请查看：
- Monorepo 应用：
- `apps/desktop`：VidBee 桌面应用（Electron）
- `apps/docs`：文档站点（Fumapress）
- `apps/extension`：浏览器扩展（WXT）
- `apps/desktop/docs/glitchtip.md`：GlitchTip 与 `sentry-cli` 的桌面监控配置
- [贡献指南](./CONTRIBUTING.md)
- [DeepWiki Documentation](https://deepwiki.com/nexmoe/VidBee)
## 📄 许可证
本项目基于 MIT License 发布。详情请参阅 [`LICENSE`](LICENSE)。
## 🙏 致谢
- [yt-dlp](https://github.com/yt-dlp/yt-dlp) - 强大的视频下载引擎
- [FFmpeg](https://ffmpeg.org/) - 用于音视频处理的多媒体框架
- [Electron](https://www.electronjs.org/) - 构建跨平台桌面应用
- [React](https://react.dev/) - UI 库
- [Vite](https://vitejs.dev/) - 下一代前端工具链
- [Tailwind CSS](https://tailwindcss.com/) - 实用优先的 CSS 框架
- [shadcn/ui](https://ui.shadcn.com/) - 精心设计的组件
