基于 MaxKB 开源工具快速构建私有知识库系统
1. 简介
MaxKB 是一款基于大语言模型（LLM）的开源知识库系统。它允许用户将本地文档、网页内容等转化为知识，并通过自然语言进行问答交互。该系统支持接入多种主流大模型，包括开源模型（如 Llama 3）和云端 API 模型（如 Kimi、通义千问、OpenAI 等）。
相比传统的搜索方式，MaxKB 能够理解上下文语义，提供更精准的答案，非常适合企业或个人搭建私有化的智能问答助手。
2. 环境准备
在开始部署之前，请确保您的服务器或本地开发环境满足以下要求：
- 操作系统：Linux (Ubuntu/CentOS) 或 macOS / Windows (需安装 Docker Desktop)
- Docker：版本 20.10 及以上
- Docker Compose：版本 2.0 及以上
- 网络：能够访问 Docker Hub 拉取镜像，若使用云端模型需配置相应的 API Key
3. 快速部署
推荐使用 Docker Compose 方式进行一键部署，这种方式便于管理容器生命周期及数据持久化。
3.1 创建项目目录
mkdir -p ~/maxkb && cd ~/maxkb
3.2 编写 docker-compose.yml
在项目目录下创建 docker-compose.yml 文件，内容如下：
version: "3.8"
services:
maxkb:
image: 1panel/maxkb
restart: unless-stopped
ports:
- "9001:8080"
volumes:
- ./data:/var/lib/postgresql/data
environment:
- TZ=Asia/Shanghai
networks: {}
配置说明：
image: 使用官方提供的 MaxKB 镜像。ports: 将容器的 8080 端口映射到宿主机的 9001 端口，避免与常见服务冲突。volumes: 挂载宿主机目录./data用于存储数据库文件，防止容器重启后数据丢失。environment: 设置时区为上海时间，方便日志查看。
3.3 启动服务
执行以下命令启动容器：
