---
title: "接管 OBProxy - 云平台 OCP V4.2.1 | 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.2.1

# 接管 OBProxy

更新时间：2026-03-27 17:45:45

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.2.1/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 运维管理。

## 前提条件

- 当前登录 OCP 的用户是 OBPROXY_MANAGER 角色。
 - 待接管的 OBProxy 需满足以下条件：

     - 版本为 V1.8.0 及以上。
     - 由 rpm 包标准安装。
     - 所在主机上有且仅有这一个 obproxy 进程。
     - 可被 OCP 所在网络访问。
     - 所在主机已添加到 OCP，添加主机请参考 [添加主机](https://www.oceanbase.com/docs/common-ocp-1000000000348010)。
 - 当前 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-1000000000347970) 创建符合条件的空 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 端口。 |

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

   ![09011346](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7604601361/p314076.png)

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

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

   当列表中所有 OBProxy 的预检查结果均为通过时，可执行步骤 6。

   ![09011337](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/7604601361/p314073.png)
 7. 单击 **全部接管** 按钮。

   #### 说明

   为便于管理，当目标 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) 咨询热线