AI 入门：5 分钟搭一个本地知识库问答系统
零基础搭建本地知识库问答系统，上传文档就能问，还能嵌入网站，全程只需 Docker 和一行命令。
准备工作：你需要什么？
在开始之前，请确保你的电脑上已经安装了 Docker（一种容器工具，可以把应用打包运行，免去复杂的环境配置）。如果没有，可以去 Docker 官网下载安装。另外，你还需要一个 Ollama（一个可以在本地运行 AI 模型的工具，免费且无需联网）。Ollama 的安装很简单，去 Ollama 官网下载对应系统的版本，安装后打开终端运行 ollama pull llama3.2:1b 下载一个小模型（约 800MB）。
安装 MaxKB：三步搞定
- 打开终端（Mac/Linux 用 Terminal，Windows 用 PowerShell），运行
git clone https://github.com/1Panel-dev/MaxKB.git克隆项目代码。 - 进入项目目录
cd MaxKB，把.env.example文件复制一份并重命名为.env。 - 运行
docker compose up -d，等待几分钟，看到绿色输出表示启动成功。
打开浏览器，访问 http://localhost:8081，用默认账号 admin / admin123 登录。
配置模型并创建知识库
登录后，点击左侧「设置」→「模型提供商」→「Ollama」，在「API 地址」一栏输入 http://ollama:11434，点击保存。然后点击「知识库」→「创建知识库」，上传一个 PDF 或文本文档（比如你的产品说明书或学习笔记），系统会自动处理。处理完成后，你就可以在对话框里提问了，比如“这份文档里提到了哪些注意事项？”
嵌入到你的网站（可选）
如果你想把这个问答框放到自己的网站上，点击「应用」→ 你的应用 →「嵌入」，复制生成的 JavaScript 代码，粘贴到任意 HTML 页面的 <body> 标签内。刷新页面，右下角就会出现一个聊天小窗口，访客可以直接提问。整个过程不需要改动后端，一个脚本标签搞定。
常见问题提醒
- 端口被占用？ 修改
.env文件中的PORT=8081为其他数值，比如 8082。 - Ollama 模型下载慢？ 可以换用
qwen2:0.5b等更小的模型，速度更快。 - 上传文档后没反应？ 检查文档格式是否支持（PDF、TXT、Markdown 等），文件大小建议不超过 10MB。
现在你已经成功搭建了一个本地 AI 知识库！接下来可以试试上传更多文档，或者用 Python 调用它的 API 实现自动化问答。
内容来源
DEV Ollama
发布时间
2026-05-23 01:32