MaxKB 私有化部署及高级应用配置指南
你是否曾想过,能拥有一个只回答你自己领域知识的 AI 聊天机器人?一个能 7x24 小时为客户解答产品问题、为公司员工提供内部资料查询的智能客服?MaxKB 就是这样一款强大且开源的工具,它能帮助你轻松实现这个想法。
本文将手把手带你完成 MaxKB 的安装、配置,并深入讲解如何创建和优化你的知识库,最后还将详细拆解其最强大的'高级应用'功能,让你真正掌握这个利器。
一、安装 MaxKB:三步搞定
对于新手而言,服务器环境配置往往是第一道坎。别担心,我们选用宝塔面板来简化一切操作。
1. 准备 Docker 环境
登录你的宝塔面板,在左侧菜单栏中找到并点击 docker。如果你是第一次使用,系统会提示你安装 Docker。这是一个全自动的过程,你只需要点击确认,然后等待它安装完成即可。


2. 执行安装命令
Docker 环境就绪后,点击面板左侧的 终端,这会打开一个命令输入窗口。复制以下这行命令,粘贴进去,然后按下回车键。
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages registry.fit2cloud.com/maxkb/maxkb
这行命令在做什么? •
docker run: 告诉 Docker 运行一个新容器。 •-d: 让容器在后台安静地运行。 •--name=maxkb: 给你的容器取个名字叫maxkb,方便管理。 •--restart=always: 确保容器在服务器重启后也能自动运行。 •-p 8080:8080: 将服务器的 8080 端口映射到容器的 8080 端口,让我们能访问到 MaxKB。 •-v ...: 这是最重要的一步,它将容器内的数据(如数据库和 Python 包)保存到你的服务器本地,这样即使容器被删除,你的数据也不会丢失。
3. 验证安装
等待命令执行完毕。回到宝塔面板的 docker 管理界面,点击 容器列表。如果你能看到一个名为 maxkb 的容器,并且状态是'运行中',那么恭喜你,MaxKB 已经成功安装并启动了!

二、配置 Nginx 反向代理:让访问更专业
默认情况下,你需要通过 http://你的服务器 IP:8080 这样的地址来访问 MaxKB,这既不方便记忆,也不够专业。下面我们来配置一下,让你可以通过自己的域名(例如 ai.xxx.com)来访问它。
























