🚀 MaxKB 部署指南
1️⃣ 拉取镜像
在服务器上执行以下命令,拉取 MaxKB 相关的 Docker 镜像:
docker pull registry.cn-hangzhou.aliyuncs.com/qiluo-images/maxkb:v1.0.0
--- arrch64版本 ---
docker pull registry.cn-hangzhou.aliyuncs.com/qiluo-images/linux_arm64_maxkb:v1.0.0
2️⃣ 运行 MaxKB 容器
运行 MaxKB 容器,映射相关端口和数据目录:
docker run -d --name=maxkb --restart=always \
-p 32070:8080 \ # Web 访问端口
-p 31432:5432 \ # PostgreSQL 数据库端口
-v /data/maxkb/embedding:/opt/maxkb/third_party/embedding \ # 预训练模型存放目录
-v /data/maxkb/data:/var/lib/postgresql/data \ # PostgreSQL 数据存储目录
-v /data/maxkb/python-packages:/opt/maxkb/app/sandbox/python-packages \ # Python 依赖存放目录
registry.cn-hangzhou.aliyuncs.com/qiluo-images/maxkb:v1.0.0
3️⃣ 配置数据库环境变量
MaxKB 默认使用 PostgreSQL 作为数据库,相关的数据库连接信息如下:
MAXKB_DB_HOST=127.0.0.1 # 数据库地址 (若为 Docker 容器内部可用 maxkb)
MAXKB_DB_PORT=5432 # 数据库端口
MAXKB_DB_NAME=maxkb # 数据库名称
MAXKB_DB_USER=root # 数据库用户名
MAXKB_DB_PASSWORD=Password123@postgres # 默认数据库密码
⚠️建议修改默认密码,提高安全性!
4️⃣ 默认管理员账号
成功启动后,可通过浏览器访问 http://服务器IP:32070 进行登录:
用户名:admin
密码:MaxKB@123..
⚠️建议首次登录后修改密码!
5️⃣ 访问与管理
📌 访问 Web 界面:http://<服务器IP>:32070
📌接口文档:http://<服务器IP>:32070/doc/
📌 进入 MaxKB 容器:
docker exec -it maxkb /bin/bash
📌 查看运行状态:
docker ps | grep maxkb
📌 查看容器日志:
docker logs -f maxkb
📌 停止容器:
docker stop maxkb
📌 删除容器:
docker rm -f maxkb
6️⃣ 备份与恢复
📍 备份 PostgreSQL 数据
docker exec -it maxkb pg_dump -U root -d maxkb > /data/maxkb/backup/maxkb_backup.sql
📍 恢复 PostgreSQL 数据
docker exec -i maxkb psql -U root -d maxkb < /data/maxkb/backup/maxkb_backup.sql