首批通过分布式安全可靠测评,为关键业务系统打造
创建 OBProxy 集群
更新时间:2026-04-07 20:57:20
通常在部署 OceanBase 数据库时已创建 OBProxy 集群,如果需要添加多个新的 OBProxy 与 OceanBase 集群连接,可以通过 OCP 来创建 OBProxy 集群。
前提条件
当前登录的用户是 OBPROXY_MANAGER 角色,具有管理 OBProxy 的权限。如果当前用户不具备 OBPROXY_MANAGER 角色,需要先为用户添加该角色,具体操作请参见《 OCP 用户指南》中的 编辑用户。
操作步骤
登录 OCP。
在左侧导航栏单击 OBProxy,进入 OBProxy 页面。
单击右上方的 创建 OBProxy 集群。
在 创建 OBProxy 集群 页面填写如下信息:
参考下表,配置 基本信息。
参数 说明 集群名 您可根据实际业务情况,自定义集群名称,以英文字母开头,可包含英文、数字和下划线。 录入 Proxyro 账号的密码 Proxyro 账号用于 OBProxy 访问 OB 集群,未录入则使用 Proxyro 账号的默认密码进行连接。密码格式要求如下: - 长度为 8 ~ 32 个字符。
- 只能包含字母、数字和特殊字符
~!@#%^&*_-+=|(){}[]:;,.?/。 - 大小写字母、数字和特殊字符都至少包含 2 个。
负载均衡管理 开启负载均衡管理后,可通过配置 OBLB 来提升 OBProxy 集群的负载均衡能力。 - OBLB 服务:您可选择部署 OCP 时已配置的 OBLB 服务,或单击 添加 OBLB 服务 按钮,在右侧面板中新建 OBLB 服务。
- OBLB 服务地址:OBLB 的服务地址。
- OBLB 服务端口:默认为 9090,可根据实际情况进行更改。
- 用户名及密码:OBLB 服务的用户名及密码,用于调用 OBLB 接口的认证信息。
- VIP:选择 OBLB 具体的 VIP 地址。
- 访问端口:默认为 2883,支持自定义端口号。
- 域名配置(可选):用于指向 VIP 及端口的配置信息,平台未提供 VIP 与域名的映射关系,需自行准备域名解析服务。
说明
负载均衡管理 中的 SLB 服务 仅适用于专有云环境,建议联系技术支持同学进行协助。
访问地址 当 负载均衡管理 关闭时展示,为 OBProxy 集群的访问地址,仅用于生成租户的连接串,不影响实际使用,需要自主配置负载均衡,如果是 VIP 地址,还需要您自主申请并绑定到 OBProxy Server。 访问端口 当 负载均衡管理 关闭时展示,默认为 2883,需要根据 VIP 的真实端口填写。 启动方式 该 OBProxy 集群的启动方式,可取值: - ConfigUrl:多集群启动方式,即该 OBProxy 集群可访问多个 OceanBase 集群。
- RsList:单集群启动方式,即该 OBProxy 集群仅可访问创建 OBProxy 集群时指定的那个 OceanBase 集群,OBProxy 集群创建成功后不可追加可连接的 OB 集群。
选择可连接 OceanBase 集群 设置该 OBProxy 集群可访问的 OceanBase 集群。 - 当 启动方式 配置为 ConfigUrl 时,该参数非必填,集群创建成功后,可通过 添加可连接的 OceanBase 集群 添加。
- 当 启动方式 配置为 RsList 时,该参数必填。 在下拉框中选择对应的集群。
- 当密码箱中存在该集群 proxyro 用户的连接凭证时,会默认选择 proxyro 用户。
- 当密码箱中不存在该集群 proxyro 用户的连接凭证时,请单击 新建连接,为该集群的 proxyro 用户创建连接凭证。

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

单击 提交,开始创建 OBProxy 集群。
说明
安装 obproxy 时系统会检查涉及到的安装目录权限是否正确,目前支持递归检查
/home/admin/logs/obproxy目录及其父目录对指定用户(默认 admin)是否有读权限及可执行权限。若没有,则会在日志中报 “check directory xxx permission failed, reason: xxx” 错误。