--- title: "安装 OAT | OceanBase 文档中心" description: 安装 OAT 本文介绍如何 Docker 部署 OAT。 前提条件 在部署 OAT 之前，您需要确认以下信息： 您的操作系统满足以下条件： 服务器类型 操作系统 支持版本 x86_64/ARM aarch64 RHEL (及兼容的 RockyLinux、CentOS 等) 7.2 及以上版本 x86_64/ARM a… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*jLd4SamEcM0AAAAAAAAAAAAADiGDAQ/original) 管理者工具 OATV 4.3.1 企业版 # 安装 OAT 更新时间：2026-06-15 15:55:31 本文介绍如何 Docker 部署 OAT。 ## 前提条件 在部署 OAT 之前，您需要确认以下信息： - 您的操作系统满足以下条件： | 服务器类型 | 操作系统 | 支持版本 | | --- | --- | --- | | x86_64/ARM aarch64 | RHEL (及兼容的 RockyLinux、CentOS 等) | 7.2 及以上版本 | | x86_64/ARM aarch64 | Anolis (及兼容的 Alibaba Cloud Linux、麒麟V10、统信UOS、中国移动 BC-Linux、凝思OS、中科方德等) | 8.4 及以上版本 | | x86_64/ARM aarch64 | Debian (及兼容的 Ubuntu 等) | 11 及以上 | | x86_64/ARM aarch64 | openSUSE | 12SP3 及以上 | | x86_64/ARM aarch64 | openSUSE | 12SP3 及以上 | | x86_64/ARM aarch64 | 凝思 | V6.0.99 及以上 | - 如果使用 OAT 镜像包进行安装需要您已经安装并启动 Docker。推荐 Docker 版本为社区版 18.09.9 及以上。 #### 注意 如果您使用 oat-all-in-one 安装包部署 OAT，oat-all-in-one 的 `install.sh` 脚本将自动安装 Docker，您无需再单独安装 Docker。 - OAT 的默认端口 `7000` 未被占用。 ## 使用 oat-all-in-one 安装包安装 OAT #### 说明 推荐您使用 oat-all-in-one 安装包安装 OAT。 按照以下步骤安装 OAT： 1. 请联系技术支持获取 OAT 的 oat-all-in-one 安装包。 2. 解压 oat-all-in-one 安装包。 **示例如下：** ```shell tar -xf oat-all-in-one-arm-xxx.tar ``` 3. 运行安装脚本 `install.sh`。 **示例如下：** ```shell sh oat-all-in-one-arm/install.sh ``` 运行此命令将自动安装 Docker (如果您的环境没有 Dcoker)，部署 OAT 并扫描 oat-all-in-one 中包含的镜像和工具软件包。 4. 根据提示，依次确认以下信息： 1. 请输入 Docker 的根目录（建议设置为单独挂载的目录），默认值 `/docker`（无需手动创建这个目录），可自定义。如果已安装 Docker，会跳过此步骤。 2. 请输入 OAT 数据目录的路径，默认值 `/oat_data`（无需手动创建这个目录），可自定义。 3. 请输入 OAT HTTP 监听端口，默认值 `7000`，可自定义。 4. 请输入 OAT 数据库端口，默认值 `3306`，可自定义。 5. 请输入 OAT 管理员账户密码（设置初始登录密码），可自定义。 6. 根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。 **示例如下：** #### 说明 因为服务器已安装了 Docker，所以本次安装跳过了安装 Docker 的步骤。 1. OAT 数据目录的路径，修改为 `/data/oat_data`，然后回车。 ```shell Input the OAT data dir: /data/oat_data ``` 2. OAT HTTP 监听端口使用默认值，直接回车。 ```shell Input the OAT HTTP listen port: 7000 ``` 3. OAT 数据库端口使用默认值，直接回车。 ```shell Input the OAT database port: 3306 ``` 4. OAT 管理员 admin 用户密码（初始登录密码）修改后，回车。 ```shell Input the OAT admin user password(login password): ****** ``` 5. 根据返回的 URL 访问 OAT，验证 OAT 服务的可用性。 返回结果如下： ```shell Start prepare docker Docker is already exists, start check... Already installed docker check healthy, skip install docker Start prepare OAT Loaded image: xxx/oceanbase/oat:x.x.x_20241025_arm 45fd5a9b31b0af6aeb07b3e485503ad4c64629170b91d1d3c9e8128e8e532125 check OAT url http://127.0.0.1:7000/hc OAT API not ready, please wait, sleep 5s retry... OAT API not ready, please wait, sleep 5s retry... OAT API not ready, please wait, sleep 5s retry... OAT API not ready, please wait, sleep 5s retry... OAT API not ready, please wait, sleep 5s retry... OAT API not ready, please wait, sleep 5s retry... OAT API ready Copy images and binary_packages to OAT data dir Trigger OAT scan api to find images and binary_packages Trigger scan task success, please visit OAT web site and wait for scan task finished OAT is ready for visit url is: http://:7000 user/password is: admin/****** ``` #### 说明 - `install.sh` 脚本启动 OAT 容器默认使用 `--net host`（主机网络模式）。如您需要配置为其他网络模式，请使用 OAT 镜像手动启动容器。 - x86（arrch64）版本的 `oat-all-in-one` 默认只包含 x86（aarch64）和 noarch 的镜像和软件包，如需 aarch64（x86）架构，请自行下载拷贝到 OAT 容器挂载的对应目录，然后发起扫描任务进行添加。 ## 使用 OAT docker image 安装 OAT 1. 获取 OAT 安装包。 #### 注意 请联系 OAT 技术支持人员获取安装包。 2. 使用 `scp` 命令将 OAT 安装包上传到服务器中。 其中 `oat_server` 为部署 OAT 的服务器的 IP 地址。 ```shell scp oat.tgz @:~/ ``` **示例如下：** ```shell scp oat_x.x.x_20241025_arm.tgz root@xxx.xxx.xxx.xxx:/home/admin/oat_rpm ``` 3. 挂载 OAT 目录。 在服务器创建 `/data_dir` 目录（可自定义路径，以 `/data_dir` 为例进行说明），用来保存 OAT 的持久化数据。 在 `/data_dir` 目录被挂载到 OAT 容器后，OAT 会自动创建 `/data_dir/logs`、`/data_dir/images` 和 `/data_dir/db` 目录，分别用于存放 OAT 的系统日志、组件和产品的 Docker 镜像以及 OAT 的数据库文件。 ```shell mkdir -p /data_dir ``` 4. 将 OAT 安装包装载为镜像。 ```shell docker load -i oat_xxx_xxxxxxxx_xxx.tgz ``` 其中 `oat_xxx_xxxxxxxx_xxx.tgz` 为安装包的名称。 **示例如下：** ```shell docker load -i oat_x.x.x_20241025_arm.tgz ``` 返回结果如下： ```shell Loaded image: xxx/oceanbase/oat:x.x.x_20241025_arm ``` 5. 使用 `docker images` 命令获取 OAT 镜像的标签。 #### 说明 当只加载了一个 OAT 安装包时，使用示例命令即可。当加载了多个安装包时，使用 `docker images` 命令查看显示内容，并使用冒号（:）连接前两列的内容。 ```shell oat_image=`docker images | grep oat | awk '{printf $1":"$2"\n"}'` ``` 6. 运行 `docker run` 命令，启动 OAT。 其中 `$oat_image` 是 OAT 镜像的标签。 ```shell docker run -d --net host --name oat -v /data_dir:/data -e OAT_INITIAL_ADMIN_PASSWORD=xxx --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` 影响。 **示例如下：** ```shell docker run -d --net host --name oat -v /data_dir:/data -e OAT_INITIAL_ADMIN_PASSWORD=****** --restart on-failure:5 $oat_image ``` 返回结果如下： ```shell 490344724bfcb2801da271196ebc38b5c15547b796178dc7660553ae62b668c2 ``` 7. 启动成功后，在浏览器地址栏输入 `http://:7000`。 其中 `` 替换为部署 OAT 的服务器的 IP 地址。 如果在浏览器窗口中看到登录界面，表示已经成功安装并启动 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) 咨询热线