---
title: "接管 OBProxy - 云平台 OCP V4.4.0 | OceanBase 文档中心"
description: 接管 OBProxy 本节为您介绍将 OBProxy 接管到当前 OCP 管理的 OBProxy 集群中的方法。未在当前 OCP 中的 OBProxy 称为待接管的 OBProxy，待接管的 OBProxy 将要接入的 OBProxy 集群为目标 OBProxy 集群。OBProxy 接入到目标 OBProxy 集群…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.4.0

# 接管 OBProxy

更新时间：2026-03-27 16:35:46

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.4.0/zh-CN/800.obproxy-functions/400.manage-a-obproxy-server/200.take-over-an-obproxy.md)  

本节为您介绍将 OBProxy 接管到当前 OCP 管理的 OBProxy 集群中的方法。未在当前 OCP 中的 OBProxy 称为待接管的 OBProxy，待接管的 OBProxy 将要接入的 OBProxy 集群为目标 OBProxy 集群。OBProxy 接入到目标 OBProxy 集群后会随该集群一起由当前 OCP 运维管理。

#### 说明

OBProxy 在接管时会被重启，重启 OBProxy 将对业务连接产生影响，请谨慎操作。

## 前提条件

- 请确保当前登录 OCP 的用户具备如下权限：

     - **OBProxy 维护** 资源权限。
     - OBProxy **概览** 菜单权限。
 - 待接管的 OBProxy 需满足以下条件：

     - 版本为 V1.8.0 及以上。
     - 由 rpm 包标准安装。
     - 所在主机上有且仅有这一个 obproxy 进程。
     - 可被 OCP 所在网络访问。
     - 所在主机已添加到 OCP，添加主机请参考 [添加主机](https://www.oceanbase.com/docs/common-ocp-1000000004276685)。
 - 当前 OCP 中已存在符合条件的目标 OBProxy 集群，目标 OBProxy 集群需满足的条件如下：

     - **启动方式** 与待接管的 OBProxy 一致。

      即如果目标 OBProxy 集群的启动方式为 ConfigUrl，则待接管的 OBProxy 的启动方式也应为 ConfigUrl。
     - **可连接 OceanBase 集群** 需包含或等于待接管的 OBProxy 的可连接 OceanBase 集群。

           - 启动方式为 ConfigUrl 时，待接管 OBProxy 的可连接 OceanBase 集群需在目标 OBProxy 集群的可连接 OceanBase 集群列表中。
           - 启动方式为 RsList 时，待接管 OBProxy 的可连接 OceanBase 集群需和目标 OBProxy 集群的可连接 OceanBase 集群完全相同。

  如果当前 OCP 中没有符合条件的 OBProxy 集群，请先参考 [创建 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000004276384) 创建符合条件的空 OBProxy 集群。

## 注意事项

- 当前 OBProxy 集群为 V4.0 及以上版本时，仅支持接管 V4.0.0 及以上版本的 OBProxy；当前 OBProxy 集群为 V3.x 及以下版本时，仅支持接管 V1.8 以上、V4.0.0 以下版本的 OBProxy。
 - 当源 OCP 和目标 OCP 的 `ocp.config-url.site.url` 配置项的值一致，且 OBProxy 集群名称相同、所有启动参数均支持动态更新（无需重启）时，可避免在接管时重启 OBProxy 服务。

## 操作步骤

接管 OBProxy 有如下两个入口：

- **入口一**：在 OBProxy 的 **集群列表** 中找到可接管该 OBProxy 的集群，并单击对应操作列的 **接管 OBProxy** 。
 - **入口二**：在 **集群列表** 中单击可接管该 OBProxy 的集群的集群名，进入该 OBProxy 集群 **概览** 页面，单击 **概览** 页右上角的 **接管 OBProxy** 。

以下操作步骤以 **入口二** 为例：

1. 登录 OCP。
 2. 在左侧导航栏单击 **OBProxy**。
 3. 在 **集群列表** 中单击可接管该 OBProxy 的集群的集群名，进入 OBProxy **概览** 页面。
 4. 单击 **接管 OBProxy**，进入 **接管 OBProxy** 界面。

   ![08261706](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421/%E6%8E%A5%E7%AE%A1obproxy-1.png)
 5. 在 **接管 OBProxy** 界面选择待接管的 OBProxy 所在主机。

   | 参数 | 说明 |
   | --- | --- |
   | **root@proxysys 密码** | 输入 OBProxy 管理员账号密码。此为选填项，若之前未更改过待接管 OBProxy 的 root@proxysys 密码，则不需要填写。   #### 说明    当接管多个 OBProxy 时，若多个 OBProxy 的 root@proxysys 密码不一致，建议将密码相同的作为一组进行分批接管。 |
   | **机房** | OBProxy 所在的机房，一个 OBProxy 只能存在于一个机房。 |
   | **机型** | 可选项。如果选择了机型，后面主机列表会根据机型进行过滤。 |
   | **主机** | 选择 OBProxy 所在主机。 |
   | **SQL 端口** | 选择 OBProxy 所在主机的 SQL 端口。 |
   | **负载均衡配置** | 可选项。支持手动填入和导入两种方式，具体如下图所示。    - 单击 **OBLB**，手动填入 OBLB 服务相关信息，参数说明可参见 [管理负载均衡](https://www.oceanbase.com/docs/common-ocp-1000000004276842)。   - 单击右侧 **导入** 按钮，上传迁出 OBProxy 集群时所导出的负载均衡器数据文件，OCP 将自动填入文件中的负载均衡信息，文件导出详情可参见 [迁出 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000004276843)。 |

   ![08261753](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/%E6%8E%A5%E7%AE%A1obproxy%E6%96%B0.png)
 6. 单击 **下一步** ，系统对待接管的 OBProxy 进行预检查，并将检查结果显示在预检查界面。

      - 存在检查不通过的 OBProxy 时，不可执行接管，可：

            - 视实际情况删除检查不通过的 OBProxy，只接管预检查通过的 OBProxy。
            - 将鼠标悬浮于 **检查结果** 列的 **原因** 上，查看预检查不通过的原因。修复后，单击 **重新检查** 。

       ![09011346](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/%E9%A2%84%E6%A3%80%E6%9F%A5%E4%B8%8D%E9%80%9A%E8%BF%87%E5%8E%9F.png)
      - 当列表中所有 OBProxy 的预检查结果均为通过时，可执行步骤 7。

       ![09011337](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/%E9%A2%84%E6%A3%80%E6%9F%A5%E9%80%9A%E8%BF%87.png)
 7. 单击 **全部接管** 按钮，在 **接管确认** 面板中 OBProxy 的接管信息。

      - 当待接管的 OBProxy 上存在可连接的 OceanBase 集群时，接管 OBProxy 时会将 OBProxy 上的可连接 OceanBase 集群同步添加至 OBProxy 集群中。
      - 当主机所在的 OBProxy 的部分参数值与 OBProxy 集群不一致，将无法进行接管，您需同意修改 OBProxy 参数。单击 **同意修改** 后，主机所在的 OBProxy 的参数均会被修改为与 OBProxy 集群参数一致。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/430/%E6%8E%A5%E7%AE%A1%E7%A1%AE%E8%AE%A4.png)
 8. 在接管对话框中输入 **confirm**，并单击 **确认接管**，提交接管任务。
 9. 等待接管任务执行成功，则接管完成。

   #### 说明

   为便于管理，当目标 OBProxy 被接管后，其 root@proxysys 密码将被统一设置为其所属的 OBProxy 集群的 root@proxysys 密码。

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