README.md

bili-sync

专为 NAS 用户打造的哔哩哔哩同步工具，基于 Rust & Tokio 构建。

📚 在线文档 | 🚀 快速开始 | 📝 更新日志

✨ 核心特性

🎯 智能化功能

• 充电视频智能识别 - 自动检测并处理充电专享视频，无需人工干预
• 失败任务智能筛选 - 一键筛选失败任务，快速定位问题
• 任务队列持久化 - 程序重启后自动恢复任务状态
• 配置热重载 - 修改配置立即生效，无需重启

🎬 视频源支持

• 收藏夹 - 直接显示用户所有收藏夹，支持快速选择
• UP主投稿 - 输入UP主ID查看所有合集/系列
• 稍后再看 - 自动同步稍后再看列表
• 番剧下载 - 支持单季和全季下载模式

🚀 技术优势

• 高性能 - Rust + Tokio 异步架构，支持高并发
• 内存优化 - 智能内存数据库模式，提升扫描性能
• Web管理 - 友好的 Web 界面，无需命令行操作
• 自动重试 - 智能错误处理和重试机制

🚀 快速开始

使用 Docker（推荐）

docker run -d \
  --name bili-sync \
  -p 12345:12345 \
  -v ./data:/data \
  qq1582185982/bili-sync-01:latest

docker-compose

services:

  bili-sync:
    image: docker.cnb.cool/sviplk.com/docker/bili-sync:beta
    # build:
    #   context: .
    #   dockerfile: Dockerfile
    restart: unless-stopped
    network_mode: bridge
    # 该选项请仅在日志终端支持彩色输出时启用，否则日志中可能会出现乱码
    tty: false
    # 非必需设置项，推荐设置为宿主机用户的 uid 及 gid (`$uid:$gid`)
    # 可以执行 `id ${user}` 获取 `user` 用户的 uid 及 gid
    # 程序下载的所有文件权限将与此处的用户保持一致，不设置默认为 Root
    # user: 1000:1000
    hostname: bili-sync
    container_name: bili-sync
    # 程序默认绑定 0.0.0.0:12345 运行 http 服务
    ports:
      - 12345:12345
    volumes:
      - /volume1/Cloudreve/OD/20/config:/app/.config/bili-sync
      - /volume1/Cloudreve/OD/20:/Downloads #下载目录 在前端直接/Downloads就是下载到/volume1/Cloudreve/OD/20 

    environment:
      - TZ=Asia/Shanghai
      - RUST_LOG=None,bili_sync=info
      # 可选：设置执行周期，默认为每天凌晨3点执行
      # - BILI_SYNC_SCHEDULE=0 3 * * *
    # 资源限制（可选）
    # deploy:
    #   resources:
    #     limits:
    #       cpus: '2'
    #       memory: 2G
    #     reservations:
    #       cpus: '0.5'
    #       memory: 500M

二进制文件

从 Releases 下载对应平台的可执行文件。

开发环境

# 克隆项目
git clone https://github.com/qq1582185982/bili-sync-01
cd bili-sync-01

# 安装依赖并启动
./make.bat setup
./make.bat dev

访问 http://localhost:12345 进入管理界面。

📸 界面预览

点击展开截图

管理界面

视频详情

文件结构

🛠️ 配置说明

首次启动会自动进入设置向导，引导您完成：

• Cookie 配置
• 下载路径设置
• 视频源添加

所有配置支持在 Web 界面实时修改。

📂 项目结构

├── crates/                 # Rust 后端
│   ├── bili_sync/          # 主应用
│   ├── bili_sync_entity/   # 数据库实体
│   └── bili_sync_migration/# 数据库迁移
├── web/                    # Svelte 前端
├── docs/                   # VitePress 文档
└── scripts/                # 辅助脚本

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建功能分支 (git checkout -b feature/amazing)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送分支 (git push origin feature/amazing)
5. 创建 Pull Request

📝 许可证

本项目采用 MIT 许可证。

🙏 致谢

• bilibili-API-collect - B站接口文档
• bilibili-api - Python 接口实现参考
• danmu2ass - 弹幕下载功能