MaxKB 是一套把企业文档变成问答入口的开源系统:把产品手册、制度文件、帮助文档喂进去,员工或客户直接提问,它检索相关片段再让大模型组织成回答。它在国内团队里流行,原因很实际:中文界面、部署简单、能接本地模型,不用先组一个会写检索代码的班子。
官方仓库信息
平台是 GitHub,组织名 1Panel-dev,项目名 MaxKB,由飞致云(FIT2CLOUD)维护,也就是做 1Panel 面板的那支团队。许可证为 GPLv3。技术栈写在仓库说明里:前端 Vue.js、后端 Python 与 Django、框架层用 LangChain、数据库是 PostgreSQL 加 pgvector 向量扩展。除了社区版,还有面向企业的版本,部分高级能力不在社区版里,选型时要先分清自己需要的功能在哪个版本。
它省事的地方
部署是它最大的卖点:官方给了一条 Docker 命令就能拉起服务,也可以通过 1Panel 的应用商店装,文档上传后自动完成切分和向量化,问答界面和对外嵌入的窗口都现成,零代码就能把一个能用的知识库问答挂到已有网站或内部系统上。模型不绑死一家:云端各家大模型接口可以接,本地用 Ollama 等方式跑的开源模型也可以接,公司资料不想出内网时,这条路走得通。它还带一个工作流编排,能把问答前后接上条件判断和工具调用,不止于单轮聊天。
部署成本和真实坑点
第一笔账在模型,不在软件本身。系统是免费的,但回答质量由你接的模型和向量模型决定:接云端接口要持续付调用费,接本地模型就要有能跑得动的显卡,文档量大时首次向量化也会烧掉一截额度或时间。第二,文档质量决定上限。扫描版 PDF、排版混乱的表格、同一制度的新旧版本混在一起,喂进去就会答得含糊甚至自相矛盾,上线前清洗文档、划清版本,是省不掉的人工。第三,社区版和企业版的边界要提前看清:权限、审计、并发这类企业真正在意的能力,如果只在企业版里,等业务接进来再迁移,成本比一开始就评估要高。第四,运维没有宣传里那么零:容器要升级、数据库要备份、对外开放问答入口还要防着被恶意提问套出不该答的内容,提示注入和权限隔离得自己上心。
适合谁:文档相对规整、想先在部门内部跑起来验证效果的中小团队,以及资料不能出内网、愿意自己维护一台服务器的单位。不适合谁:文档本身混乱又没人愿意整理、指望装上就自动变准的团队;还有把问答质量当核心卖点对外售卖的产品方,这类场景更需要自己掌控检索和评测链路,通用开箱方案很快会碰到天花板。