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

MaxKB 入门指南：轻松搭建企业级智能知识系统

在企业里做AI应用落地，经常听到一个声音：技术门槛太高了、部署太贵了、迭代周期太长了。MaxKB（全称Max Knowledge Brain）就是冲着这些痛点来的——它把大模型接入、知识库构建、智能问答和流程自动化整合到一个平台上，让团队不用从零开始研究算法和模型调优，就能快速搭出属于自己的AI助手。

一、MaxKB 概述

MaxKB = Max Knowledge Brain，一款企业级智能体平台，核心目标就是降低AI落地的技术门槛和部署成本，缩短迭代周期，帮企业在AI浪潮里抢个先手。

• 接入大模型
  ：DeepSeek、Qwen、OpenAI、Claude……主流模型基本都支持，切换方便。

• 构建专属知识库
  ：把公司内部文档、FAQ、产品手册等文件导入，支持多种格式，系统会自动拆分、向量化，形成可检索的知识资产。

• 能力升级
  ：从最基础的问答（RAG），到复杂的流程自动化，再到智能体编排，梯次进阶。

（这部分官方文档有详细说明，此处不展开）。

也很清晰：前端用Vue.js、LogicFlow；后端是Python/Django加langchain；向量数据库依赖PostgreSQL/pgvector和Redis；大模型方面，DeepSeek、通义千问、Kimi、百度千帆、讯飞星火、智谱AI、OpenAI、Azure OpenAI、Anthropic、Gemini、Ollama……几乎全覆盖。

二、环境要求

正式开始部署前，先确认下服务器环境。官方推荐配置：

• 操作系统
  ：Ubuntu 22.04 或 CentOS 7（内核 ≥ 3.10）

• CPU/内存
  ：4核8GB以上

• 磁盘空间
  ：100GB

• 默认Web端口
  ：8080（可调整）
• PostgreSQL需要支持vector类型扩展（如果用自带的库则不用操心）

三、在线部署方式（不推荐）

虽然官方提供了一键安装命令，但说实话在线部署对网络要求高、速度不稳定，而且升级时容易出问题，所以除非你测试环境网络特别好，否则建议直接用后面的离线方案。这里简单写一下命令，心里有个数就行：

docker run -d --name=maxkb   --restart=always   -p 8080:8080   -v ~/.maxkb:/opt/maxkb   registry.fit2cloud.com/maxkb/maxkb

运行后等所有容器状态变为healthy，通过浏览器访问 http://服务器IP:8080，用默认账号登录：admin / MaxKB@123..，首次会要求修改密码。在线升级就是先拉取新镜像，再停掉旧容器、重新启动，注意数据持久化目录（~/.maxkb）必须保持一致，否则旧数据全丢。

四、离线部署方式（官方推荐）

离线部署更可控，尤其适合生产环境。

注意：下载需要登录官方账号。解压命令：

tar -xf maxkb-v2.2.1-x86_64-offline-installer.tar.gz

进入解压目录，修改 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配置
MAXKB_EXTERNAL_REDIS=false
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_DB=0
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 重载。

如果使用外部数据库，需要先创建maxkb库并执行 CREATE EXTENSION IF NOT EXISTS vector; 启用向量扩展。然后进入解压目录：

cd maxkb-v2.2.1-x86_64-offline-installer/
bash install.sh

安装过程会自动拉镜像、启动容器，等全部完成。

同样等容器healthy后，浏览器访问 http://服务器IP:8080，默认账号 admin / MaxKB@123..，首次登录改密码。

升级前务必备份数据库！下载新版本安装包，解压后进入目录，直接运行 bash install.sh 即可覆盖升级。完成后用 mkctl status 查看状态。

至此，环境搭建完毕，接下来就可以在后台导入知识库、配置大模型、上线智能问答了。