MaxKB 入门级轻松搭建智能知识系统

一、MaxKB 概述

1、简介

 MaxKB = Max Knowledge Brain，是一款强大易用的企业级智能体平台，致力于解决 企业 AI 落地面临的技术门槛高、部署成本高、迭代周期长等问题，助力企业在人工智能时代赢得先机。

2、功能

• 接入大模型：DeepSeek、Qwen、OpenAI、Claude等等

• 专属知识库：构建企业专属知识库，支持多种格式的文件导入，支持文本自动拆分和向量化。

• 能力升级：基础问答RAG，复杂流程自动化，智能体。

3、工作原理

4、技术栈

• 前端：Vue.js、LogicFlow。

• 后端：Python / Django、langchain。

• 向量数据库：PostgreSQL / pgvector、Redis。

• 大模型：DeepSeek、通义千问、Kimi、百度千帆、讯飞星火、智谱AI、OpenAI、Azure OpenAI、Anthropic、Gemini、Ollama等。

二、环境要求

1、服务器配置

• 操作系统：Ubuntu 22.04 / CentOS 7（内核版本要求 ≥ 3.10）。

• CPU/内存：4C/8GB 以上。

• 磁盘空间：100GB

2、其他配置

• 默认Web 服务端口：8080

• PostgreSQL 需要支持vector类型扩展。

三、在线部署方式,不推荐

1、一键安装

# 配置 Docker 环境的操作系统中，仅需执行以下命令即可一键完成 MaxKB 的安装：docker run -d --name=maxkb   --restart=always   -p 8080:8080   -v ~/.maxkb:/opt/maxkb   registry.fit2cloud.com/maxkb/maxkb

运行结果

2、服务检测

待所有容器状态显示为healthy后，可通过浏览器访问 MaxKB：

http://目标服务器 IP 地址:8080 
------- 默认登录信息 用户名：admin 默认密码：MaxKB@123..

等会后要求修改密码，然后重新登录加载后台系统，如下：

3、在线升级方式

# 下载最新镜像 docker pull registry.fit2cloud.com/maxkb/maxkb  
# 查看并确认上一次数据持久化目录，复制保存 docker inspect maxkb | grep Source  
# 删除正在运行的、旧版本的 MaxKB 容器 docker rm -f maxkb   
#  启动并运行新版本的 MaxKB 容器,持久化目录必需一致，否则无法加载旧版本数据 docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb

# 持久化目录

四、离线部署方式

官方推荐方式

1、下载离线包解压，注意：要求登录后才能下载

# 对安装包进行解压： tar -xf maxkb-v2.2.1-x86_64-offline-installer.tar.gz

官方下载

2、配置文件调整

# 安装配置install.conf文件修改如下：## 安装目录MAXKB_BASE=/opt## 服务端口MAXKB_PORT=8080## docker 网段设置MAXKB_DOCKER_SUBNET=172.31.250.192/26# 数据库配置## 是否使用外部数据库MAXKB_EXTERNAL_PGSQL=false## 数据库地址MAXKB_PGSQL_HOST=pgsql## 数据库端口MAXKB_PGSQL_PORT=5432## 数据库库名MAXKB_PGSQL_DB=maxkb## 数据库用户名MAXKB_PGSQL_USER=root## 数据库密码MAXKB_PGSQL_PASSWORD=Password123@postgres# Redis配置## 是否使用外部RedisMAXKB_EXTERNAL_REDIS=false## Redis地址REDIS_HOST=redis## Redis端口REDIS_PORT=6379## Redis数据库REDIS_DB=0## Redis密码REDIS_PASSWORD=Password123@redis# 镜像配置## 镜像仓库MAXKB_IMAGE_REPOSITORY=registry.fit2cloud.com/maxkb## 镜像名称MAXKB_IMAGE=maxkb## 版本号MAXKB_VERSION=v2.0.0

说明：安装后若调整配置则需要在 ${MAXKB_BASE}/maxkb/.env（默认是 /opt/maxkb/.env），然后mkctl reload 命令重新加载配置文件。

3、执行安装脚本

# 先在外部数据库创建maxkb，然后设置vector扩展 CREATE EXTENSION IF NOT EXISTS vector;  
# 进入安装包解压缩后目录   cd maxkb-v2.2.1-x86_64-offline-installer/  
# 执行安装命令 bash install.sh

注意外部库的扩展

安装完毕：

4、验证服务

待所有容器状态显示为healthy后，可通过浏览器访问 MaxKB：

http://目标服务器 IP 地址:8080 ------- 默认登录信息 用户名：admin 默认密码：MaxKB@123..

等会后要求修改密码，然后重新登录加载后台系统，如下：

5、离线升级

注意： 升级前请先对数据库进行备份。

# 下载新版本安装包上传并解压后，再次执行安装命令进行升级。 # 进入新版本目录 cd maxkb-v2.x.y-offline  
# 运行安装脚本 bash install.sh  
# 查看 MaxKB 运行状态 mkctl status

完成环境的搭建。