MaxKB

把企业知识装进 AI，员工问啥都有标准答案

强大易用的开源企业级智能体平台。开箱即用，提供知识库管理、智能问答与 Agent 编排能力，帮助企业快速构建私有化的 AI 助手应用，显著提升知识服务效率。

开源 freemium 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 22864

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类对话助手

开发团队1Panel-dev

所属国家

官网地址https://maxkb.cn

GitHubhttps://github.com/1Panel-dev/MaxKB

定价模式freemium

价格说明开源社区版免费，企业版提供增值功能，具体价格需咨询官网。

访问状态

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型agent,agentic-ai,chatbot,deepseek-r1,knowledgebase,langchain,llama3,llm,maxkb,mcp-server,ollama,pgvector,qwen3,rag

GitHub 星标★ 22864

30天Star增速

HF 下载量

上线时间2023-09-14 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数12

使用教程

难度：入门约 10 分钟部署方式：Docker 5 步

环境要求

已安装 Docker 环境（docker run 可用）
服务器可访问 8080 端口（或自行映射其他端口）
建议预留本地目录用于持久化数据，如 ~/.maxkb

安装与启动步骤

1启动 MaxKB 容器

一条 docker run 命令即可拉起 MaxKB，容器随 Docker 重启自动恢复；数据挂载到 ~/.maxkb 持久保存。
```
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb
```
2查看容器运行状态

确认容器已启动且状态为 Up，若未起来可用 docker logs maxkb 查看报错信息。
```
docker ps
```
3访问 Web 界面

浏览器打开 http://你的服务器IP:8080 即可进入 MaxKB 控制台页面。
4使用默认账号登录

用户名 admin，密码 MaxKB@123..，登录后即可开始配置知识库与智能体。
5镜像拉取失败处理

中国用户如遇到 Docker 镜像 Pull 失败，请参照官方离线安装文档进行安装。

关键配置

配置项	必填	说明	示例
`-p 8080:8080`	是	将容器 8080 端口映射到宿主机 8080 端口	`-p 8080:8080`
`-v ~/.maxkb:/opt/maxkb`	是	挂载数据目录，保证配置与知识库数据持久化	`-v ~/.maxkb:/opt/maxkb`
`--name=maxkb`	否	指定容器名称，便于后续启停和查看日志	`--name=maxkb`
`--restart=always`	否	容器随 Docker 服务自动重启，避免意外退出	`--restart=always`

如何确认成功

浏览器访问 http://你的服务器IP:8080 能打开登录页，用 admin / MaxKB@123.. 成功登录即部署成功。

常见问题

Q：默认登录账号密码是什么？

A：用户名 admin，密码 MaxKB@123..，登录后建议尽快修改默认密码。

Q：Docker 拉取镜像失败怎么办？

A：中国用户可参照官方离线安装文档 https://maxkb.cn/docs/v2/installation/offline_installtion/ 进行离线安装。

Q：8080 端口被占用怎么办？

A：修改命令左侧端口号，例如 -p 9080:8080，然后访问 http://你的服务器IP:9080。

Q：如何停止或重启容器？

A：使用 docker stop maxkb 停止，docker start maxkb 启动，容器名为启动时指定的 maxkb。

注意事项

首次登录后请立即修改 admin 默认密码，避免安全风险。
数据保存在宿主机的 ~/.maxkb 目录，删除容器不会丢失数据，但请勿随意删除该目录。
升级或迁移前建议先备份 ~/.maxkb 目录。
若需对外提供服务，请自行配置反向代理与 HTTPS 加密。

核心亮点

基于RAG与向量检索（pgvector）实现企业知识库问答，支持多模型接入（DeepSeek、Qwen、Ollama等），落地门槛低
提供可视化工作流编排与MCP服务器支持，便于构建复杂智能体应用，降低开发成本
开源协议友好，社区活跃（22k+星标），文档完善，适合快速二次开发

不足之处

文档/社区待观察
依赖外部模型服务（如Ollama、DeepSeek），自托管时对硬件资源要求较高

适用场景

企业内部知识库问答与客服自动化
基于私有数据的RAG智能体开发（如法律、医疗、金融咨询）
快速搭建多模型统一接入的对话平台原型

替代项目

Dify、FastGPT、RAGFlow

项目介绍

MaxKB 是智能体领域的开源项目，由 1Panel-dev 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（22,864）位列前 3%，在智能体分类的 2,499 个项目里位列前 3%。

近 44 天，它的 GitHub 星标从 22,450 增加到 22,864，净增 414。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。开源社区版免费，企业版提供增值功能，具体价格需咨询官网。从国内网络环境看，可直接访问。

它主要面向的使用场景是：企业内部知识库问答与客服自动化。同类可对比的替代方案包括 Dify、FastGPT、RAGFlow。

上一篇：agentscope

下一篇：coze-studio