🚀 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

通过网盘分享的文件：bge-large-zh.zip
链接: https://pan.baidu.com/s/1mfNEtW96cTzqcuyZWS13RA?pwd=b7uv 提取码: b7uv