---
title: "接管 OBProxy - 云平台 OCP V4.3.3 | OceanBase 文档中心"
description: 接管 OBProxy 本节为您介绍如何接管 OBProxy。在本文中，即将接管进 OCP 的 OBProxy 称为待接管的 OBProxy，待接管的 OBProxy 将要接入的 OBProxy 集群称为目标 OBProxy 集群。 应用场景 接管 OBProxy 操作将会使待接管的 OBProxy Server 被 …
---
切换语言

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

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

# 接管 OBProxy

更新时间：2026-04-14 15:16:08

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.3/zh-CN/1850.ocp-om-best-practices/1260.takeover-the-obproxy.md)  

本节为您介绍如何接管 OBProxy。在本文中，即将接管进 OCP 的 OBProxy 称为待接管的 OBProxy，待接管的 OBProxy 将要接入的 OBProxy 集群称为目标 OBProxy 集群。

## 应用场景

接管 OBProxy 操作将会使待接管的 OBProxy Server 被 OCP 管理，通常与 [迁出 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000001739888) 配合使用，用来将 OBProxy 从一个 OCP 迁移到另一个 OCP 中。

## 注意事项

接管 OBProxy 是以单个 OBProxy Server 为最小粒度，而迁出 OBProxy 集群只能整集群迁出，二者略有不同。因此在接管时，需要在 OCP 上准备一个已有的 OBProxy 集群，用来将 OBProxy Server 接管进目标 OBProxy 集群。

## 前置条件

- 待接管的 OBProxy 需要满足以下条件：

     - OBProxy 的版本为 V1.8.0 及以上。
     - 所在主机上有且仅有 1 个 OBProxy 进程。
     - 若 OBProxy 使用了非默认的 root@proxysys 密码，则需要提前准备好 root@proxysys 密码。
     - 所在主机已被 OCP 管理。
     - OBProxy 有可连接的 OceanBase 集群，并且使用过 OBProxy 连接到 OceanBase 集群。
 - 目标 OBProxy 集群需要满足以下条件：

     - 启动方式（ConfigUrl / RsList）与待接管的 OBProxy 一致。
     - 可连接的 OceanBase 集群需要包含或等于待接管的 OBProxy 的可连接 OceanBase 集群。
 - OCP 不允许在一个 OBProxy 集群中混合部署 V4.x 以前和 V4.x 以后版本的 OBProxy Server，因此要求：目标 OBProxy 集群中的 OBProxy 与待接管的 OBProxy 不能同时存在 V4.x 以前和 V4.x 以后的版本。

## 操作步骤

1. 登录 OCP，进入待接管的 OBProxy 集群概览页面。
 2. 单击右上方 **接管 OBProxy** 按钮，进入到接管 OBProxy 页面。
 3. 在 **选择 OBProxy 所在主机** 页面填充相关信息，总共分为如下三部分：

      - root@proxysys 密码（可选）：开关关闭时，OCP 会使用默认密码连接 OBProxy；开关打开时，不填充则默认为空密码，填充则会使用所填充的密码连接 OBProxy。填充后若无法连接 OBProxy，会在下一步接管前预检查时报错。
      - 主机信息：依次选择待接管的 OBProxy 的机房、机型、主机 IP、SQL 端口信息。
      - 负载均衡管理：若希望将待接管的 OBProxy 使用的 OBLB、SLB 实例录入到新的 OCP 中，则需要将对应的负载均衡实例信息填充在此处。也可以选择导入已有的负载均衡实例配置文件，文件来自在 OCP [迁出 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000001739888) 时导出的负载均衡实例数据文件。

       #### 注意

            - 此处填写的信息仅表示录入已使用的负载均衡实例信息，而非新创建负载均衡实例。
            - 所录入的负载均衡实例对应的 OBProxy 应全部在此次待接管 OBProxy 范围中。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/%E6%8E%A5%E7%AE%A1obproxy%E6%96%B0.png)
 4. 信息录入完毕后，单击 **下一步** 进入到预检查结果展示页面。若预检查不通过，可以将光标悬停于 **检查结果** 列的 **原因** 上，查看检查不通过的原因。

   根据问题原因进行修复，修复后，单击 **重新检查**。当列表中所有 OBProxy 的预检查结果均为通过时，单击 **全部接管** 按钮。

   ![1](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)
 5. 当待接管 OBProxy 与目标 OBProxy 集群参数不一致时，将无法进行接管，您需同意将待接管 OBProxy 参数修改为与目标 OBProxy 集群参数一致。

   单击 **同意修改**，并在弹出的对话框输入 `confirm`，即提交接管 OBProxy 任务。若有需要重启生效的参数，在接管过程中会重启 OBProxy。任务运行完毕后，代表 OBProxy 接管成功。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/%E4%BF%AE%E6%94%B9obproxy%E5%8F%82%E6%95%B0.png)

## 常见问题

**Q：接管预检查时报错，报错内容为「无法获取 obproxy 可连接集群信息。当前 obproxy 自启动后是否还未访问过 OceanBase 集群？」**

A：如报错信息所述，您需要通过当前报错的 OBProxy 连接 OceanBase 集群后，再重新进行预检查；此报错也能说明当前 OBProxy 还未被使用过，可以执行先删除后重建的操作。

**Q：在准备目标 OBProxy 集群时，建立好了空集群，无法将一个 V4.x 的 OceanBase 集群添加到可连接 OceanBase 集群中，如何处理？**

A：此报错是因为 OCP 进行了限制：空 OBProxy 集群不允许关联 V4.x 的可连接 OceanBase 集群。

此时您可以为空集群添加一个 V4.x 版本的 OBProxy，然后正常进行接管流程即可（即添加可连接 OceanBase 集群 > 接管 OBProxy）。接管流程结束后，若不需要则可删除最初临时添加的 OBProxy。

**Q：接管预检查时报错，报错内容为「lb 实例 ip:port 所对应的 obproxy ip1,ip2,ip3 未全部包含在此次接管的范围中。」**

A：此报错说明接管预检查时填写的负载均衡实例 `ip:port` 所对应的 OBProxy 并未全部在此次接管的范围中，此时可以考虑将负载均衡实例对应的 OBProxy 全部放在同一批次中进行接管，或接管时不填写该负载均衡实例信息（即不把该负载均衡实例录入到新 OCP 中）。

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