离线安装
1 部署要求
如果用于生产环境,离线安装是官方推荐的安装方式。
1.1 服务器配置
部署服务器要求:
- 操作系统:Ubuntu 22.04 / CentOS 7(内核版本要求 ≥ 3.10)
- CPU/内存:4C/8GB 以上
- 磁盘空间:100GB
提示:Docker 版本太低可能会导致安装失败,建议使用安装包内的 Docker,或者使用 v26.0.0 版本及以上的 Docker。
1.2 端口要求
离线部署 MaxKB 需要开通的访问端口说明如下:
表 1 离线部署访问端口说明
2 安装包下载
打开 飞致云开源社区 MaxKB 社区版下载 页面下载最新版本安装包,并上传至部署服务器(以 v2.0.0 为例说明安装部署过程)。
3 安装部署
3.1 解压安装包
以 root 用户通过 ssh 协议登录到部署服务器, 对安装包进行解压:
3.2 安装配置(可选)
MaxKB 安装目录、服务运行端口、数据库配置等信息可在安装包解压后中的 install.conf 文件进行配置。
注意:
- 首次安装之前可以在 install.conf文件中的修改参数,安装时则根据修改后的参数执行安装。安装后如需再次修改配置参数,则需要在 ${MAXKB_BASE}/maxkb/.env(默认是 /opt/maxkb/.env)文件中进行修改,并且在修改完后需执行
mkctl reload命令重新加载配置文件。 - MAXKB_PGSQL_PORT、REDIS_PORT 仅针对使用外部数据库时有效,如果是使用内置的数据库,请不要做修改。
3.3 执行安装脚本
图 1 安装
4 登录访问
待所有容器状态显示为healthy后,即可通过浏览器访问地址 http://目标服务器 IP 地址:8080,并使用默认的管理员用户和密码登录 MaxKB。
图 2 登录
5 离线升级
注意:升级前请先对数据进行备份。
离线升级与安装操作过程基本一样,即下载新版本安装包上传并解压后,再次执行安装命令进行升级。
