BiliSum Docker 部署指南:一条命令跑起 AI 视频摘要服务
BiliSum Docker 部署指南:一条命令跑起 AI 视频摘要服务
BiliSum 是一款开源的 AI 视频摘要与知识库工具,支持 Bilibili、YouTube 和本地视频:自动转写、生成文本笔记、图文笔记、思维导图,并内置跨视频 RAG 问答。本教程带你用 Docker 部署 BiliSum,一条 docker run 命令即可把这套 AI 视频摘要服务跑起来,无需安装 Python 环境。
部署前先了解:BiliSum 能做什么
部署后你会得到一个 Web 工作台,核心流程是:
B 站 / YouTube / 本地视频 → 转写 → 文本笔记 → 图文笔记 → 思维导图 → 知识库问答
首页可以直接粘贴 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 生成的视频摘要:核心概览、要点列表、章节时间轴,并内嵌视频播放器。
配置 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 ASRVIDEO_SUM_KNOWLEDGE_ENABLED=true:额外启用知识库索引,让跨视频问答可用
配置优先级为:设置页保存的设置 > 环境变量 > .env > 内置默认值,详细说明在 docs/configuration.md。
启用知识库后,AI 会对你所有已总结的视频建立语义索引,可以直接提问"高数学到哪了"这类问题,答案带视频出处:
数据持久化:/data 目录里有什么
所有持久化内容都落在挂载的 /data 卷(对应 VIDEO_SUM_APP_DATA_ROOT):
| 路径 | 内容 |
|---|---|
/data/video_sum.db |
SQLite 数据库(任务、视频、知识库索引) |
/data/tasks |
各任务的转写、摘要、笔记产物 |
/data/cache |
视频与模型缓存 |
因此更新版本只需换镜像重启,bilisum-data 卷不动,历史记录原样保留。
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。



