【本地知识库问答系统】MaxKB搭建本地知识库问答系统

简介

MaxKB是一款基于 LLM 大语言模型的开源知识库问答系统。

• 开箱即用。 无需复杂配置，快速部署上线。预配置的模板和组件让您在几分钟内就能拥有专属的 AI 助手。支持直接上传文档、自动爬取在线文档，支持文本自动拆分、向量化、RAG（检索增强生成），智能问答交互体验好。
• 零编码快速嵌入。 支持零编码快速嵌入到第三方业务系统，让已有系统快速拥有智能问答能力，提高用户满意度。
• 灵活编排。 内置强大的工作流引擎，支持编排AI 工作流程，满足复杂业务场景下的需求。
• 快速接入大模型。 支持对接各种大语言模型，包括本地私有大模型（Llama 3 / Qwen 2 等）、国内公共大模型（通义千问 / 智谱 AI / 百度千帆 / Kimi / DeepSeek 等）和国外公共大模型。（OpenAI / Azure OpenAI / Gemini 等）。

1 前置工作

上面章节已经实现了ollama里部署llama3，并实现了一些简单的问答，但是问答的界面是在命令提示符中，交互很不友好，也不方便局域网其他用户访问，所以本文用docker部署MaxKB实现网页访问llama3

• ollama的下载与安装。教程
• 大模型的下载与安装。教程

2 MaxKB的安装

在配置 docker 环境的操作系统中，仅需执行以下命令即可一键完成 MaxKB 的安装：

# Linux 操作系统
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb

docker run 用于从指定的镜像创建并启动一个新的容器。
-d 作用：–detach 的简写。让容器在后台运行（“分离模式”）。这样，当你退出终端时，容器不会停止，而是继续在后台运行。如果没有这个参数，容器会占据你的当前终端。

--name=maxkb 作用：为即将创建的容器指定一个名称。 这里将容器命名为 maxkb。之后你可以使用这个名字来方便地管理容器，例如 docker stop maxkb、docker start maxkb，而不需要去记冗长的容器ID。

--restart=always 作用：配置容器的重启策略。 always 表示无论容器因何种原因退出（包括正常退出、异常退出、系统重启等），Docker 都会自动重新启动这个容器。这确保了 MaxKB 服务能够持续在线，非常适合生产环境。

-p 8080:8080 作用：设置端口映射。 格式为 -p <宿主机端口>:<容器内端口>。这个参数将容器内部应用程序监听的 8080 端口映射到宿主机（你的电脑或服务器） 的 8080 端口。这样，你通过浏览器访问 http://<宿主机IP>:8080 时，流量就会被转发到容器内部的 MaxKB 服务。

-v ~/.maxkb:/opt/maxkb 作用：设置数据卷挂载，实现数据持久化。 格式为 -v <宿主机目录>:<容器内目录>。 _{/.maxkb：这是宿主机上的一个目录路径（} 代表当前用户的家目录，例如 /home/your_username/）。Docker 会自动创建这个目录。 /opt/maxkb：这是 MaxKB 容器内部用来存放数据的目录，包括配置、数据库、上传的文件等。 重要性： 如果没有这个参数，容器一旦被删除，里面的所有数据（如知识库配置、对话记录等）都会丢失。通过挂载 volume，数据实际保存在宿主机上，即使容器被删除，数据依然存在。下次重新创建容器时再次挂载，数据就能恢复。

registry.fit2cloud.com/maxkb/maxkb 作用：指定要使用的 Docker 镜像地址。 这是镜像在仓库中的完整路径。Docker 会首先在本地查找是否存在该镜像，如果找不到，则会自动从指定的 registry（这里是 registry.fit2cloud.com）拉取（下载）名为 maxkb/maxkb 的镜像。

使用ip:8080进入maxKB管理界面。

用户名默认是admin，密码默认MaxKB@123…

3 【待续】

参考文章

相关链接：

MaxKb官网
MaxKB文档 v2
MaxKB下载链接
MaxKB知识库：里面有很多案例，或者知识点。（例如：MaxKB + 飞书多维表格 + DataEase：实现任务自动添加、任务查询、周报生成以及数据分析）
飞智云培训认证中心：主要是直播讲解、课程、认证课等。（收费）
飞致云开源社区-b站课程：主要是各种教程。（免费）（例如：1panel使用教程、MaxKB应用案例等）