AI视频笔记工具BiliNote本地部署与效率提升指南

2026-04-11 09:17:24作者：韦蓉瑛

BiliNote是一款强大的AI视频笔记生成工具，能够自动解析Bilibili、YouTube、抖音等平台的视频内容，通过AI技术生成结构化的Markdown笔记。本文将通过"准备-部署-优化-使用"四阶段框架，帮助你零基础上手BiliNote本地部署，实现视频学习效率提升。

一、环境准备：部署准备清单

在开始部署BiliNote之前，请确保你的系统满足以下要求并完成必要的环境配置。

1.1 系统要求检查

BiliNote的部署需要以下基础环境支持：

Docker 和 Docker Compose：用于容器化部署服务
内存：至少4GB可用内存，推荐8GB以上
存储：至少10GB空闲磁盘空间
网络：稳定的互联网连接，用于拉取镜像和更新
（可选）NVIDIA GPU：用于AI处理加速

🔑 1.2 环境安装步骤

Step 1/3: 安装Docker和Docker Compose

# Ubuntu系统示例
sudo apt update && sudo apt install -y docker.io docker-compose
sudo systemctl enable --now docker

Step 2/3: 验证Docker安装

docker --version          # 检查Docker版本
docker-compose --version  # 检查Docker Compose版本

Step 3/3: （可选）安装NVIDIA Container Toolkit 如果计划使用GPU加速，需要安装NVIDIA容器工具包：

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt update && sudo apt install -y nvidia-container-toolkit
sudo systemctl restart docker

💡 提示：安装完成后，可以使用nvidia-smi命令检查GPU是否正常识别。

1.3 获取项目代码

使用以下命令克隆BiliNote项目代码到本地：

git clone https://gitcode.com/gh_mirrors/bi/BiliNote.git
cd BiliNote

二、快速部署：三步完成部署

完成环境准备后，我们可以开始部署BiliNote服务了。整个部署过程只需三个简单步骤。

🔑 2.1 配置环境变量

Step 1/3: 复制环境配置文件

cp .env.example .env  # 复制示例配置文件

Step 2/3: 编辑.env文件，设置关键参数

nano .env  # 使用文本编辑器打开配置文件

需要配置的核心参数包括：

BACKEND_PORT：后端服务端口，默认5000
BACKEND_HOST：后端服务地址，默认localhost
APP_PORT：应用访问端口，默认80

Step 3/3: 保存并退出编辑器（nano中按Ctrl+O保存，Ctrl+X退出）

🔑 2.2 启动服务

根据是否需要GPU加速，选择对应的启动命令：

CPU版本启动：

docker-compose up -d  # 后台启动所有服务

GPU版本启动（如果已安装NVIDIA Container Toolkit）：

docker-compose -f docker-compose.gpu.yml up -d  # 启动GPU加速版本

命令执行后，Docker会自动拉取所需镜像并启动三个核心服务：

bilinote-backend：AI处理后端服务
bilinote-frontend：用户界面服务
bilinote-nginx：反向代理服务

💡 提示：可以使用docker-compose ps命令查看服务状态，确保所有服务都处于"Up"状态。

🔑 2.3 访问应用

服务启动后，在浏览器中访问以下地址即可使用BiliNote：

http://localhost:${APP_PORT}  # 将${APP_PORT}替换为.env文件中配置的端口

首次访问时，你将看到BiliNote的初始界面，在这里可以开始使用视频笔记生成功能。

三、性能调优：性能倍增配置

为了获得更好的使用体验，我们可以对BiliNote进行性能优化，特别是启用GPU加速后，可以显著提升AI处理速度。

3.1 GPU加速配置详解

BiliNote的GPU加速版本通过Docker Compose的资源预留功能实现，配置位于docker-compose.gpu.yml中：

deploy:
  resources:
    reservations:
      devices:
        - driver: "nvidia"
          count: "all"
          capabilities: ["gpu"]

这个配置告诉Docker为容器预留所有可用的NVIDIA GPU资源。

3.2 CPU与GPU性能对比

处理任务	CPU处理时间	GPU处理时间	性能提升
10分钟视频转写	120秒	35秒	约3.4倍
复杂AI笔记生成	240秒	65秒	约3.7倍
多任务并行处理	严重卡顿	流畅运行	显著提升

🔑 3.3 资源监控

使用以下命令监控BiliNote服务的资源使用情况：

查看容器CPU和内存使用：

docker stats  # 实时监控所有容器资源使用

查看GPU使用情况：

nvidia-smi  # 查看GPU利用率和内存使用

💡 提示：如果发现服务运行缓慢，可以通过增加内存分配或升级GPU来提升性能。

3.4 常见场景配置

局域网共享配置：要让局域网内其他设备访问BiliNote，需要修改.env文件中的BACKEND_HOST为服务器的局域网IP地址，例如：

BACKEND_HOST=192.168.1.100

多用户设置： BiliNote默认支持多用户使用，每个用户的笔记会保存在独立的目录中。可以通过修改后端配置文件backend/app/core/config.py调整用户相关设置。

四、实用指南：从零开始使用BiliNote

掌握了部署和优化技巧后，让我们来了解如何高效使用BiliNote生成视频笔记。

4.1 基本操作流程

Step 1: 在左侧输入框中粘贴视频链接（支持Bilibili、YouTube、抖音等平台） Step 2: 选择音频质量和AI模型（可在设置中配置更多模型） Step 3: 选择笔记风格和格式（简洁、详细或自定义） Step 4: 点击"生成笔记"按钮开始处理 Step 5: 等待处理完成，查看或导出Markdown笔记

4.2 AI模型配置

BiliNote支持多种AI模型，包括OpenAI、DeepSeek、Qwen等。通过设置页面可以添加和管理模型提供商：

点击界面右上角的设置图标
选择"AI模型设置"
启用所需的模型提供商并输入API信息
测试连接并保存设置

💡 提示：不同模型各有特点，建议根据视频类型和笔记需求选择合适的模型。

4.3 高级功能使用

批量处理： BiliNote支持连续提交多个视频任务，系统会自动按顺序处理。在历史记录中可以查看所有任务的处理状态。

笔记导出：生成的笔记可以直接复制或导出为Markdown格式，方便在其他编辑器中进一步编辑和整理。

自定义提示词：高级用户可以通过设置页面自定义AI生成笔记的提示词，调整笔记的风格和内容重点。

4.4 移动端访问配置

要在移动设备上访问BiliNote，可以通过以下步骤配置：

确保手机和服务器在同一局域网内
在手机浏览器中输入服务器的局域网IP和端口
系统会自动适配移动端界面，提供优化的移动使用体验

4.5 自动化部署脚本

为了简化部署和更新流程，可以创建一个自动化脚本deploy.sh：

#!/bin/bash
# BiliNote自动化部署脚本

# 拉取最新代码
git pull origin main

# 备份旧环境配置
cp .env .env.bak

# 复制新的环境配置示例
cp .env.example .env

# 恢复之前的配置值
grep -E 'BACKEND_PORT|BACKEND_HOST|APP_PORT' .env.bak >> .env

# 启动服务
docker-compose -f docker-compose.gpu.yml up -d --build

echo "BiliNote部署完成！访问地址: http://localhost:$(grep APP_PORT .env | cut -d'=' -f2)"