BiliSum Docker 部署指南:一条命令跑起 AI 视频摘要服务

原创2026-11-06 14:28:162,293 阅读

BiliSum Docker 部署指南:一条命令跑起 AI 视频摘要服务

BiliSum 是一款开源的 AI 视频摘要与知识库工具,支持 Bilibili、YouTube 和本地视频:自动转写、生成文本笔记、图文笔记、思维导图,并内置跨视频 RAG 问答。本教程带你用 Docker 部署 BiliSum,一条 docker run 命令即可把这套 AI 视频摘要服务跑起来,无需安装 Python 环境。

部署前先了解:BiliSum 能做什么

部署后你会得到一个 Web 工作台,核心流程是:

B 站 / YouTube / 本地视频  →  转写  →  文本笔记  →  图文笔记  →  思维导图  →  知识库问答

BiliSum 首页工作台:AI 视频摘要任务与收藏视频管理界面

首页可以直接粘贴 Bilibili / YouTube 链接或 BV 号,点击"开始总结"即可排队处理;左侧边栏提供视频库、知识库(检索与问答)和设置页。

一条命令启动 BiliSum Docker 容器

前置要求:已安装并运行 Docker。官方镜像为 lycohana/bilisum:latest:

docker pull lycohana/bilisum:latest

docker run --rm -p 3838:3838 \
  -v bilisum-data:/data \
  -e VIDEO_SUM_ACCESS_TOKEN=your-token \
  lycohana/bilisum:latest

这条命令里只有 4 个关键点,新手只需记住它们:

参数 作用
-p 3838:3838 把容器内的服务端口 3838 映射到本机,浏览器通过它访问
-v bilisum-data:/data 把数据库、任务、缓存全部放进命名卷,容器删除后数据不丢
-e VIDEO_SUM_ACCESS_TOKEN=... 设置 API 访问令牌,换成你的长随机字符串更安全
--rm 容器停止后自动清理,数据都在卷里,放心删

镜像基于 Python 3.12 构建,已内置 ffmpeg 和全部依赖(见 Dockerfile),数据根目录默认在容器的 /data。

访问 BiliSum Web 界面

容器启动后,浏览器打开:

http://127.0.0.1:3838

首次访问会要求输入 访问密钥(即你设置的 VIDEO_SUM_ACCESS_TOKEN)。验证成功后,任务结果页会展示 AI 生成的视频摘要:核心概览、要点列表、章节时间轴,并内嵌视频播放器。

BiliSum 视频摘要详情页:AI 生成的核心概览、要点与章节时间轴

配置 LLM 与转写:环境变量清单

BiliSum 的摘要和转写需要外接模型服务,全部通过 VIDEO_SUM_ 前缀的环境变量配置(完整变量表见 docs/configuration.md)。最常用的一组:

docker run --rm -p 3838:3838 \
  -v bilisum-data:/data \
  -e VIDEO_SUM_ACCESS_TOKEN=your-token \
  -e VIDEO_SUM_LLM_ENABLED=true \
  -e VIDEO_SUM_LLM_BASE_URL=https://coding.dashscope.aliyuncs.com/v1 \
  -e VIDEO_SUM_LLM_MODEL=qwen3.5-plus \
  -e VIDEO_SUM_LLM_API_KEY=your-key \
  -e VIDEO_SUM_SILICONFLOW_ASR_API_KEY=your-key \
  lycohana/bilisum:latest
  • VIDEO_SUM_LLM_*:控制 AI 摘要模型(支持 OpenAI 兼容接口、Anthropic、本地模型等)
  • VIDEO_SUM_SILICONFLOW_ASR_API_KEY:转写服务的 Key,默认使用 SiliconFlow ASR
  • VIDEO_SUM_KNOWLEDGE_ENABLED=true:额外启用知识库索引,让跨视频问答可用

配置优先级为:设置页保存的设置 > 环境变量 > .env > 内置默认值,详细说明在 docs/configuration.md。

启用知识库后,AI 会对你所有已总结的视频建立语义索引,可以直接提问"高数学到哪了"这类问题,答案带视频出处:

BiliSum 知识库 RAG 问答界面:跨视频检索与 AI 问答

数据持久化:/data 目录里有什么

所有持久化内容都落在挂载的 /data 卷(对应 VIDEO_SUM_APP_DATA_ROOT):

路径 内容
/data/video_sum.db SQLite 数据库(任务、视频、知识库索引)
/data/tasks 各任务的转写、摘要、笔记产物
/data/cache 视频与模型缓存

因此更新版本只需换镜像重启,bilisum-data 卷不动,历史记录原样保留。

BiliSum 知识笔记页:结构化的 Markdown 笔记与视频播放器并排展示

Docker 部署常见问题速查

  • 端口被占用:把 -p 3838:3838 改成 -p 8080:3838 之类,本机访问 http://127.0.0.1:8080 即可。
  • 提示访问密钥无效:请求携带的 token 必须与 VIDEO_SUM_ACCESS_TOKEN 一致;忘记时可删除数据卷中的 auth.json 重新生成。
  • B 站视频被风控:设置 VIDEO_SUM_YTDLP_COOKIES_FILE 挂载你的 Cookies 文件,详见 docs/configuration.md。
  • 想用 CLI 对接 Docker 服务:启动容器后可直接 bilisum summarize "https://..." --host 127.0.0.1 --port 3838 --token <你的token>,说明见 docs/cli.md。

小结

BiliSum 的 Docker 部署非常简单:docker run 一条命令启动,一个命名卷保存全部数据,几个环境变量接通 LLM 与转写服务,打开 http://127.0.0.1:3838 即可使用 AI 视频摘要、图文笔记和知识库问答。后端实现可参考 apps/service/src/video_sum_service/ 目录,服务入口在 main.py。

登录后查看全文
BiliSum