1 安装部署

1.1 环境要求

安装前请确保您的系统符合安装条件：

• 操作系统：Ubuntu 22.04 / CentOS 7 64 位系统；
• CPU/内存： 推荐 2C/4GB 以上；
• 磁盘空间：100GB；
• 浏览器要求：请使用 Chrome、FireFox、Safari、Edge等现代浏览器；
• 可访问互联网。

1.2 在线快速部署

1. MaxKB 支持一键启动，仅需执行以下命令：

docker run -d --name=maxkb -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data 1panel/maxkb

2. 安装成功后，可通过浏览器访问 MaxKB：

http://目标服务器 IP 地址:目标端口

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

如果使用的是云服务器，请至安全组开放目标端口。

1.3 离线部署 （生产环境推荐使用该方式部署）

注意：离线包仅支持x86服务器。

1. 打开社区网站下载 MaxKB 离线包 社区版离线包

2. 上传至服务器后进行解压缩，执行以下命令：

# maxkb-v1.2.0-offline.tar.gz替换成下载包的名字  
tar -zxvf maxkb-v1.2.0-offline.tar.gz

3. 安装 MaxKB， 执行以下命令：

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

# 执行安装命令
bash install.sh

4. 安装成功后，可通过浏览器访问 MaxKB：

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

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

1.4 在线升级

注意：升级前确认数据持久化目录（-v后的目录），创建新容器时要跟上一次数据持久化目录保持一致，否则启动后数据为空。 执行以下命令：

1. 下载最新镜像

docker pull 1panel/maxkb

2. 确认上一次数据持久化目录，复制保存，第4步使用

docker inspect maxkb

3. 删除正在运行的 MaxKB 容器

docker rm -f maxkb 

4. 创建并启动 MaxKB 容器

docker run -d --name=maxkb -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data 1panel/maxkb
# 注意：确认数据持久化目录（-v后的目录）要跟【第 2 步】的目录保持一致，否则启动后数据为空。

1.5 离线升级

与1.3 离线部署执行步骤一样