---
title: "安装 OAT | OceanBase 文档中心"
description: 安装 OAT 本文介绍如何 Docker 部署 OAT。 前提条件 在部署 OAT 之前，您需要确认以下信息： 您的操作系统满足以下条件： 服务器类型 操作系统 支持版本 x86_64 RHEL 7.2 及以上版本 x86_64 CentOS 7.2 及以上版本 x86_64 AliOS 7.2 及以上版本 x86_…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*jLd4SamEcM0AAAAAAAAAAAAADiGDAQ/original) 管理者工具 OATV 4.1.2 企业版

# 安装 OAT

更新时间：2026-06-15 15:25:34

本文介绍如何 Docker 部署 OAT。

## 前提条件

在部署 OAT 之前，您需要确认以下信息：

- 您的操作系统满足以下条件：

  | 服务器类型 | 操作系统 | 支持版本 |
  | --- | --- | --- |
  | x86_64 | RHEL | 7.2 及以上版本 |
  | x86_64 | CentOS | 7.2 及以上版本 |
  | x86_64 | AliOS | 7.2 及以上版本 |
  | x86_64 | openSUSE | 12SP3 及以上 |
  | x86_64 | 统信 UOS | V20 |
  | ARM aarch64 | AliOS | 7.2 及以上版本 |
  | ARM aarch64 | 中标麒麟 | 7.6 |
  | ARM aarch64 | 华为 EulerOS | 2.0 SP8 |
  | ARM aarch64 | 统信 UOS | V20 |
 - 您已经安装并启动 Docker。推荐 Docker 版本为社区版 17.03 及以上。 如果您使用 all-in-one 安装包安装 OAT，all-in-one 的 `install.sh` 脚本将自动安装 Docker。
 - OAT 的默认端口 `7000` 未被占用。

## 使用 oat-all-in-one 安装包安装

#### 说明

推荐您使用 oat-all-in-one 安装包安装 OAT。

按照以下步骤安装 OAT：

1. 请联系技术支持获取 OAT 的 oat-all-in-one 安装包。
 2. 解压 oat-all-in-one 安装包。

   ```bash
   tar -xf oat-all-in-one-x86.tar

   ```
 3. 运行安装脚本 `install.sh`。

   ```bash
   sh oat-all-in-one-x86/install.sh

   ```

   运行此命令将自动安装 Docker (如果您的环境没有 Dcoker)，部署 OAT 并扫描已有的镜像和工具软件包。
 4. 根据提示，输入 docker root dir 和 OAT data dir（无需手动创建这两个目录）、OAT HTTP listen port（默认 7000）、 OAT database port（默认 3306）和 OAT 初始密码等设置。
 5. 根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。

#### 说明

- `install.sh` 脚本启动 OAT 容器默认使用 `--net host`（主机网络模式）。如您需要配置为其他网络模式，请下载 OAT 容器手动启动。
 - x86（arrch64）版本的 `oat-all-in-one` 默认只包含 x86（aarch64）和 noarch 的镜像和软件包，如需 aarch64（x86）架构，请自行下载拷贝到 OAT 容器挂载的对应目录，然后发起扫描任务进行添加。

## 使用 OAT 安装包安装

1. 下载 OAT 安装包。

   您需要联系 OceanBase 的技术人员下载安装包。
 2. 使用 `scp` 命令将 OAT 安装包上传到服务器中。

   其中 `oat_server` 为部署 OAT 的服务器的 IP 地址。

   ```bash
   scp oat.tgz <oat_server_user>@<oat_server_ip>:~/

   ```
 3. 挂载 OAT 目录。

   在服务器创建 `/data_dir` 目录用来保存 OAT 的持久化数据。

   在 `/data_dir` 目录被挂载到 OAT 容器后，OAT 会自动创建 `/data_dir/logs`、`/data_dir/images` 和 `/data_dir/db` 目录，分别用于存放 OAT 的系统日志、组件和产品的 Docker 镜像以及 OAT 的数据库文件。

   ```bash
   mkdir -p /data_dir

   ```
 4. 将 OAT 安装包装载为镜像。

   ```bash
   docker load -i oat.tar

   ```
 5. 用 `docker images` 命令获取 OAT 镜像的标签。

   #### 说明

   当只加载了一个 OAT 安装包时，使用示例命令即可。当加载了多个安装包时，使用 `docker images` 命令查看显示内容，并使用冒号（:）连接前两列的内容。

   ```bash
   oat_image=`docker images | grep oat | awk '{printf $1":"$2"\n"}'`

   ```
 6. 运行 `docker run` 命令，启动 OAT。

   ```bash
    docker run -d --net host --name oat -v /data_dir:/data --restart on-failure:5 $oat_image

   ```

   #### 说明

      - OAT 的 HTTP 服务默认监听 7000 端口，可以指定 `-e HTTP_PORT=7001` 参数修改为其他端口。
      - 可以指定 `-e OAT_INITIAL_ADMIN_PASSWORD=xxx` 参数修改 OAT 的密码。
      - OAT 内置了 MariaDB 作为数据存储，默认监听 3306 端口，可以指定 `-e DB_PORT=3307` 参数修改为其他端口。
      - 建议使用 `--net host` 参数启动，因为 bridge 网络模式启动的容器可能被 `docker0` 网桥故障或操作系统参数 `ip_forward` 影响。
 7. 启动成功后，在浏览器地址栏输入 `http://<<oat_server_ip>:7000`。

   如果在浏览器窗口中看到登录界面，表示已经成功安装并启动 OAT。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
