MaxKB 开源知识库问答系统部署与使用指南
随着大语言模型（LLM）技术的快速发展，越来越多的企业希望将 AI 能力集成到自己的业务系统中。MaxKB 是一款基于 LLM 的开源知识库问答系统，旨在帮助企业快速构建智能助手。它支持文档上传、自动拆分、向量化及 RAG（检索增强生成），并允许无缝嵌入第三方系统。
1. MaxKB 核心特性
- 开箱即用：支持直接上传文档或爬取在线文档，具备文本自动拆分和向量化能力。
- 无缝嵌入：支持零编码快速嵌入到现有业务系统，提升用户交互体验。
- 灵活编排：内置工作流引擎，支持复杂业务场景下的 AI 流程编排。
- 模型中立：支持对接多种大语言模型，包括本地私有大模型（如 Llama 3、Qwen 2）、国内公共模型（通义千问、智谱 AI、百度千帆等）以及国外公共模型（OpenAI、Gemini 等）。
2. 环境准备
2.1 硬件需求
MaxKB 对内存有一定要求，建议配置如下：
- 操作系统：Ubuntu 22.04 / CentOS 7 64 位及以上版本。
- CPU/内存：推荐 2 核 CPU / 4GB 内存以上（启动后内存占用约 1GB+）。
- 磁盘空间：建议预留 100GB 以上空间用于存储向量数据和日志。
- 网络：服务器需可访问互联网以拉取镜像。
2.2 安装 Docker
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 确认版本信息。
3. 安装 MaxKB
3.1 命令行安装（推荐）
使用一行命令即可启动 MaxKB 容器：
docker run -d --name=maxkb -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data cr2.fit2cloud.com/1panel/maxkb
该命令会创建一个名为 maxkb 的容器，映射 8080 端口，并将数据持久化到宿主机的 ~/.maxkb 目录。
3.2 安全加固建议
默认登录凭证存在安全风险，首次登录后请立即修改密码：
- 默认用户名：admin
- 默认密码：MaxKB@123..
进入系统后，在设置页面修改管理员密码，并建议开启 HTTPS 访问。
4. 创建 AI 应用
安装完成后，通过浏览器访问 http://服务器 IP:8080 登录系统。
4.1 配置大模型
- 进入「模型管理」页面。
- 选择对应的大模型提供商（例如百度千帆、OpenAI 等）。
- 填入 API Key 和 Secret Key。
- 注意：API Key 属于敏感信息，请勿硬编码在代码中，应通过环境变量或系统配置管理。
