---
title: "创建 OBProxy 集群 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: 创建 OBProxy 集群 通常在部署 OceanBase 数据库时已创建 OBProxy 集群，如果需要添加多个新的 OBProxy 与 OceanBase 集群连接，可以通过 OCP 来创建 OBProxy 集群。 前提条件 当前登录的用户是 OBPROXY_MANAGER 角色，具有管理 OBProxy 的权限…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS

# 创建 OBProxy 集群

更新时间：2026-04-07 20:57:20

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/1200.database-proxy/200.obproxy-management/200.manage-obproxy-clusters/100.create-an-obproxy-cluster.md)  

通常在部署 OceanBase 数据库时已创建 OBProxy 集群，如果需要添加多个新的 OBProxy 与 OceanBase 集群连接，可以通过 OCP 来创建 OBProxy 集群。

## 前提条件

当前登录的用户是 OBPROXY_MANAGER 角色，具有管理 OBProxy 的权限。如果当前用户不具备 OBPROXY_MANAGER 角色，需要先为用户添加该角色，具体操作请参见《 OCP 用户指南》中的 [编辑用户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000002101049)。

## 操作步骤

1. 登录 OCP。
 2. 在左侧导航栏单击 **OBProxy**，进入 OBProxy 页面。
 3. 单击右上方的 **创建 OBProxy 集群**。
 4. 在 **创建 OBProxy 集群** 页面填写如下信息：

      1. 参考下表，配置 **基本信息**。

        | 参数 | 说明 |
        | --- | --- |
        | 集群名 | 您可根据实际业务情况，自定义集群名称，以英文字母开头，可包含英文、数字和下划线。 |
        | 录入 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 集群](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013742) 添加。     - 当 **启动方式** 配置为 RsList 时，该参数必填。 在下拉框中选择对应的集群。     - 当密码箱中存在该集群 proxyro 用户的连接凭证时，会默认选择 proxyro 用户。     - 当密码箱中不存在该集群 proxyro 用户的连接凭证时，请单击 **新建连接**，为该集群的 proxyro 用户创建连接凭证。 |

        ![08261923](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/user-guide/odp-management/create-odp-cluster-basic-information.png)
      2. （可选）配置 **部署 OBProxy**。

        如需在创建 OBProxy 集群时就部署 OBProxy，可在该步骤就行配置。否则可跳过该步骤，待集群创建成功后，通过接管 OBProxy 或添加 OBProxy 的方式向集群中添加 OBProxy。

             1. 打开配置 **部署 OBProxy** 的开关。
             2. 参考下表填写部署信息。

               | 参数 | 说明 |
               | --- | --- |
               | SQL 端口 | 默认为 2883。 |
               | Exporter 端口 | 默认为 2884。 |
               | 软件版本 | 选择要安装的 OBProxy 版本。   #### 说明    若 **可连接的 OB 集群** 中存在 V4.0 及以上版本的集群时，仅支持选择 V4.0.0 及以上版本的 OBProxy 软件包。 |
               | **机房**、**机型（可选）**、**主机** | 选择部署 OBProxy 所使用的主机，包括该主机的 **机房**、**机型（可选）**、**主机**。 |

               ![08261945](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/user-guide/odp-management/depoly-odp.png)

               系统默认显示两个主机的选择，仅够部署两个 OBProxy，

                      - 如需部署更多，可单击 **添加 OBProxy** 来增加主机。
                      - 如只部署 1 个 OBProxy，可单击如上图所示的主机后的删除图标来删除该主机。
      3. 打开 **参数设置**，添加或修改启动参数，参数说明参见 [OBProxy 参数说明](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013307)。

        ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/user-guide/odp-management/set-parameters.png)
 5. 单击 **提交**，开始创建 OBProxy 集群。

   #### 说明

   安装 obproxy 时系统会检查涉及到的安装目录权限是否正确，目前支持递归检查 `/home/admin/logs/obproxy` 目录及其父目录对指定用户（默认 admin）是否有读权限及可执行权限。若没有，则会在日志中报 “check directory xxx permission failed, reason: xxx” 错误。

 上一篇 下一篇 ![有帮助](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) 咨询热线