离线安装
1 部署要求¶
如果用于生产环境，离线安装是官方推荐的安装方式。
1.1 服务器配置¶
部署服务器要求：
- 操作系统：Ubuntu 22.04 / CentOS 7.6 64 位系统
- CPU/内存：4C/8GB 以上
- 磁盘空间：100GB
1.2 端口要求¶
离线部署 MaxKB 需要开通的访问端口说明如下：
| 端口 | 作用 | 说明 |
|---|---|---|
| 22 | SSH | 安装、升级及管理使用 |
| 8080 | Web 服务端口 | 默认 Web 服务访问端口，根据实际情况进行更改 |
2 安装包下载¶
打开 飞致云开源社区 MaxKB 社区版下载 页面下载最新版本安装包，并上传至部署服务器（以 v1.2.0 为例说明安装部署过程）。
3 安装部署¶
3.1 解压安装包¶
以 root 用户通过 ssh 协议登录到部署服务器, 对安装包进行解压：
tar -zxvf maxkb-v1.2.0-offline.tar.gz
3.2 安装配置（可选）¶
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 文件中进行修改，并且在修改完后需执行 mkctl reload 命令重新加载配置文件。
3.3 执行安装脚本¶
# 进入安装包解压缩后目录
cd maxkb-v1.2.0-offline
# 执行安装命令
bash install.sh
4 登录访问¶
待所有容器状态显示为healthy后，即可通过浏览器访问地址 http://目标服务器 IP 地址:8080，并使用默认的管理员用户和密码登录 MaxKB。
用户名：admin
默认密码：MaxKB@123..
5 离线升级¶
按照以上说明，下载新版本安装包并上传解压后，再次执行安装命令进行升级。
# 进入新版本目录
cd maxkb-v1.x.y-offline
# 运行安装脚本
/bin/bash install.sh
# 查看 MaxKB 运行状态
mkctl status
注意： 升级前请先对数据库进行备份。