--- title: "（可选）部署 OBProxy - OceanBase 数据库 V4.2.1 | OceanBase 文档中心" description: （可选）部署 OBProxy OceanBase 数据库代理（OceanBase Database Proxy，简称：ODP，又称 OBProxy）是OceanBase 提供的一种数据库代理中间件，它可以用于连接池管理、负载均衡、故障转移等功能。OBProxy 是一个可选的组件，它的部署与否取决于您的应用需求和场景。… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.1 LTS # （可选）部署 OBProxy 更新时间：2026-04-16 00:11:35 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/400.deploy/300.deploy-oceanbase-enterprise-edition/300.deploy-through-a-graphical-interface/400.deploy-obproxy-use-ocp.md) 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](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220842)。 - 当前登录的用户是 `OBPROXY_MANAGER` 角色，或有管理 OBProxy 的权限。详细信息，请参见 [角色概述](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000001541995) 和 [OCP 默认角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000001541990)。 - 已获取 OBProxy RPM 包。详细信息，请参见 [准备安装包](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218706)。 ## 操作步骤 1. 登录 OCP。 2. 在左侧导航栏单击 **OBProxy**，进入 **OBProxy** 页面。 3. 在 **OBProxy** 页面，单击右上方的 **创建 OBProxy 集群**。 4. 在 **创建 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 集群。 | ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/4.deploy/3.deploy-oceanbase-database-enterprise/4.deploy-ob/ODP/1%E5%9F%BA%E6%9C%AC%E8%AE%BE%E7%BD%AE.png) 5. （可选）在 **创建 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，可单击如上图所示的主机后的删除图标来删除该主机。 | ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/4.deploy/3.deploy-oceanbase-database-enterprise/4.deploy-ob/ODP/2%E9%83%A8%E7%BD%B2odp.png) 6. （可选）在 **创建 OBProxy 集群** 页面，配置 **参数设置**。 打开 **参数设置**，添加或修改启动参数和其它参数。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/4.deploy/3.deploy-oceanbase-database-enterprise/4.deploy-ob/ODP/3%E5%8F%82%E6%95%B0%E8%AE%BE%E7%BD%AE.png) 7. 完成配置后，单击右下角 **提交**。 上一篇 下一篇 ![有帮助](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) 咨询热线