bili-sync：NAS用户的B站视频同步工具

简介

bili-sync 是一款专为 NAS 用户设计的哔哩哔哩（B站）视频同步工具，基于 Rust 语言和 Tokio 异步运行时开发，可帮助用户将B站内容（如收藏夹、视频列表、UP主投稿等）自动同步到本地NAS，方便通过媒体服务器管理和播放。

详细使用说明可参考 ***文档

效果演示

通过以下截图直观了解工具的核心界面与使用效果：

• 管理页：Web UI界面，用于配置同步规则、查看任务状态及管理已下载内容。
• 媒体库概览：按分类展示已同步视频，支持快速浏览和检索。
• 媒体库详情：显示单个视频的详细信息，包括标题、UP主、播放量等元数据。
• 播放体验：配合Infuse等媒体播放器，可直接播放已下载的视频文件。
• 文件排布：下载文件按媒体服务器兼容格式命名，支持一键导入Plex、Emby等平台。

核心功能

1. 灵活的内容同步

• 支持多来源同步：可绑定收藏夹、视频列表/合集、“稍后再看”列表及UP主投稿，自动扫描并下载新增内容。
• 凭据自动管理：用户只需填写B站账号凭据，工具会自动完成认证，过期时触发刷新，无需重复操作。

2. 高效的下载与处理

• 智能选流与合并：根据用户预设的清晰度范围，自动选择最优视频/音频流，下载完成后通过FFmpeg合并为完整文件。
• 异步并发优化：基于Tokio和Reqwest实现视频分片、分页的异步并发下载，支持单文件分块并行传输，提升下载效率。
• 容错与重试机制：下载失败的任务会在下一轮同步时重试，多次失败后自动标记并跳过，避免阻塞整体流程。

3. 便捷的管理与配置

• Web UI全功能控制：通过网页界面配置同步规则、调整任务并行度、限制接口请求频率，无需命令行操作。
• 本地数据管理：使用数据库记录媒体信息，避免对同一视频重复请求B站接口，减少资源消耗。
• 风控适配：请求触发B站风控时自动终止当前轮次，等待下一轮执行，降低账号风险。

4. 跨平台兼容性

• 多平台支持：提供Windows、macOS、Linux等系统的二进制可执行文件，开箱即用。
• NAS友好部署：针对Linux平台提供Docker镜像，可直接通过容器引擎部署，适配群晖、威联通等主流NAS系统。

参考与借鉴

项目开发过程中参考了以下开源项目，在此致谢：

• bilibili-API-collect：B站第三方接口文档，提供核心API调用参考。
• bilibili-api：Python版本B站接口实现，为请求逻辑设计提供借鉴。
• danmu2ass：弹幕下载功能的实现参考。