MaxKB 部署教程：10 分钟跑通你的第一个知识库问答

MaxKB 部署教程10 分钟跑通你的第一个知识库问答【免费下载链接】MaxKB MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKBMaxKB 是一个用来搭企业级知识库问答智能体的开源平台核心是 RAG喂它文档问它问题。跟着这份 MaxKB 部署清单走一遍你自己的知识库问答就能跑起来。 一、先做个环境体检项目底线操作系统Linux / Windows / macOS装好 DockerCPU2 核以上内存4GB 以上磁盘10GB 以上Docker已安装并在运行差哪项先补哪项。容器里已经打包了 PostgreSQL 和 Redis你不需要自己装任何数据库只要留一个目录给数据就行。二、拉起服务MaxKB 部署的两条路最省事的一条是一行命令docker run -d --namemaxkb --restartalways \ -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb服务开在 8080 端口数据全部写在 ~/.maxkb 挂载里容器重建数据也不丢。Windows 上把挂载目录换成 C:/maxkb其余不变。如果你从另一台电脑访问浏览器提示不安全连接可以在 Chrome 里把这个来源加进可信列表这个设置只是绕过浏览器的 http 拦截不影响服务本身。嫌上面那条不够定制再往下看。先克隆仓库git clone https://gitcode.com/GitHub_Trending/ma/MaxKB cd MaxKB构建入口、启动脚本、数据库初始化 SQL 都在 installer/ 目录里。想改源码的用里面的 Dockerfile 构建出镜像再按前面的方式起容器即可。三、把模型接上系统才有个大脑没接模型的 MaxKB 只是一个数据库大脑要自己接。来源分三类本地私有模型用 Ollama 或 vLLM 部署 DeepSeek、Qwen 这类模型数据不出内网适合公司内部用。公共大模型 APIOpenAI、通义千问等填 API Key 就能用不用自己维护服务器。多模态文本、图像、音频的输入输出原生支持语音客服这类场景可以直接接。仓库内置了 20 多个模型提供方每家一个子目录见 apps/models_provider/impl/看目录名就知道支持谁。模型和知识库是分开配置的模型只负责读知识库不会改它。首次登录用 admin / MaxKB123..登录后第一件事就是把默认密码改掉。四、喂数据知识库怎么建知识库的搭建分三步走。4.1 传进去上传文档或者贴一个网页链接让它自动爬取入库。支持 9 种格式TXT、DOCX、PDF、HTML、XLS、XLSX、CSV、MD、ZIP。每次最多 50 个文件单个文件不超过 100MB大文档分几次传。4.2 它自己消化文件传上去后系统自动做文本拆分和向量化向量存进 PostgreSQL 的 pgvector。你只需要等状态变成成功全程不用手动处理。批量问答对可以用QA 问答对数据源导入走工作流形态建库的界面长这样4.3 问起来把知识库挂到应用上就能对话。支持多轮上下文回答里标注了段落出自哪份文档这也是 RAG 让模型不容易瞎编的原因。五、跑起来之后的日常三件事看日志、做备份、盯性能日志容器内日志在 /opt/maxkb/logs文件没导入成功、模型 API Key 配错这类问题都靠它定位。实时看一条命令docker logs -f maxkb备份数据全在 ~/.maxkb 挂载里备份就是一条 tartar -czf maxkb_backup_$(date %Y%m%d).tar.gz ~/.maxkb恢复时解压回同一位置即可。目录初期不大一周一备足够规模上去了再做成定时任务。性能管理面板里有问答响应时间和知识库处理状态的统计。大知识库检索变慢先加内存再看向量检索相关配置。 六、踩坑急救包问8080 端口访问不通答先查防火墙或云安全组放没放 8080端口被占的话把 -p 映射左侧换一个端口就行。问容器起不来答跑 docker logs -f maxkb 看报错最常见的是端口冲突和磁盘空间不足容器状态用 docker ps -a 检查。问模型响应慢答公共 API 走公网本来就不稳定响应速度要稳的话换本地私有模型省掉网络这一跳。从文档到问答这条链路就是 MaxKB 部署的主线。【免费下载链接】MaxKB MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKB创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考