MaxKB 企业级智能体平台部署3 条命令跑通 RAG 知识库问答【免费下载链接】MaxKB MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKBMaxKBMax Knowledge Brain是开源企业级智能体平台内置 RAG 检索增强生成、工作流编排和多模型接入容器内自带 PostgreSQL、Redis 和向量模型拉起来就能用。你的场景让 AI 直接回答内部文档的问题你手上有产品手册、接口文档、运维 Wiki想让 AI 基于它们做问答而不是凭空胡答。MaxKB 干的就是这件事文档丢进去自动切分、向量化提问时先检索再回答减少幻觉。整个过程不复杂。一条 docker run 启动配一个模型丢一份文档进去提问20 分钟能跑通。环境自检先确认这台机器接得住跑完下面的自检指令你应该看到四项全部通过没有任何报错。硬性条件就这几条系统Linux、Windows 或 macOSDocker 20.10 以上且 docker 命令无需 sudo 就能执行2 核 CPU、4GB 可用内存向量模型跑在容器里内存别低于 4GB10GB 以上空闲磁盘8080 端口未被占用下面这条命令一口气确认 Docker 版本、内存、磁盘和端口占用docker version --format {{.Server.Version}} free -h | awk /Mem:/{print $7 free} df -h . | tail -1 (ss -tln | grep -q :8080 echo ⚠️ 8080 端口被占用 || echo ✅ 8080 空闲)预期输出类似26.1.4 3.2Gi free /dev/sda1 100G 42G 58G 42% / ✅ 8080 空闲任何一项不满足就先解决它后面不会再出岔子。最短部署路径从拉镜像到服务就绪容器启动后PostgreSQL、Redis、应用三个进程都在同一个容器里数据落在宿主机挂载目录升级和备份都简单。Docker 一键启动 MaxKB 容器启动命令只有两条先拉镜像再建容器并启动。docker pull registry.fit2cloud.com/maxkb/maxkb docker run -d --namemaxkb --restartalways \ -p 8080:8080 -v ~/.maxkb:/opt/maxkb \ registry.fit2cloud.com/maxkb/maxkb预期输出是一串容器 ID。⚠️ 三个高频坑国内网络建议用上面的 fit2cloud 镜像源比 Docker Hub 的1panel/maxkb拉取稳定8080 被占用就把左侧改成-p 9080:8080后面访问地址跟着换Windows 的挂载路径写成C:/maxkb:/opt/maxkb。启动要等 12 分钟内置向量模型要初始化。看容器状态和端口监听确认它就绪了docker ps --filter namemaxkb --format {{.Status}}预期输出Up 2 minutes (healthy)浏览器打开http://服务器IP:8080登录页能加载这条路径就跑通了。源码构建部署可控版本想锁定版本或改代码走源码路线。仓库的 installer/ 构建脚本 里有 PostgreSQL、Redis 和主服务的启动逻辑Dockerfile 是镜像构建入口服务入口是 main.py整体结构见 README_CN.md。git clone https://gitcode.com/GitHub_Trending/ma/MaxKB⚠️ 源码路线需要自己准备 Python 依赖并构建镜像步骤比镜像方式多不少。日常使用建议直接用上面的镜像把源码方式留给二次开发。跑通验证三步确认你部署成功了✅ 三步走完浏览器里能看到一个能查资料、能回答问题的知识库应用这就是成功。登录并改掉默认凭证。访问http://服务器IP:8080用默认账号登录用户名admin密码MaxKB123..登录后立刻把默认密码改掉生产机器尤其要记得。接入一个大模型。到系统设置 → 模型设置加一个模型有 DeepSeek、OpenAI、通义千问这类服务的 API Key 就直接填想在本地跑用 Ollama 起一个模型再对接。没有模型知识库没法生成回答这一步不能省。建知识库丢一个最小用例进去。新建知识库 → 上传一份 PDF 或 Word比如你们的产品手册→ 等文档状态变成已就绪→ 打开应用提问。回答应该贴着文档内容来而不是泛泛而谈。到这里RAG 问答已经跑通。想看得更直观可以试仓库内置的 PostgreSQL 应用把数据库接成数据源用自然语言查询数据一次把检索 回答的过程完整走一遍。延伸出口跑通之后的两个方向到这里你手里有一个能查资料、能回答问题的 RAG 问答应用。下一步可以探索工作流编排把检索、判断、工具调用串成流程覆盖多步骤的复杂业务或者给应用接上 MCP 工具让智能体直接操作外部系统。现在就可以去工作流画布上试着搭一条先查知识库、查不到再调工具的流程。【免费下载链接】MaxKB MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKB创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考