项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 23116
使用教程
环境要求
- 已安装 Docker 环境（docker run 可用）
- 服务器可访问 8080 端口（或自行映射其他端口）
- 建议预留本地目录用于持久化数据，如 ~/.maxkb
安装与启动步骤
-
1启动 MaxKB 容器
一条 docker run 命令即可拉起 MaxKB，容器随 Docker 重启自动恢复；数据挂载到 ~/.maxkb 持久保存。
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb -
2查看容器运行状态
确认容器已启动且状态为 Up，若未起来可用 docker logs maxkb 查看报错信息。
docker ps -
3访问 Web 界面
浏览器打开 http://你的服务器IP:8080 即可进入 MaxKB 控制台页面。
-
4使用默认账号登录
用户名 admin，密码 MaxKB@123..，登录后即可开始配置知识库与智能体。
-
5镜像拉取失败处理
中国用户如遇到 Docker 镜像 Pull 失败，请参照官方离线安装文档进行安装。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-p 8080:8080 | 是 | 将容器 8080 端口映射到宿主机 8080 端口 | -p 8080:8080 |
-v ~/.maxkb:/opt/maxkb | 是 | 挂载数据目录，保证配置与知识库数据持久化 | -v ~/.maxkb:/opt/maxkb |
--name=maxkb | 否 | 指定容器名称，便于后续启停和查看日志 | --name=maxkb |
--restart=always | 否 | 容器随 Docker 服务自动重启，避免意外退出 | --restart=always |
如何确认成功
浏览器访问 http://你的服务器IP:8080 能打开登录页，用 admin / MaxKB@123.. 成功登录即部署成功。
常见问题
Q：默认登录账号密码是什么？
A：用户名 admin，密码 MaxKB@123..，登录后建议尽快修改默认密码。
Q：Docker 拉取镜像失败怎么办？
A：中国用户可参照官方离线安装文档 https://maxkb.cn/docs/v2/installation/offline_installtion/ 进行离线安装。
Q：8080 端口被占用怎么办？
A：修改命令左侧端口号，例如 -p 9080:8080，然后访问 http://你的服务器IP:9080。
Q：如何停止或重启容器？
A：使用 docker stop maxkb 停止，docker start maxkb 启动，容器名为启动时指定的 maxkb。
注意事项
- 首次登录后请立即修改 admin 默认密码，避免安全风险。
- 数据保存在宿主机的 ~/.maxkb 目录，删除容器不会丢失数据，但请勿随意删除该目录。
- 升级或迁移前建议先备份 ~/.maxkb 目录。
- 若需对外提供服务，请自行配置反向代理与 HTTPS 加密。
核心亮点
- 基于RAG与向量检索（pgvector）实现企业知识库问答，支持多模型接入（DeepSeek、Qwen、Ollama等），落地门槛低
- 提供可视化工作流编排与MCP服务器支持，便于构建复杂智能体应用，降低开发成本
- 开源协议友好，社区活跃（22k+星标），文档完善，适合快速二次开发
不足之处
- 文档/社区待观察
- 依赖外部模型服务（如Ollama、DeepSeek），自托管时对硬件资源要求较高
适用场景
- 企业内部知识库问答与客服自动化
- 基于私有数据的RAG智能体开发（如法律、医疗、金融咨询）
- 快速搭建多模型统一接入的对话平台原型
替代项目
Dify、FastGPT、RAGFlow
上一篇：agentscope
下一篇：coze-studio
同类项目推荐
recall-loom
开源
给 AI 工作装上记忆，多会话不丢上下文
Project memory for long-running AI work across agents, models, and sessions. Keep co···
awesome-agentic-engineering
开源
一站式收藏智能体工程实战资源，快速上手构建AI智能体。
A curated list of practical resources for Agentic Engineering
amux
开源
一个面板管住所有 AI 编码助手，并行跑、随时看、自动修。
The agent control plane: run Claude Code, Codex and Gemini CLI agents in parallel wi···
ai-hedge-fund-crypto
开源
用AI智能体帮你像对冲基金一样炒币，自动分析并给出买卖信号。
AI-Hedge-Fund for Crypto AI-powered hedge fund for cryptocurrency trading, leverag···
EloPhanto
开源
让 AI 代理带着自我认知干活，边跑边学，结果说话
Source-available autonomous AI agent with a self-model that actually changes as it r···
AgentDock
开源
拖拽编排 AI 代理，快速从原型到生产部署
Framework retired. Prompts and document generators moved to AgentDock/prompt-library···
full-stack-ai-agent-template
开源
一键生成全栈AI应用，内置Agent、RAG和认证，开箱即用。
Full-stack AI app generator — FastAPI + Next.js with AI Agents, RAG, streaming, aut···
autopus-adk
开源
让多个AI智能体协作干活，决策过程全记录
Autopus-ADK is of the agents, by the agents. for the agents. Multi-model orchestrati···
ai-terminal
开源
在终端里直接召唤 AI，告别切换窗口，效率翻倍。
Your AI mate into your favourite terminal