MaxKB——基于LLM大语言模型的知识库问答系统，一键快速部署教程来了-阿里云开发者社区

MaxKB——基于LLM大语言模型的知识库问答系统，一键快速部署教程来了

2026-04-16 23

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： MaxKB是一款基于大语言模型（LLM）与RAG技术的开源知识库问答系统，支持企业知识管理、智能客服、教育科研等场景。本文提供阿里云轻量应用服务器一键部署教程，含模型接入、知识库构建、应用创建及第三方嵌入全流程，开箱即用。

MaxKB——基于LLM大语言模型的知识库问答系统，一键快速部署教程来了，MaxKB（Max Knowledge Base）是一款基于大语言模型和RAG的开源知识库问答系统，广泛应用于企业内部知识库、客户服务、学术研究与教育等场景。本文阿小云整理使用MaxKB应用镜像快速搭建基于大语言模型的知识库问答系统，使用阿里云轻量应用服务器的MaxKB应用镜像：https://www.aliyun.com/product/swas 如下图：

阿里云轻量应用服务器官方介绍.jpg

MaxKB部署教程操作步骤

步骤一：部署MaxKB

重要

如果您已购买轻量应用服务器，可以跳过此步骤，以重置系统的方式部署MaxKB（重置系统时选择应用镜像下的MaxKB镜像），但重置系统会清除轻量应用服务器上的系统盘数据，请您根据需要做好数据备份。

访问轻量应用服务器控制台-服务器：https://www.aliyun.com/product/swas
在页面左上角，单击创建服务器。
在轻量应用服务器页面，根据界面提示完成资源配置，具体配置项说明如下表所示。
说明
不同地域及其实例规格类型支持的镜像和套餐可能不同，具体请以控制台购买页为准。

配置项	示例	说明
实例	实例规格族：通用型套餐：￥224/月	选择实例规格族：包括通用型、多公网IP型、国际型和容量型。不同规格族的适用场景和特点，请参见实例规格族。选择套餐：单击，可选择更多套餐。套餐中包含vCPU、内存、系统盘、公网流量包等指标信息。更多信息，请参见实例规格指标说明。
镜像	应用镜像：MaxKB 版本： 1.10.2	在应用镜像页签下，单击MaxKB。
地域	新加坡	请根据业务所在的地理位置选择就近地域，降低网络延迟。服务器创建后不支持更换地域，请谨慎选择。重要非中国内地地域，例如中国香港、新加坡等地域的服务器，提供国际带宽，因此，当您在中国内地访问服务器时，会有较大的网络延迟。因此建议选择和您目标用户所在地域最为接近的地域，可以进一步提升用户访问速度。更多信息，请参见地域与网络连通性。
购买配置	数量：1 时长：1个月	数量：购买服务器的台数，默认为1台。时长：选择购买服务器的时长，默认为1个月。重要如果您的实例用于Web服务，中国内地必须完成ICP备案，备案实例（含续费）时长需在3个月及以上。更多信息，请参见备案域名。按月购买：支持购买1个月、3个月和6个月。按年购买：支持购买1年、2年和3年。默认启用自动续费功能，避免服务器到期后忘记续费，导致服务器释放，从而影响您的业务。更多信息，请参见续费服务器。按月购买：续费周期为1月。按年购买：续费周期为1年。

完成配置后，单击立即购买，根据界面提示完成付费操作。
支付完成后，单击进入管理控制台。当服务器状态由准备中变为运行中，表示MaxKB服务器已经部署成功。

步骤二：登录MaxKB

放行端口并获取MaxKB登录信息。

在服务器页面，单击目标服务器的实例ID，进入服务器概览页面。
单击应用详情页签，放行所需端口并获取MaxKB首页地址、管理员账号和密码。具体操作说明：

在图中①区域，单击一键放通，放通MaxKB所需的8080端口。
在图中②区域，获取MaxKB首页地址http://47.178.XX.XX:8080。
在图中③区域，单击快速查看，在弹出的快速查看对话框中，获取MaxKB默认管理员用户名和密码。

登录MaxKB。
在本地电脑中，在浏览器中输入MaxKB首页地址http://47.178.XX.XX:8080，并输入默认管理员用户名和密码后，单击登录。首次登录后，请根据界面提示及时修改默认密码，避免造成数据泄露。

步骤三：使用MaxKB

本步骤主要介绍使用MaxKB制作企业知识库小助手的基本流程，关于MaxKB的更多使用，请参见MaxKB官方文档。

1. 添加模型

模型管理用于对接供应商的大语言模型，支持对接主流的大模型，支持的类型包括文本生成、向量模型、重排、语音识别、语音合成、视觉模型、图片生成等。更多信息，请参见模型管理。

在左侧顶部菜单，单击系统设置。
在左侧导航栏，单击模型设置。
在模型设置页面，单击添加模型。
根据界面提示，选择模型供应商。
本示例选择阿里云百炼。
根据界面提示，设置模型参数后，单击保存。
不同模型对应的参数可能不同，其他模型，请参见模型对接。

参数	说明	示例
模型名称	输入MaxKB中自定义的模型名称。	qwen-turbo
权限	按需选择权限：私有：仅当前用户使用。公有：所有用户都可以使用。	私有
模型类型	下拉列表选择模型类型。	大语言模型
基础模型	在下拉列表中选择模型。	qwen-turbo
API URL	输入模型服务API服务访问地址，本示例直接输入`https://dashscope.aliyuncs.com/compatible-mode/v1`即可。目前仅当模型类型是大语言模型时需要输入。	https://dashscope.aliyuncs.com/compatible-mode/v1
API Key	输入模型服务API服务访问密钥。本示例您需要在阿里云百炼控制台获取API Key。具体操作，请参见获取API Key。	sk-88473bc3a451436aa9e172ff4a43****

2. 创建知识库

企业私有的专业知识库，包含各种类型的数据，是问答对话中回答用户问题的知识来源。关于知识库的更多信息，请参见知识库。

在左侧顶部菜单，单击知识库。
在知识库页面，单击创建知识库。
在弹出的创建知识库对话框中，配置参数。

参数	说明	示例
知识库名称	请输入知识库名称。	test
知识库描述	请输入知识库描述信息。	-
向量模型	在下拉列表中，选择向量模型。	maxkb-embedding
知识库类型	按需选择知识库模型：通用型：对离线文档上传管理，支持的文本文件、表格以及QA问答对。 web站点：用于获取在线静态文本数据管理，输入Web站点地址后，自动同步根地址及子级地址的文本数据。	web站点
Web根地址	当知识库类型为Web站点时，需要输入文档的根目录。本示例输入轻量应用服务器帮助文档的根目录。	https://help.aliyun.com/zh/simple-application-server/

单击创建后，查看文件状态。
请耐心等待，系统会自动爬取根地址及子地址的文本数据，按照URL地址生成文档，并自动拆分和进行向量化处理。当所有文档的文件状态由排队中变为成功，表示创建知识库完成。

3. 创建应用

本示例以创建轻量应用服务器产品智能问答小助手应用为例，更多信息，请参见应用。

创建应用。

在左侧顶部菜单，单击应用。
在应用页面，单击创建应用。
说明
如果您已有对应的应用，单击导入应用。
在弹出的创建应用对话框中，根据界面提示配置参数后，单击创建。

参数	说明	示例
应用名称	请输入应用名称。	AI智能小助手
应用描述	请输入该应用的应用场景及用途。	轻量应用服务器产品智能问答
选择应用类型	按需选择应用类型：简单配置：适合新手创建小助手。高级编排：适合高级用户自定义小助手的工作流。	简单配置

在设置页面，根据界面提示配置参数。
关键参数说明如下，其他参数请按需配置。

参数	说明	示例
AI模型	在下拉列表中选择已添加的模型。	qwen-turbo
系统角色	请输入角色信息。	你是智能问答小助手
提示词	系统默认有智能知识库的提示词，用户可以自定义通过调整提示词内容，引导大模型聊天方向。可对无引用知识库和引用知识库两种情况分别设置不同的提示词。	{question}
关联知识库	单击添加，选择已创建的知识库。	-
开场白	输入用户打开对话时，系统弹出的问候语。	您好，我是智能问答小助手，您可以向我提出使用轻量应用服务器的问题。 - 主要功能有什么？ - 如何收费？ - 转人工服务

在调试预览区域，调试后在页面右上角，单击保存并发布。

验证结果。

在左侧导航栏，单击概览。
在概览页面单击演示或在浏览器中复制公开访问链接。
进入问答页面，输入问题进行提问。

4. 应用集成

MaxKB应用支持零编码快速嵌入第三方Web系统，嵌入代码后，便可在第三方系统中进行问答。

在应用信息区域中，单击嵌入第三方。
在弹出的嵌入第三方对话框中，根据需求在全屏模式或者浮窗模式中，单击图标，复制对应的嵌入代码。
嵌入完成后，便可在第三方系统中进行问答。

嵌入后的效果如下：

更多关于阿里云轻量应用服务器使用，请移步到轻量官方页面查看：https://www.aliyun.com/product/swas

MaxKB——基于LLM大语言模型的知识库问答系统，一键快速部署教程来了

MaxKB部署教程操作步骤

步骤一：部署MaxKB