MaxKB

1Panel-devGPL-3.0活跃维护

开源企业级智能体平台,可快速搭建基于知识库的问答助手和 Agent,支持接入 DeepSeek、Llama 等大模型与 MCP 工具。

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

v2.10.8-lts发布于 2026-10-22 02:58 UTC23,134star +18 / 7 天3,216fork同步于 2026-11-10 05:22 UTC

怎么上手

由 README 提炼,执行前请确认
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb
硬件要求按 README 说明

README 未说明显存、CPU 或 GPU 型号要求,仅给出 Docker 一键启动方式

有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

开源企业级智能体平台,内置 RAG 与工作流,快速给业务系统加上智能问答

开源企业级智能体平台,可快速搭建基于知识库的问答助手和 Agent,支持接入 DeepSeek、Llama 等大模型与 MCP 工具。

核心能力

  • 上传或爬取文档,自动切分并向量化构建 RAG 知识库
  • 提供工作流引擎、函数库与 MCP 工具调用编排 AI 流程
  • 零代码集成第三方业务系统,快速接入智能问答能力
  • 兼容 DeepSeek、Llama、Qwen 等私有模型与 OpenAI、Claude 等公有模型
  • 原生支持文本、图像、音视频的多模态输入输出

容易踩的坑

默认管理员账号为 admin,密码为 MaxKB@123..,首次登录后应及时修改;国内拉取 Docker 镜像失败时需参照离线安装文档;服务默认监听 8080 端口,需确认端口未被占用

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v2.10.8-lts
  1. v2.10.8-lts最新正式版2026-10-22 · 2026-10-22 02:58 UTC

    Security Fixes

    ■ Security (X-Pack): Fixed a vulnerability where the login authentication configuration endpoint did not redact sensitive fields, exposing third-party login app credentials (such as DingTalk app_key, corp_id, and app_secret) in plaintext, which could lead to enterprise app takeover.

    Bug Fixes

    ■ Knowledge Base: Fixed an issue where special characters such as , /, :, *, and ? could be entered when quickly creating a blank document.

    ■ Knowledge Base: Fixed an issue where users with only the workspace administrator role were redirected to the agent list page when clicking Import Document in a Feishu knowledge base.

    ■ Knowledge Base: Fixed an issue where headings with the same content but different levels in a Markdown file were incorrectly recognized during segmentation.

    ■ Knowledge Base: Fixed an issue where deleting a document after uploading it to a general knowledge base by a custom role returned an error indicating no permission.

    ■ Knowledge Base: Fixed an issue where the document tag retrieval node passed query parameters when retrieving the tags of the selected knowledge bases, causing the length limit to be exceeded when there were many knowledge bases (#7199).

    ■ Knowledge Base: Fixed an issue where an empty document list output by the data source tool caused the write to the knowledge base to fail.

    ■ Agent: Fixed an issue where the button for generating the system prompt was not automatically activated when the default model was used in an AI conversation node.

    ■ Agent (X-Pack): Fixed an issue where a regular user was prompted with no permission when clicking Save after creating a new agent that referenced a shared tool (#7360).

    ■ Agent: Fixed an issue where the page title did not display the agent name after refreshing the agent conversation page.

    ■ Agent (X-Pack): Fixed an issue where the shared tool list incorrectly displayed MCP and Skills items that should be filtered out when adding a tool component in a workflow (#7361).

    ■ Shared Tool (X-Pack): Fixed an issue where a regular user could not call a shared tool at workflow runtime after adding it to a workflow knowledge base.

    ■ Resource Management (X-Pack): Fixed an issue where the system administrator failed to import documents into a workflow knowledge base in Resource Management.

    ■ Resource Management (X-Pack): Fixed an issue where shared tools that had not been granted workspace authorization could be added when editing an agent under a workspace in Resource Management.

    ■ Resource Management (X-Pack): Fixed an issue where the system administrator failed to download the original document of a knowledge base and was prompted with no permission.

    ■ Resource Management (X-Pack): Fixed an issue where the document creator was empty when the system administrator created a document for a knowledge base in Resource Management.

    ■ Resource Management (X-Pack): Fixed an issue where the system administrator failed to view the release history of an agent.

  2. v2.10.7-lts2026-10-15 · 2026-10-15 08:10 UTC
    查看更新说明

    Enhancements

    • Knowledge Base: Special characters such as , /, ?, *, and [] are now disallowed when renaming documents.
    • Agent: A confirmation prompt is now shown when deleting conversation history, to prevent accidental deletion.
    • Q&A Page: Tables in AI responses now support horizontal scrolling when the number of columns exceeds the visible width.

    Bug Fixes

    • Agent: Fixed an issue where content wrapped in html_render tags was rendered blank when exported to PDF or image (#7222).
    • Agent: Fixed an issue where long-term memory could be saved without specifying a trigger interval in scheduled trigger mode.
    • Agent: Fixed incorrect field name labels in the long-term memory settings panel.
    • Agent: Fixed an issue where, when adding agents created at nearly the same time as skills in an AI conversation node, only one of them took effect.
    • Agent: Fixed an issue where the execution details of workflow tools were displayed in the wrong order in conversation records (#7221).
    • Agent: Fixed an issue where using the long-form writing agent template from Template Center resulted in a "conversation does not exist" error during chat.
    • Agent: Fixed an issue where clicking the like or dislike button below an answer caused a system error.
    • Agent: Fixed an issue where, after selecting a tool in an MCP node, parameters not marked as required were all treated as required.
    • Agent: Visibility rules for user input parameters — optional parameters now filter out unavailable parameters from global variables (#7224).
    • Trigger: Fixed an issue where scheduled trigger tasks did not execute and a backend error occurred when saving.
    • Knowledge Base: Fixed an issue where, after importing a PDF containing images, the image links were parsed but the images were not displayed.
    • Knowledge Base: Fixed an issue where importing large documents into a general knowledge base failed (#7062).
    • Knowledge Base: Fixed an issue where the tools bundled with a Template Center template became unavailable after the template was applied in a workflow knowledge base (#7302).
    • Knowledge Base: Fixed an issue where full-text search only returned content that exactly matched the keyword (#7234).

    Security Fixes

    • Security: Fixed a vulnerability where the signing key for Celery task messages could be derived, leading to remote code execution (NVDB-CAIVD-2026894112).
    • Security: Fixed a missing function-level authorization (BFLA) vulnerability in the admin oss/get_url endpoint, which could lead to unauthorized access and SSRF (NVDB-CAIVD-2026080673).
    • Security: Fixed a vulnerability where chat_record_id could be used to overwrite other visitors' conversation records (session integrity).
    • Security: Fixed a vulnerability where the like and dislike endpoints still accepted cross-client operations.
    • Security: Fixed an Eval injection vulnerability in the "Init Param" validation rules of custom tools, which allowed arbitrary JavaScript execution.
    • Security: Fixed a path traversal vulnerability in knowledge base names that allowed writing arbitrary .xlsx files and poisoning instance-wide import templates.
    • Security: Fixed an account takeover vulnerability.
    • Security: Fixed an unauthenticated SSRF vulnerability in the chat file proxy caused by an incomplete host denylist.
    • Security: Fixed a vulnerability where the MCP configuration URL was not validated, allowing users with the USER role to perform SSRF against arbitrary addresses and read back responses (direct connection from the web process, bypassing the sandbox).
    • Security: Fixed a vulnerability where the login CAPTCHA was not destroyed after successful validation, enabling unauthenticated online password brute-forcing (admin takeover).
    • Security: Fixed a vulnerability where authenticated users could access cross-tool execution records through an unscoped cache hit.
  3. v2.10.6-lts2026-09-03 · 2026-09-03 03:55 UTC
    查看更新说明

    Security Vulnerability Fixes

    • Security: Fixed a security vulnerability where Chat file uploads could spoof APPLICATION attribution and be read anonymously, allowing content injection into the application namespace.
    • Security: Fixed a security vulnerability where document/paragraph migration only validated source knowledge base permissions, leading to cross-tenant content injection and RAG poisoning.
    • Security: Fixed a security vulnerability where XLSX embedded image decompression lacked a pixel count limit, allowing authenticated users to trigger memory-exhaustion denial of service (DoS).
    • Security: Fixed a security vulnerability where problem/batch_association lacked ownership validation, leading to cross-tenant paragraph content disclosure (IDOR).
    • Security: Fixed a security vulnerability where the anonymous application profile endpoint over-serialized data, causing sensitive configuration disclosure (/chat/api/application/profile).
    • Security: Fixed a security vulnerability where the password reset verification code endpoint lacked a guessing attempt limit, allowing unauthorized account takeover.
    • Security: Fixed a security vulnerability where the function library sandbox could be bypassed (dlopen stack check bypassable + dlsym(RTLD_NEXT) not intercepted) (CVE-2026-79919).
    • Security: Fixed a security vulnerability where Python's support for file descriptor form os.execve(fd,...) could be leveraged to enter the libc fexecve call path, causing sandbox bypass (NVDB-CAIVD-2026208648).
    • Security: Fixed a security vulnerability where guest session ownership validation was missing, leading to cross-guest-session writes (Session Integrity Violation).
    • Security: Fixed a security vulnerability where the default hardcoded Django SECRET_KEY allowed signed tokens to be forged offline, resulting in unauthorized file access.

    New Features

    • Workflow Default Model Settings In the MaxKB v2.10.6 LTS community edition, workflow default model settings have been introduced for agent workflows, knowledge base workflows, and workflow tools. Previously, multi-AI-node workflows required opening each node individually to modify model configurations, which was relatively cumbersome. Now, a single configuration takes effect globally, significantly reducing maintenance costs and improving the consistency and efficiency of batch model switching. Core features of the default model settings include:
    • A workflow-level default model configuration entry;
    • Newly created nodes automatically inherit the default model;
    • Nodes support flexible model selection modes (Default / Custom / Reference Variable, depending on node type);
    • The default model can be applied to all nodes with one click, uniformly switching all nodes' model sources to the default model;
    • A single change to the default model takes effect across multiple nodes;
    • Configuration completeness is ensured before publishing.
    • Tencent Hunyuan & Tencent Cloud Providers Merged into the New "Tencent Cloud" Provider (Integrated with Tencent Cloud TokenHub) Due to adjustments by Tencent Cloud, in the MaxKB v2.10.6 LTS community edition, the Tencent Hunyuan and Tencent Cloud providers have been merged into a new "Tencent Cloud" provider. All models previously configured based on the Tencent Hunyuan or legacy Tencent Cloud provider integration will no longer be usable after the upgrade. After upgrading, please go to the "Model Providers" page, select "Tencent Cloud" from the provider list, and reconfigure your model access information according to the TokenHub integration requirements. Once configured, the models will be available again. Feature Optimizations
    • Knowledge Base: The knowledge base/document list selector now supports search when migrating documents/paragraphs.
    • Agent: The knowledge base component in the user input area now supports search.
    • Agent: In the "Add to Knowledge Base" feature on the conversation log page, the knowledge base and documen
  4. v1.10.15-lts2026-08-11 · 2026-08-11 08:40 UTC
    查看更新说明

    Bug Fixes

    • Security Vulnerability: Fixed flaws in permission verification to block a high-risk privilege escalation vulnerability where anonymous application session tokens could be exploited to obtain the administrator's system API Key.
    • Knowledge Base: Fixed garbled paragraph content when uploading PDF files where the title text is identical to the body content.
  5. v2.10.5-lts2026-08-06 · 2026-08-06 06:41 UTC
    查看更新说明

    Security Vulnerability Fixes

    • Security Vulnerability: Fixed missing‑owner‑check at chat‑sharing link endpoint, where chat tokens could be abused to share other users’ conversation content.
    • Security Vulnerability: Fixed privilege escalation allowing regular users to fetch user information of other workspaces via API (#6576).
    • Security Vulnerability: Fixed privilege escalation where any user’s API Key could be used to delete arbitrary files.
    • Security Vulnerability: Fixed the issue that regular users could obtain sensitive information such as other users’ email addresses via API (#6577).

    Bug Fixes

    • Knowledge Base: Fixed failure‑to‑load issue for images returned from knowledge bases within conversations.
    • Knowledge Base: Fixed abnormal paragraph content when uploaded PDF contains identical text in titles and body content (#6543).
    • Knowledge Base: Fixed incorrect display of the “Allow preview in knowledge source” option in the web‑knowledge‑base import‑document modal.
    • Agent: Fixed truncated content when copying long conversation text (#6568).
    • Agent: Fixed inaccessible AI‑generated images when agent is embedded in third‑party pages.
    • Agent: Fixed inaccessible images generated by the agent image‑generation node.
    • Agent: Fixed error popup after agent debugging completes, which blocked access to execution details.
    • Agent: Fixed basic agents being able to run retrieval against unpublished knowledge‑base retrieval configurations (#6519).
    • Agent: Fixed image‑loading failure after images are extracted by the file‑content‑extraction node.
    • Agent: Fixed execution failures of agent trigger tasks.
    • Agent: Fixed workflow‑tool‑node outputs not being written into conversation logs.
    • Agent: Fixed failure of the sendMessage method in agent opening remarks to pass user parameters, causing loss of user questions.
    • Agent: Fixed file preview/download failures caused by insufficient permissions in knowledge‑source panel on Q&A page.
    • Agent: Fixed permission‑denied prompts for partial files when downloading multiple uploaded files from conversation logs.
    • Agent: Fixed inaccurate active‑user statistics on overview page caused by residual uncleaned data after conversation‑log cleanup.
    • Role (X‑Pack): Fixed missing permission‑bit controls for certain functions.
    • Shared Resources (X‑Pack): Fixed wrong page redirection when system administrators click “Upload Document” inside shared knowledge bases.
    • Shared Resources (X‑Pack): Fixed access to hit‑test results for shared knowledge bases within workspaces.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents. MaxKB integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities. MaxKB is widely applied in scenarios such as intelligent customer service, corporate internal knowledge bases, academic research, and education.

    • RAG Pipeline: Supports direct uploading of documents / automatic crawling of online documents, with features for automatic text splitting, vectorization. This effectively reduces hallucinations in large models, providing a superior smart Q&A interaction experience.
    • Agentic Workflow: Equipped with a powerful workflow engine, function library and MCP tool-use, enabling the orchestration of AI processes to meet the needs of complex business scenarios.
    • Seamless Integration: Facilitates zero-coding rapid integration into third-party business systems, quickly equipping existing systems with intelligent Q&A capabilities to enhance user satisfaction.
    • Model-Agnostic: Supports various large models, including private models (such as DeepSeek, Llama, Qwen, etc.) and public models (like OpenAI, Claude, Gemini, MiniMax, etc.).
    • Multi Modal: Native support for input and output text, image, audio and video.

    Quick start

    Execute the script below to start a MaxKB container using Docker:

    docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb
    

    Access MaxKB web interface at http://your_server_ip:8080 with default admin credentials:

    • username: admin
    • password: MaxKB@123..

    中国用户如遇到 Docker 镜像 Pull 失败问题,请参照该 离线安装文档 进行安装。

    Screenshots

    Technical stack

    License

    Licensed under The GNU General Public License version 3 (GPLv3) (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    https://www.gnu.org/licenses/gpl-3.0.html

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.