--- title: "部署 OceanBase 集群 | OceanBase 文档中心" description: 部署 OceanBase 集群 本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 obd 图形化界面部署 OceanBase 数据库。 背景信息 obd 自 V2.0.0 起支持图形化界面部署 OceanBase 数据库及相关组件，如 OBAgent、ODP、OCP Express … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*Qq8pT6yBPTcAAAAAAAAAAAAADiGDAQ/original) 安装部署工具 OBDV 3.2.0 社区版 # 部署 OceanBase 集群 更新时间：2026-04-14 17:55:42 [编辑](https://github.com/oceanbase/obd-doc/edit/V3.2.0/zh-CN/400.user-guide/200.ui-operations/200.use-ui-deploy-oceanbase.md) 本文以 x86 架构的 CentOS Linux 7.9 镜像作为环境介绍如何使用 obd 图形化界面部署 OceanBase 数据库。 ## 背景信息 obd 自 V2.0.0 起支持图形化界面部署 OceanBase 数据库及相关组件，如 OBAgent、ODP、OCP Express 等，图形化界面配置简单，通过页面的引导配置即可完成单集群部署。 ## 名词介绍 - OceanBase 数据库 一款完全自研的企业级原生分布式数据库，详细信息请参见 [OceanBase 数据库文档](https://www.oceanbase.com/docs/oceanbase-database-cn)。 - ODP OceanBase Database Proxy，OceanBase 数据库代理，是 OceanBase 数据库专用的代理服务器，简称为 ODP（又称为 OBProxy）。详细信息请参见 [OceanBase 数据库代理文档](https://www.oceanbase.com/docs/odp-doc-cn)。 - OCP Express 基于 Web 的 OceanBase 数据库 4.x 管理工具，融合在 OceanBase 数据库集群中，支持对数据库集群关键性能及基本数据库管理功能。详细信息请参考 [OceanBase 云平台 Express (OCP Express)](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013373)。 - OBAgent OBAgent 是 OceanBase 数据库监控采集框架，支持推、拉两种数据采集模式，可以满足不同的应用场景。 - obconfigserver OceanBase Configserver，obconfigserver 可提供 OceanBase 的元数据注册，存储和查询服务。详细信息请参见 [ob-configserver](https://github.com/oceanbase/ob-configserver/tree/main)。 ## 前提条件 在开始之前，请确保您已满足以下条件： - 您的机器满足软硬件要求。详细信息，参考官网《OceanBase 数据库》文档 [软硬件要求](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013498)。 - 仅部署 OceanBase 数据库，至少需要 2vCPU、6 GB 内存、20 GB 磁盘的可用资源。 - 部署 OceanBase 数据库及全部组件，至少需要 4vCPU、10 GB 内存、25 GB 磁盘的可用资源，推荐内存在 16 GB 以上。 - 部署 OCP Express 组件需先安装配置 Java 环境，目前仅支持 JDK1.8 版本。详细操作可参考 [常见问题](https://www.oceanbase.com/docs/community-obd-cn-1000000002691256) 中 **如何配置 Java 环境**。 #### 注意 obd 是通过 SSH 远程执行安装部署，所以您需通过 SSH 验证 Java 环境是否可用，详细操作请参见下文 **Java 环境验证**。 ## 准备软件 使用 obd 图形化部署 OceanBase 数据库时，可以选择在线部署或离线部署两种部署方式。 - 在线部署：obd 所在机器需保证能访问外部网络，无需提前配置部署所需安装包，部署过程中 obd 会从远程镜像仓库获取部署所需安装包。 - 离线部署：部署过程中无需访问外部网络，您需提前将部署所需安装包上传至 obd 本地镜像库。选择离线部署时推荐直接下载所需版本的 all-in-one 安装包。 根据不同的部署方式有不同的准备软件方法，您可根据实际情况选择合适的方法准备软件。 ### 在线部署 当您选择在线部署时，可以参考本节命令在中控机上安装 obd。 ```shell [admin@test001 ~]$ sudo yum install -y yum-utils [admin@test001 ~]$ sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo [admin@test001 ~]$ sudo yum install -y ob-deploy [admin@test001 ~]$ source /etc/profile.d/obd.sh ``` ### 离线部署 当您选择离线部署时，可参考本节命令下载并安装 all-in-one 安装包。 您可从 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter) 下载最新的 all-in-one 安装包，并将其复制到中控机中。执行如下命令解压并安装： ```shell [admin@test001 ~]$ tar -xzf oceanbase-all-in-one-*.tar.gz [admin@test001 ~]$ cd oceanbase-all-in-one/bin/ [admin@test001 bin]$ ./install.sh [admin@test001 bin]$ source ~/.oceanbase-all-in-one/bin/env.sh ``` ## 操作步骤 ### 步骤一：启动图形化界面 1. 启动图形化界面 命令行执行 `obd web` 命令启动图形化界面，单击输出的地址访问图形化界面。 ```shell [admin@test001 ~]$ obd web start OBD WEB in 0.0.0.0:8680 please open http://10.10.10.1:8680 ``` #### 说明 - 图形化界面默认使用 8680 端口，您可使用 `obd web -p ` 命令指定端口。 - 在阿里云或其他云环境下，可能出现程序无法获取公网 IP，从而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址访问图形化界面。 - `obd web` 命令绑定在 0.0.0.0 上，在多网卡部署的情况下，您可通过任意一个可访问的 IP 访问图形化界面。 - 可使用 nohup 或 screen 命令设置在后台执行 `obd web` 命令。 2. （可选）鼠标放置到图形化操作界面右上角的 **中文** 字符处可根据显示的语种单击切换中英文界面。 ![语种切换](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.4.0/zh-CN/200.quick-start/300.deploy-ocp-by-ui-12.png) 3. 在图形化界面中单击 **开启体验之旅**，在显示的 **欢迎使用 OceanBase 部署向导** 界面选择 **OceanBase 及配套工具** 模块，单击 **安装** 后进入 OceanBase 数据库部署界面。 ### 步骤二：部署配置 您可在 **部署配置** 界面配置集群名称，负载类型和部署组件，**部署配置** 界面内容如下。 ![部署配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.10.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase-02.png) | 模块 | 说明 | | --- | --- | | 部署配置 | 集群名称为 obd 专用部署产品的唯一名称，默认为 `myoceanbase`，可自定义，但不可和已有部署名重复。集群名需以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度在 2 ~ 32 个字符之间。您可通过 `obd cluster list` 命令查看 obd 中管理的集群。 | | 部署数据库 | 单击 **版本** 下的下拉框可自行选择 OceanBase 数据库的版本，单击对应组件后的 **了解更多** 可跳转查看对应组件的文档介绍。 | | 负载类型 | 单击 **类型** 下的下拉框可自行选择 OceanBase 集群的负载类型，可切换不同类型查看对应 **描述**，了解各类型的适用场景。 | | 可选组件 | 默认仅勾选 OBProxy 组件，您可通过单击 **可选组件** 下对应组件前的勾选框设置是否部署对应组件，组件版本固定为最新版本，单击对应组件后的 **了解更多** 可跳转查看对应组件的文档介绍。 #### 说明 勾选 OCP Express 组件时会自动勾选 OBAgent 组件，取消勾选 OBAgent 组件时会自动取消勾选 OCP Express 组件。 | 配置完成之后单击 **下一步** 可进入到 **节点配置** 页面。 ### 步骤三：节点配置 您可在 **节点配置** 界面配置数据库和组件节点，部署用户以及软件安装路径，**节点配置** 界面内容如下。 ![节点配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.10.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase-03.png) | 模块 | 参数 | 说明 | | --- | --- | --- | | 数据库节点配置 | Zone 名称 | 配置 OceanBase 数据库中的 Zone 名称，可自定义。Zone 名称需以英文字母开头，英文或数字结尾，可包含英文、数字和下划线且长度在 2~32 个字符之间。部署多 Zone 的 OceanBase 集群必须有一个 Zone 与主 Zone 的 Region 相同。可单击 **+ 新增 Zone** 或对应 Zone 后的删除图标新增或删除 Zone。 | | OBServer 节点 | 配置 OceanBase 集群中的 OBServer 节点 IP，输入 IP 后单击键盘 Enter 可配置多个节点 IP。 #### 注意 当 OBServer 节点配置为 `127.0.0.1` 时，此 OceanBase 集群不支持扩展为分布式集群和配置主备租户。 | | RootServer 节点 | 可通过下拉框在 **OBServer 节点** 配置的 IP 中选择一个 IP 作为 OceanBase 集群的 RootServer 节点。对于多副本的 OceanBase 集群，其每个 Zone 都需指定一个 RootServer。 | | 组件节点配置 | OCP Express 节点 | 既可从下选框选择 OBServer 节点 IP，也可输入新的节点 IP。仅支持选择或输入一个节点，建议使用非 `127.0.0.1` IP 地址。 | | OBProxy 节点 | 支持配置多个节点，既可通过下选框选择 OBServer 节点 IP，也可输入新的节点 IP，建议使用非 `127.0.0.1` IP 地址。输入 IP 后单击键盘 Enter 可配置多个节点 IP。 | | obconfigserver 节点 | 支持配置多个节点，既可通过下选框选择 OBServer 节点 IP，也可输入新的节点 IP，建议使用非 `127.0.0.1` IP 地址。输入 IP 后单击键盘 Enter 可配置多个节点 IP。为 obconfigserver 配置多个节点时，您需提前配置负载均衡，并在 **集群配置** 页面的 **组件配置** 模块打开 **更多配置** 按钮，配置 `vip_address` 和 `vip_port`。 | | 部署用户配置 | 用户名 | 配置部署 OceanBase 集群的用户名，默认为当前进程的启动用户。支持自定义选择用户名，用户名仅支持英文、数字和点且长度不超过 20 个字符，需确保选择的用户名在所有主机上均存在。 | | 密码 | **用户名** 对应用户的登录密码，如各节点间已配置免密可免去输入密码。 | | SSH 端口 | 默认为 22 端口，支持自定义 SSH 端口。 | | 软件路径配置 | 软件路径 | 默认为部署用户的家目录，可自定义修改，需为以 `/` 开头的绝对路径，只能包含字母、数字和特殊字符（`-_:@/.`）。配置后会在对应目录下创建 **集群名称** 同名文件夹。 | 配置完成之后单击 **下一步** 可进入到 **集群配置** 页面。 ### 步骤四：集群配置 **集群配置** 界面可对集群进行配置，包括系统租户的管理员用户（root@sys）密码、数据和日志目录、数据库及各组件的端口和参数配置等，本节将分别进行介绍。 1. 集群配置 ![集群配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.10.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase-04.png) | 参数 | 说明 | | --- | --- | | 模式配置 | 可选择 **最大占用** 或 **最小可用**，**最大占用** 模式将最大化利用环境资源，保证集群的性能与稳定性，推荐使用；**最小可用** 模式配置满足集群正常运行的资源参数。两种模式的详细介绍可参考 [模式配置规则](https://www.oceanbase.com/docs/community-obd-cn-1000000002691249) 一文。 | | root@sys 密码 | 可单击 **随机生成**，由 obd 自动生成随机字符串，也可自定义设置。自定义设置时，密码复杂度需满足如下要求： - 长度为 8~32 位字符 - 包含以下四种类型字符中至少三种：数字（0~9）、大写字母（A~Z）、小写字母（a~z）和特殊字符（`~!@#%^&*_-+=\|(){}[]:;,.?/`）配置后可单击 **复制密码**，复制后保存已配置的密码。 | | 数据目录 | 默认在 **节点配置** 页面中配置的 **软件路径** 下，支持自定义设置，需为以 `/` 开头的绝对路径，只能包含字母、数字和特殊字符（`-_:@/.`），且需确保设置的目录为空。 | | 日志目录 | 默认在 **节点配置** 页面中配置的 **软件路径** 下，支持自定义设置，需为以 `/` 开头的绝对路径，只能包含字母、数字和特殊字符（`-_:@/.`），且需确保设置的目录为空。 | | SQL 端口 | SQL 服务协议端口号，默认为 `2881`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | RPC 端口 | 远程访问的协议端口号，默认为 `2882`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | 更多配置 | 可单击 **更多配置** 前的展开按钮查看并配置对应的集群参数，可使用自动分配的值进行配置，也可自定义各个参数。 #### 说明 您可通过在 **更多配置** 中设置 `obshell_port` 配置项来设置 OceanBase 数据库运维端口，未配置的情况下默认为 `2886`。 | 2. 组件配置 ![组件配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.10.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase-05.png) | 参数 | 说明 | | --- | --- | | OCP Express 管理员密码 | OCP Express 管理员账号的登录密码，可点击 **随机生成**，由 obd 自动生成随机字符串，也可自定义设置。自定义设置时，密码复杂度需满足如下要求： - 长度为 8~32 位字符 - 至少包含以下四种类型字符各 2 个：数字（0~9）、大写字母（A~Z）、小写字母（a~z）和特殊字符（``~!@#%^&*_-+=`\|(){}[]:;',.?/``）配置后可单击 **复制密码**，复制后保存已配置的密码。 | | OBProxy SQL 端口 | ODP 监听端口，默认为 `2883`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | OBProxy Exporter 端口 | OBProxy 的 Exporter 端口，用于 Prometheus 拉取 OBProxy 监控数据。默认为 `2884`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | OBProxy RPC 端口 | 默认为 `2885`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | OBAgent 监控服务端口 | 默认为 `8088`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | OBAgent 管理服务端口 | 默认为 `8089`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | OCP Express 端口 | 访问 OCP Express 的 HTTP 端口，默认为 `8180`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | obconfigserver 服务端口 | obconfigserver 服务监听的端口，默认为 `8080`，可自定义设置（仅支持 1025~65535 范围），需确保设置的端口未被占用。 | | 更多配置 | 可单击 **更多配置** 后的按钮查看对应的组件参数，可使用自动分配的值进行配置，也可自定义各个参数。 #### 说明 若在 **节点配置** 中的 **obconfigserver 节点** 处配置了多个节点，您需打开 **更多配置** 按钮，并配置 `vip_address` 和 `vip_port`，否则预检查时会报错。 | 全部配置完成后，单击 **下一步** 即可进入到 **预检查** 页面。 ### 步骤五：预检查 在 **预检查** 页面查看所有配置信息，若发现问题可单击 **上一步** 进行修改；确认无误后，单击 **预检查** 进行检查。 若预检查报错，您可根据页面建议选择 **自动修复**（针对可自动修复的检查项）或者单击 **了解更多方案** 跳转至错误码文档，参考文档自行修改。所有报错修改后，可单击 **重新检查** 再次进行预检查。 ![预检查](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.9.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase-05.png) 预检查通过后，单击 **部署** 即可开始 OceanBase 数据库的部署。 ### 步骤六：部署 ![部署](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.9.0/zh-CN/200.quick-start/300.use-ui-deploy-oceanbase-06.png) 其中： - 部署成功后可复制显示的连接串连接到对应组件。在黑屏界面执行 OceanBase 数据库组件后的连接串会以 root@sys 用户连接到 OceanBase 集群，执行 OBProxy 组件后的连接串会以 root@proxysys 用户连接到 ODP。 - 单击输出的 OCP Express 组件的连接串可跳转到 OCP Express 的登录界面，通过部署界面展示的账号密码登录并修改密码后可使用图形化界面管理集群。 #### 说明 在阿里云或其他云环境下，可能出现程序无法获取公网 IP，从而输出内网地址的情况，此 IP 非公网地址，您需要使用正确的地址访问图形化界面。 - 在 **部署报告** 里单击对应组件前的展开图标即可查看部署的日志信息。单击对应组件列表里的 **查看详情** 后，单击对应命令后的复制图标即可复制命令，复制后可在中控机中执行查看对应组件的日志位置。 - 可单击 **一键复制**，在复制保存 OceanBase 集群的所有账密信息后，单击 **完成** 退出部署程序。 #### 注意 如需部署多个集群，您需在图形化界面单击 **完成** 结束当前 obd 进程后才可再次执行 `obd web` 命令进行下一集群的部署。 ## 相关操作 ### Java 环境验证 由于 obd 是通过远程执行脚本部署 OCP Express，所以需要通过 SSH 方式验证 Java 环境，直接在机器上执行 `java -version` 可能无效。 #### 说明 使用终端交互会自动初始化环境变量，SSH 方式访问不会初始化环境变量，会导致使用 SSH 执行命令时出现 Java 命令不存在或使用错误 Java 版本的情况。 您可在任意一台网络与 OCP Express 所在节点连通的机器上执行如下命令进行验证。 ```shell # ocp_express_node_username：ocp_express 所在节点的用户名 # ocp_express_node_ip：ocp_express 所在节点 IP [admin@test001 ~]$ ssh @ 'java -version' # 输出结果 openjdk version "1.8.0_xxx" OpenJDK Runtime Environment (build 1.8.0_362-b08) OpenJDK 64-Bit Server VM (build 25.362-b08, mixed mode) ``` 如您已安装符合条件的 Java 但是验证却没有通过，可以通过以下任一方法解决： - 方法一：通过组件页面 **更多配置** 配置 **java_bin** 路径 如下图，在配置项 `java_bin` 中配置 Java 的真实路径，如 `/jdk8/bin/java`。 ![更多配置](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/obd/V2.1.0/zh-CN/2.quick-start/3.use-ui-deploy-oceanbase-07.png) - 方法二：将 Java 可执行文件软链接到 `/usr/bin/java` 中 ```shell [admin@test001 bin]$ pwd /jdk8/bin [admin@test001 bin]$ ln -s /jdk8/bin/java /usr/bin/java ``` ### 管理部署后的集群 您可执行如下命令对 obd 部署的集群进行管理。更多操作详见 [集群命令组](https://www.oceanbase.com/docs/community-obd-cn-1000000002691284)。 ```shell # 查看集群列表 [admin@test001 ~]$ obd cluster list # 查看集群状态，以部署名为 myoceanbase 为例 [admin@test001 ~]$ obd cluster display myoceanbase # 停止运行中的集群，以部署名为 myoceanbase 为例 [admin@test001 ~]$ obd cluster stop myoceanbase # 销毁已部署的集群，以部署名为 myoceanbase 为例 [admin@test001 ~]$ obd cluster destroy myoceanbase ``` ### 部署特定版本组件 使用 all-in-one 安装包部署时，all-in-one 的包是基于 OceanBase 版本进行迭代，若包中有其他组件存在更新版本，您可从 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter) 下载最新版本的组件，参考如下步骤将其上传至本地镜像库，obd 部署时会自动获取本地镜像库中的最新版本。 1. 进到组件安装包所在目录下，将安装包添加至本地镜像库 ```shell [admin@test001 rpm]$ obd mirror clone *.rpm ``` 2. 查看本地镜像库中安装包列表 ```shell [admin@test001 rpm]$ obd mirror list local ``` 上一篇 下一篇 ![有帮助](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) 咨询热线