maxkb详细使用教程

<think>好的，我现在需要帮助用户找到MaxKB的详细使用教程。根据用户的问题，他们之前已经询问过MaxKB的相关信息，现在需要更详细的使用指南。首先，我需要回顾系统提供的引用内容，看看是否有相关的安装和使用步骤。 引用1提到MaxKB是一个基于LLM的知识库问答系统，开箱即用，适合嵌入第三方系统，并且是1Panel官方出品。项目地址在gitcode，可能有文档资源。引用2给出了Windows系统下使用Docker启动MaxKB的命令，并提到了参数说明，说明用户可能需要安装Docker并配置路径。引用3和4讨论了本地部署，结合DeepSeek和Ollama，但用户现在主要关注MaxKB本身的使用教程。引用5提到启动文件可能是start.sh或run.py，使用gunicorn或uvicorn启动服务。 用户可能需要从安装到配置再到使用的完整流程。首先应该分步骤指导安装，包括Docker环境和命令行部署。然后是如何访问Web界面，进行系统初始化设置，比如创建管理员账户。接下来是创建知识库，上传文档，可能需要支持多种格式如PDF、Word、TXT。然后配置模型，这里可能需要集成本地或云端的LLM，如Ollama或OpenAI。最后是测试问答功能和优化知识库。 需要确保每个步骤清晰，命令准确，并参考引用中的具体命令，比如Docker运行指令和目录挂载。同时，提醒用户注意端口冲突和文件路径权限问题。另外，可能还需要指导如何维护知识库，比如更新文档或调整模型参数。最后，生成相关问题，帮助用户进一步探索高级功能或解决潜在问题。</think>以下是为您整理的MaxKB详细使用教程，包含安装配置、功能操作及注意事项： ### 一、安装部署 1. **环境准备** - 操作系统：支持Windows/Linux/macOS - 安装Docker（最低版本20.10+） 2. **快速启动** 执行以下命令（以Windows为例）： ```bash docker run -d --name=maxkb \ --restart=always \ -p 8080:8080 \ -v C:/maxkb:/var/lib/postgresql/data \ -v C:/python-packages:/opt/maxkb/app/sandbox/python-packages \ registry.fit2cloud.com/maxkb/maxkb ``` 参数说明： - `-p 8080:8080`：映射容器端口到宿主机 - `-v`参数挂载数据目录和Python依赖包目录[^2][^5] ### 二、系统初始化 1. 访问`http://localhost:8080`进入控制台 2. 首次使用需创建管理员账户 3. 进入「系统设置」配置： - 模型管理：对接本地Ollama或云端API - 存储路径检查（确保挂载目录权限正常） - 网络代理设置（如需访问外部模型） ### 三、知识库创建 1. **新建知识库** 点击「知识库管理」→「创建」→ 输入名称/描述 ```markdown 示例配置： - 名称：产品手册库 - 分词模式：智能语义切分 - 访问权限：部门级可见 ``` 2. **文档上传** 支持格式：PDF/DOCX/TXT/Markdown *建议操作：* - 单文件不超过50MB - 批量上传时按主题分类 - 启用「自动段落编号」功能[^4] 3. **数据预处理** - 自动执行：文本提取→向量化→索引构建 - 查看处理日志确认成功状态 ### 四、模型配置 1. **本地模型集成**（以Ollama为例） ```bash # 启动Ollama服务 docker run -d -p 11434:11434 --name ollama ollama/ollama # MaxKB模型配置页填写： API地址：http://ollama:11434 模型名称：llama2-chinese ``` 2. **云端模型对接** 支持OpenAI/Azure/DeepSeek等平台，需填写API密钥和端点地址[^3] ### 五、问答测试 1. 进入「对话测试」界面 2. 选择知识库和模型组合 3. 输入测试问题： ```python # 示例问题类型 "请列出产品X的技术参数" "如何解决Y功能的报错代码0xE12？" ``` 4. 分析回答准确率，通过「反馈」按钮优化结果 ### 六、高级功能 1. **多知识库联合查询**：创建组合查询策略 2. **API对接**：通过RESTful接口集成到业务系统 ```bash curl -X POST http://localhost:8080/api/query \ -H "Content-Type: application/json" \ -d '{"question":"保修政策","knowledgebase_ids":[1,2]}' ``` 3. **权限管理**：设置角色（管理员/编辑员/普通用户） ### 常见问题排查 1. 服务启动失败：检查8080端口占用`netstat -ano | findstr :8080` 2. 文档解析异常：确认文件编码为UTF-8 3. 问答结果不准确：调整分词粒度或补充关联文档