For AI agents: the complete documentation index is available at https://docs.fit2cloud.com/maxkb/v1/llms.txt, the full documentation bundle is available at https://docs.fit2cloud.com/maxkb/v1/llms-full.txt, and this page is available as Markdown at https://docs.fit2cloud.com/maxkb/v1/installation/offline_installtion.md.
MaxKB 文档
  • v1

    • 离线安装

    1 部署要求

    Note

    如果用于生产环境，离线安装是官方推荐的安装方式。

    1.1 服务器配置

    Note

    部署服务器要求：

    • 操作系统：Ubuntu 22.04 / CentOS 7.6 64 位系统
    • CPU/内存：4C/8GB 以上
    • 磁盘空间：100GB

    1.2 端口要求

    Note

    离线部署 MaxKB 需要开通的访问端口说明如下：

    端口作用说明
    22SSH安装、升级及管理使用
    8080Web 服务端口默认 Web 服务访问端口，可根据实际情况进行更改

    2 安装包下载

    Note

    打开 飞致云开源社区 MaxKB 社区版下载 页面下载最新版本安装包，并上传至部署服务器（以 v1.2.0 为例说明安装部署过程）。

    3 安装部署

    3.1 解压安装包

    Note

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

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

    3.2 安装配置（可选）

    Note

    MaxKB 安装目录、服务运行端口、数据库配置等信息可在安装包解压后中的 install.conf 文件进行配置。

    ## 安装目录
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

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

    3.3 执行安装脚本

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

# 执行安装命令
bash install.sh

    安装

    4 登录访问

    Note

    待所有容器状态显示为healthy后，即可通过浏览器访问地址 http://目标服务器 IP 地址:8080，并使用默认的管理员用户和密码登录 MaxKB。

    用户名：admin
默认密码：MaxKB@123..

    登录

    5 离线升级

    Note

    离线升级与安装操作过程基本一样，即下载新版本安装包上传解压后，再次执行安装命令进行升级。

    # 进入新版本目录
cd maxkb-v1.x.y-offline

# 运行安装脚本
bash install.sh

# 查看 MaxKB 运行状态
mkctl status

    注意： 升级前请先对数据库进行备份。