首批通过分布式安全可靠测评,为关键业务系统打造
(可选)部署 OBProxy
更新时间:2026-04-16 00:11:35
OceanBase 数据库代理(OceanBase Database Proxy,简称:ODP,又称 OBProxy)是OceanBase 提供的一种数据库代理中间件,它可以用于连接池管理、负载均衡、故障转移等功能。OBProxy 是一个可选的组件,它的部署与否取决于您的应用需求和场景。
本节主要介绍使用 OCP 创建 OBProxy 集群。
说明
- 本节以 OCP V4.2.1 版本为例提供操作指导。不同 OCP 版本的操作界面可能不同,请以实际界面为准。
- OBProxy 在任何一个机器上部署后,通过向外暴露一个 ip:port 来提供 OceanBase 的代理服务。用户可以像访问 MySQL 数据库一样通过该 ip:port 即可访问 OceanBase 数据库,一般推荐部署在 OBServer 节点上。
- 建议一台机器上只部署一个 OBProxy 服务,并且使用约定的
2883端口。当同一台机器上部署多个 OBProxy 服务时,需要指定不同端口予以区分。
前提条件
- 您已部署 OCP。详细信息,请参见 部署 OCP。
- 当前登录的用户是
OBPROXY_MANAGER角色,或有管理 OBProxy 的权限。详细信息,请参见 角色概述 和 OCP 默认角色。 - 已获取 OBProxy RPM 包。详细信息,请参见 准备安装包。
操作步骤
登录 OCP。
在左侧导航栏单击 OBProxy,进入 OBProxy 页面。
在 OBProxy 页面,单击右上方的 创建 OBProxy 集群。
在 创建 OBProxy 集群 页面,配置 基本设置。
参数 描述 集群名 您可根据实际业务情况,自定义集群名称,以英文字母开头,可包含英文、数字和下划线。 录入 Proxyro 账号的密码 Proxyro 账号用于 OBProxy 访问 OceanBase 集群,未录入则使用 Proxyro 账号的默认密码进行连接。密码格式要求如下: - 长度为 8 ~ 32 个字符。
- 只能包含字母、数字和特殊字符
~!@#%^&*_-+=`|(){}[]:;',.?/。 - 大小写字母、数字和特殊字符都至少包含 2 个。
负载均衡管理 默认关闭状态。
- 负载均衡管理关闭状态需配置以下信息:
- 访问地址:OBProxy 集群访问地址,仅用于生成租户的连接串,不影响实际使用。如果是 VIP 地址,需要自己申请并绑定到 OBProxy Server。
- 访问端口:默认为 2883,支持自定义端口号。
- 负载均衡管理开启状态需配置以下信息:
- 负载均衡器:默认为 OBLB。阿里云 SLB 服务仅适用于专有云环境,建议联系技术支持同学进行协助。
- OBLB 服务:您可选择部署 OCP 时已配置的 OBLB 服务,或单击 添加 OBLB 服务 按钮,在右侧面板中新建 OBLB 服务。
- VIP:选择 OBLB 具体的 VIP 地址。
- 访问端口:默认为 2883,支持自定义端口号。
- 域名配置(可选):用于指向 VIP 及端口的配置信息,平台未提供 VIP 与域名的映射关系,需自行准备域名解析服务。
启动方式 该 OBProxy 集群的启动方式,可取值: - ConfigUrl:多集群启动方式,即该 OBProxy 集群可访问多个 OceanBase 集群。
- RsList:单集群启动方式,即该 OBProxy 集群仅可访问创建 OBProxy 集群时指定的那个 OceanBase 集群,OBProxy 集群创建成功后不可追加可连接的 OceanBase 集群。

(可选)在 创建 OBProxy 集群 页面,配置 部署 OBProxy。
如需在创建 OBProxy 集群时就部署 OBProxy,可在该步骤就行配置。否则可跳过该步骤,待集群创建成功后,通过 接管 OBProxy 或 添加 OBProxy 向集群中添加 OBProxy。
打开配置 部署 OBProxy 的开关。参考下表填写部署信息。
参数 描述 SQL 端口 默认为 2883。 Exporter 端口 默认为 2884。 软件版本 选择要安装的 OBProxy 版本。 说明
若 可连接的 OceanBase 集群 中存在 V4.0.0 及以上版本的集群时,仅支持选择 V4.0.0 及以上版本的 OBProxy 软件包。
选择 OBProxy 主机 选择部署 OBProxy 所使用的主机,包括该主机的 机房、机型(可选)、主机。
系统默认显示两个主机的选择,仅够部署两个 OBProxy,如需部署更多,可单击 添加 OBProxy 来增加主机。如只部署 1 个 OBProxy,可单击如上图所示的主机后的删除图标来删除该主机。
(可选)在 创建 OBProxy 集群 页面,配置 参数设置。
打开 参数设置,添加或修改启动参数和其它参数。

完成配置后,单击右下角 提交。