Databuff
GitHub

简体中文

English

简体中文

English

Appearance

中文  |  English

离线安装 ​

无法访问镜像仓库时，按架构下载离线包后在目标机器安装，全程无需联网。

准备环境 ​

  • Docker
  • Docker Compose
  • root 权限（默认安装到 /opt/databuff-ai-apm）

下载离线包 ​

按本机 CPU 架构下载对应版本的一体化离线包。

推荐：在 官网安装页 的 Docker → 离线安装 中选择版本并复制下载链接。

架构离线包文件名
amd64databuff-ai-apm-offline-<version>-amd64.tar.gz
arm64databuff-ai-apm-offline-<version>-arm64.tar.gz

下载地址（将 <version> 替换为实际版本号，如 0.1.2）：

  • amd64：https://openocta.com/pkg/databuff/<version>/offline/databuff-ai-apm-offline-<version>-amd64.tar.gz
  • arm64：https://openocta.com/pkg/databuff/<version>/offline/databuff-ai-apm-offline-<version>-arm64.tar.gz

命令行下载示例（amd64 / 0.1.2）：

bash
curl -fLO https://openocta.com/pkg/databuff/0.1.2/offline/databuff-ai-apm-offline-0.1.2-amd64.tar.gz

需要自动获取最新版本号时，https://openocta.com/pkg/databuff/VERSION 仅返回纯文本版本（如 0.1.2），不是离线包地址。可先查版本再下载：

bash
VERSION=$(curl -fsSL https://openocta.com/pkg/databuff/VERSION)
ARCH=amd64   # 或 arm64
curl -fLO "https://openocta.com/pkg/databuff/${VERSION}/offline/databuff-ai-apm-offline-${VERSION}-${ARCH}.tar.gz"

包内包含：部署脚本、ai-apm-stack 应用镜像、doris-stack 基础设施镜像。

安装步骤 ​

以 0.1.2 / amd64 为例（在能联网的机器下载后，将离线包拷贝到目标机）：

bash
tar -zxvf databuff-ai-apm-offline-0.1.2-amd64.tar.gz
cd databuff-ai-apm-offline-0.1.2-amd64

# 安装平台
sudo ./install.sh

install.sh 会：

  1. 将部署文件解压到 APM_INSTALL_DIR（默认 /opt/databuff-ai-apm）
  2. docker load 离线镜像（本地已有且版本一致时可跳过，除非设置 FORCE_LOAD_IMAGES=1）
  3. 执行 start.sh 启动全栈（可用 SKIP_START=1 仅安装不启动）

安装完成后终端输出 Web UI、默认账号与 OTLP 地址。

安装 Demo（可选） ​

bash
sudo ./install_demo.sh

环境变量 ​

变量说明
APM_INSTALL_DIR安装目录，默认 /opt/databuff-ai-apm
SKIP_START1 = 仅安装不启动
FORCE_LOAD_IMAGES1 = 强制重新 docker load

与在线安装的区别 ​

在线安装通过 ai-apm-install.sh 从 CDN 拉取部署包与分架构镜像包；离线安装不依赖 curl、CDN 或镜像仓库，适合 U 盘搬运或 air-gapped 机房。

在线环境仍可使用一键命令：

bash
curl -fsSL https://databuff.ai/databuff/ai-apm-install.sh | bash

故障恢复 ​

问题建议
docker load 失败检查磁盘空间；使用 FORCE_LOAD_IMAGES=1 重试
启动超时见 Docker 运维参考 日志与排障
需升级版本下载目标版本离线包，解压后执行 update.sh（保留 data/）；全新重装才用 install.sh

相关文档 ​