在线安装

1 部署要求

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

1.1 服务器配置

部署服务器要求：

操作系统：Ubuntu 22.04 / CentOS 7（内核版本要求 ≥ 3.10）
CPU/内存：4C/8GB 以上
磁盘空间：100GB

提示：Docker 版本太低可能会导致安装失败，建议使用安装包内的 Docker，或者使用 v26.0.0 版本及以上的 Docker。

1.2 端口要求

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

表 1 在线部署访问端口说明

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

2 在线快速部署

在配置 Docker 环境的操作系统中，仅需执行以下命令即可一键完成 MaxKB 的安装：

# Linux 操作系统
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb

# Windows 操作系统
docker run -d --name=maxkb --restart=always -p 8080:8080 -v C:/maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb

待所有容器状态显示为healthy后，可通过浏览器访问 MaxKB：

http://目标服务器 IP 地址:8080

默认登录信息
用户名：admin
默认密码：MaxKB@123..

3 在线升级

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

根据以下步骤依次执行进行升级：

（1）下载最新镜像

docker pull registry.fit2cloud.com/maxkb/maxkb

（2）查看并确认上一次数据持久化目录，复制保存

docker inspect maxkb

图 1 获取pgsql目录

（3）删除正在运行的、旧版本的 MaxKB 容器

docker rm -f maxkb

（4）启动并运行新版本的 MaxKB 容器

注意： 务必确认数据持久化目录（即命令行中 -v后的目录）要跟第 (2) 步查看目录保持一致，否则启动后整个系统的数据为空。

 docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb

在线安装#

#1 部署要求

#1.1 服务器配置

#1.2 端口要求