MaxKB 部署教程：10 分钟跑通你的第一个知识库问答
【免费下载链接】MaxKB🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKB
MaxKB 是一个用来搭企业级知识库问答智能体的开源平台，核心是 RAG：喂它文档，问它问题。跟着这份 MaxKB 部署清单走一遍，你自己的知识库问答就能跑起来。
🩺 一、先做个环境体检
| 项目 | 底线 |
|---|---|
| 操作系统 | Linux / Windows / macOS（装好 Docker） |
| CPU | 2 核以上 |
| 内存 | 4GB 以上 |
| 磁盘 | 10GB 以上 |
| Docker | 已安装并在运行 |
差哪项先补哪项。容器里已经打包了 PostgreSQL 和 Redis，你不需要自己装任何数据库，只要留一个目录给数据就行。
二、拉起服务：MaxKB 部署的两条路
最省事的一条是一行命令：
docker run -d --name=maxkb --restart=always \ -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 这类模型，数据不出内网，适合公司内部用。
- 公共大模型 API：OpenAI、通义千问等，填 API Key 就能用，不用自己维护服务器。
- 多模态：文本、图像、音频的输入输出原生支持，语音客服这类场景可以直接接。
仓库内置了 20 多个模型提供方，每家一个子目录，见 apps/models_provider/impl/，看目录名就知道支持谁。模型和知识库是分开配置的：模型只负责"读"知识库，不会改它。
首次登录用 admin / MaxKB@123..，登录后第一件事就是把默认密码改掉。
四、喂数据：知识库怎么建
知识库的搭建分三步走。
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 挂载里，备份就是一条 tar：
tar -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），仅供参考
