MaxKB 开源知识库问答系统部署与使用指南
MaxKB 是一款基于 LLM 的开源知识库问答系统,支持文档上传、RAG 检索增强生成及多模型对接。详细介绍其硬件需求、Docker 环境搭建、一键安装命令、后台配置流程以及应用内嵌方法。内容涵盖百度千帆等大模型 API 接入步骤,并补充了安全加固建议与常见问题排查方案,帮助用户快速构建企业级 AI 助手。

MaxKB 是一款基于 LLM 的开源知识库问答系统,支持文档上传、RAG 检索增强生成及多模型对接。详细介绍其硬件需求、Docker 环境搭建、一键安装命令、后台配置流程以及应用内嵌方法。内容涵盖百度千帆等大模型 API 接入步骤,并补充了安全加固建议与常见问题排查方案,帮助用户快速构建企业级 AI 助手。

随着大语言模型(LLM)技术的快速发展,越来越多的企业希望将 AI 能力集成到自己的业务系统中。MaxKB 是一款基于 LLM 的开源知识库问答系统,旨在帮助企业快速构建智能助手。它支持文档上传、自动拆分、向量化及 RAG(检索增强生成),并允许无缝嵌入第三方系统。
MaxKB 对内存有一定要求,建议配置如下:
MaxKB 依赖 Docker 运行。如果环境中未安装 Docker,请先执行以下命令进行安装:
yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum install docker-ce docker-ce-cli containerd.io -y
systemctl start docker
systemctl enable docker
安装完成后,执行 docker version 确认版本信息。
使用一行命令即可启动 MaxKB 容器:
docker run -d --name=maxkb -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data cr2.fit2cloud.com/1panel/maxkb
该命令会创建一个名为 maxkb 的容器,映射 8080 端口,并将数据持久化到宿主机的 ~/.maxkb 目录。
默认登录凭证存在安全风险,首次登录后请立即修改密码:
进入系统后,在设置页面修改管理员密码,并建议开启 HTTPS 访问。
安装完成后,通过浏览器访问 http://服务器 IP:8080 登录系统。
MaxKB 支持将 AI 助手嵌入到现有 Web 项目中,主要方式如下:
适用于简单的展示需求,直接在目标页面添加 iframe 标签:
<iframe src="http://你的 MaxKB 地址/chat" width="100%" height="600px"></iframe>
如需更深度的交互控制,可使用官方提供的 JS SDK。具体接入步骤请参考官方文档,通常涉及引入脚本文件并初始化客户端实例。
docker logs maxkb 获取错误详情。MaxKB 为构建企业级 AI 助手提供了低门槛的解决方案。通过合理的硬件配置和安全设置,用户可以快速实现知识库问答功能。后续可根据业务需求进一步探索工作流编排和多模态支持。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online