MaxKB是一款基于大语言模型和RAG的开源知识库问答系统,目前阿里云轻量应用服务器支持MaxKB应用镜像,阿小云整理轻量应用服务器一键部署MaxKB全流程,包括使用教程如添加模型、创建知识库、创建应用和应用集成新手教程:
步骤一:创建轻量应用服务器
阿里云轻量应用服务器:https://www.aliyun.com/product/swas 打开轻量页面后,点击立即购买,因为是运行MaxKB,所以CPU内存配置至少2核4G配置:

阿小云以通用型2核4G配置为例,应用镜像选择“MaxKB”,如下图:

然后选择地域,地域选择后不能修改,所以一定要谨慎选择,一般建议就近选择地域,关于轻量应用服务器的地域选择可以参考官方文档:https://help.aliyun.com/zh/simple-application-server/product-overview/regions-and-network-connectivity
步骤二:登录MaxKB
登录到阿里云轻量应用服务器管理控制台 放行端口并获取MaxKB登录信息。
- 1、在服务器页面,单击目标服务器的实例ID,进入服务器概览页面。
- 2、单击应用详情页签,放行所需端口并获取MaxKB首页地址、管理员账号和密码。

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

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

步骤三:使用MaxKB
本步骤主要介绍使用MaxKB制作企业知识库小助手的基本流程:
1. 添加模型
模型管理用于对接供应商的大语言模型,支持对接主流的大模型,支持的类型包括文本生成、向量模型、重排、语音识别、语音合成、视觉模型、图片生成等
- 在左侧顶部菜单,单击系统设置。
- 在左侧导航栏,单击模型设置。
- 在模型设置页面,单击添加模型。
- 根据界面提示,选择模型供应商。
本示例选择阿里云百炼。 - 根据界面提示,设置模型参数后,单击保存。
不同模型对应的参数可能不同,其他模型,请参见模型对接。

2. 创建知识库
企业私有的专业知识库,包含各种类型的数据,是问答对话中回答用户问题的知识来源。
- 在左侧顶部菜单,单击知识库。
- 在知识库页面,单击创建知识库。
- 在弹出的创建知识库对话框中,配置参数。

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

3.创建应用
本示例以创建轻量应用服务器产品智能问答小助手应用为例
- 在左侧顶部菜单,单击应用。
- 在应用页面,单击创建应用。
- 在弹出的创建应用对话框中,根据界面提示配置参数后,单击创建。

- 在设置页面,根据界面提示配置参数。
关键参数说明如下,其他参数请按需配置。
- 在调试预览区域,调试后在页面右上角,单击保存并发布。
验证结果。
- 在左侧导航栏,单击概览。
- 在概览页面单击演示或在浏览器中复制公开访问链接。

进入问答页面,输入问题进行提问。

4. 应用集成
MaxKB应用支持零编码快速嵌入第三方Web系统,嵌入代码后,便可在第三方系统中进行问答。
- 在应用信息区域中,单击嵌入第三方。

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

嵌入后的效果如下:

详细参考轻量应用服务器官方文档 使用应用镜像搭建MaxKB:https://help.aliyun.com/zh/simple-application-server/use-cases/deploy-and-use-maxkb