MaxKB 部署知识库 - 小记说明【背景】在学习多个企业知识库部署方案中，本次使用来MaxKB + Ollama（d

说明

【背景】在学习多个企业知识库部署方案中，本次使用来MaxKB + Ollama（deepseek:r1-7b）方案部署，在过程中遇到一些问题，特此记录一下具体的情况。本地服务器环境是LinuxOS（配置：4核16G ，ATX4000显卡）。如果是小白机，没有安装过PostgreSql等相关服务。安装官网基本可以一路下一步的安装好。可惜我不是啊，特此记录一下。

问题小记

【问题1】在安装官网中按照教程，在线快速部署，进行docker运行。但在之前我们本地已经运行的服务占用了MaxKB常用端口，顾需要重新指定。在docker运行后，一直无法运行访问，查看docker日志发现是MaxKB本身的运行过程中会启动一个PostgreSql的安装命令。而我服务器环境中已经使用docker在运行之前安装的PostgreSql。造成了冲突。

【解决方案】在其官网中，使用在线安装docker没有说明该如何访问外部数据库，只有离线安装才有install.conf中可以修改相关配置。能力有限所以暂时放弃在线安装的方式采用离线部署。

【问题2】离线安装下载资源包，通过解压到指定位置后，按照下述工作操作后，有遇到了相关步骤性问题。

1.以 root 用户通过 ssh 协议登录到部署服务器, 对安装包进行解压：

tar -zxvf maxkb-v1.2.0-offline.tar.gz

2.修改安装配置文件内容：

## 安装目录
MAXKB_BASE=/opt
## Service 端口
MAXKB_PORT=8080
## docker 网段设置
MAXKB_DOCKER_SUBNET=172.19.0.0/16
# 数据库配置
## 是否使用外部数据库
MAXKB_EXTERNAL_PGSQL=false
## 数据库地址
MAXKB_PGSQL_HOST=pgsql
## 数据库端口
MAXKB_PGSQL_PORT=5432
## 数据库库名
MAXKB_PGSQL_DB=maxkb
## 数据库用户名
MAXKB_PGSQL_USER=root
## 数据库密码
MAXKB_PGSQL_PASSWORD=Password123@postgres

注意 需要将MAXKB_EXTERNAL_PGSQL（是否使用外部数据库）修改为true，MAXKB_PGSQL_HOST（数据库地址）为固定IP地址。数据库端口需要防火墙设置一下，不然无法TCP链接。

注意：首次安装之前可在 install.conf文件中的修改参数，安装时则根据修改后的参数执行安装。完成安装后如需再次修改配置参数，则需要在 ${MAXKB_BASE}/maxkb/.env（默认是 /opt/maxkb/.env）文件中进行修改，并且在修改完后需执行 mkctl reload 命令重新加载配置文件。

3.执行安装脚本

# 进入安装包解压缩后目录  
cd maxkb-v1.2.0-offline

# 执行安装命令
bash install.sh

4.执行脚本后该可以通过卸载，来解决配置问题。

# 执行卸载命令
bash uninstall.sh

【解决方案】咣咣一顿操作后，还是无法访问地址http://目标服务器 IP 地址:8080.再次阅读官方文档和社区提问发现需要先去创建【PostgreSql】数据库的maxkb，又去建立数据库链接然后创建maxkb数据库。

【问题3】特别在这里说一下，在使用安装包安装MaxKB时候发现，它的安装包里依然是使用docker方式安装的。只是它的启动脚本可以读取配置文件的内容。因此依然可以通过查看MaxKB的docker日志来判断它是否成功。通过执行命令或者查看 MaxKB 运行状态 mkctl status，无法准确确定问题。还是看docker日志方便一下。下面是docker日志错误内容：

图片.png

服务器内容：

图片.png

【解决方案】还是PostgreSql的问题，按照下述方法操作后。最终就打开http://目标服务器 IP 地址:8080

图片.png