MaxKB 安装部署教程：一条命令跑起企业级智能体平台
【免费下载链接】MaxKB🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKB
MaxKB 是一款开源的企业级智能体平台：接入大模型、上传文档构建知识库，就能搭出带 RAG 问答、工作流编排和 MCP 工具调用能力的 AI 应用。如果你想在自己的服务器上快速装一套 MaxKB，本文就是完整的部署指南，全程不超过 10 分钟。
🧰 部署前先认识仓库里的核心部件
MaxKB 由三块构成：apps/目录是 Python/Django 后端，ui/目录是 Vue 3 前端源码，installer/目录放 Docker 构建与容器启动脚本。apps/下按功能分成 knowledge（知识库）、application（智能体应用）、models_provider（模型接入）等子应用，main.py是整个后端服务的统一入口。
你真正要关心的只有三样东西：镜像（或代码仓库）、数据挂载目录、监听端口。后端源码和前端构建产物都封装在容器里，apps/和ui/你基本不用动。数据侧 PostgreSQL、Redis、日志都落在容器内的/opt/maxkb目录下，这个目录通过卷挂载到宿主机——它是唯一需要你做备份的地方，知识库、聊天记录、应用配置全在这里。
🚀 从零跑起来
检查环境。准备一台 Linux 或装有 Docker Desktop 的 Windows 机器，确保 Docker 已安装，可用docker version确认。8080 端口未被占用即可，MaxKB 容器自带 PostgreSQL 和 Redis，无需单独安装数据库。
获取代码。如果你打算自己构建镜像，先克隆仓库：
git clone https://gitcode.com/GitHub_Trending/ma/MaxKB启动服务。最省事的方式是直接用官方镜像一条命令拉起：
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb容器启动后会自动初始化数据库、加载内置的中文向量模型并启动全部服务，日志里依次出现PostgreSQL started、MaxKB started字样就代表就绪。如果你不走 Docker 而是在源码里原生启动，入口是仓库根目录的main.py：python main.py dev会先执行迁移和静态文件收集，再以开发服务器跑在0.0.0.0:8080上，需要配合外部 PostgreSQL 和 Redis 使用。
验证结果。浏览器打开http://localhost:8080，看到登录页即部署成功，默认账号admin，默认密码MaxKB@123..。
⚙️ 几个绕不开的配置项
MaxKB 的配置全部通过MAXKB_前缀的环境变量注入，容器默认值都能直接跑，但以下四个建议理解清楚：
MAXKB_DB_HOST/MAXKB_DB_PORT/MAXKB_DB_USER/MAXKB_DB_PASSWORD：数据库连接。默认指向容器内 127.0.0.1:5432，指向外部数据库时四项要一起改，连不上库服务直接起不来。MAXKB_REDIS_HOST/MAXKB_REDIS_PORT：Redis 地址，承担缓存和 Celery 异步任务队列，改法与数据库相同。MAXKB_SECRET_KEY：Django 安全密钥，会话和加密操作都依赖它。不设置时启动脚本会随机生成一个并保存进/opt/maxkb数据目录，手动配置固定值可以避免密钥漂移导致的会话失效。-p 8080:8080：端口映射。宿主机 8080 被占用时改左边的数字即可，容器内 8080 是固定值。
生产环境务必把默认密码改掉，并按需固定MAXKB_SECRET_KEY，占位值不要直接上线。
✅ 部署完成后的三件事
- 改掉
admin的默认密码，再按需创建普通用户并分配权限。 - 用
docker logs maxkb观察启动与运行日志，排查问题第一步都从这开始。 - 登录后台先接入一个对话模型和向量模型，再建知识库，完整路径参考仓库里的 README_CN.md。
至此 MaxKB 已经在你的服务器上跑起来了：改个端口、挂好卷，剩下的交给平台本身。更多用法详见 USE-CASES.md 中的案例展示。
【免费下载链接】MaxKB🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。项目地址: https://gitcode.com/GitHub_Trending/ma/MaxKB
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
