---
title: "添加主机 - 云平台 OCP V4.3.6 | OceanBase 文档中心"
description: 添加主机 在创建集群之前，需要将用到的主机添加到 OCP 中。创建 1-1-1 的集群，需要添加 4 台主机。3 个 Zone 每一个占用一台主机，OBProxy 占用一台主机。 前提条件 当前登录 OCP 的用户为 ADMIN 角色或 ORG_ADMIN 角色。 操作步骤 登录 OCP。 在左侧导航栏中单击 主机 …
---
切换语言

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

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

# 添加主机

更新时间：2026-04-02 18:05:51

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.6/zh-CN/500.quickstart/400.quickstart-add-a-host.md)  

在创建集群之前，需要将用到的主机添加到 OCP 中。创建 1-1-1 的集群，需要添加 4 台主机。3 个 Zone 每一个占用一台主机，OBProxy 占用一台主机。

## 前提条件

当前登录 OCP 的用户为 **ADMIN** 角色或 **ORG_ADMIN** 角色。

## 操作步骤

1. 登录 OCP。
 2. 在左侧导航栏中单击 **主机**。
 3. 在 **主机** 页签中，单击页面右上角的 **添加主机** 。
 4. 填写 **IP 地址** 和 **SSH 端口号** 。输入新主机的 IPv4/IPv6 地址，支持同时添加多个 IP 地址（多个 IP 之间用英文逗号分隔）；SSH 端口号默认 22。

   #### 注意

   当主机 IP 为 IPv6 地址时，具有如下限制：

      - 部署 OceanBase、OBClient 和 OBProxy 时：
            - OceanBase 版本须为 [V4.2.5 BP3 Hotfix3, V4.3.0) 或 [V4.3.5 BP2 Hotfix1, +∞)。
            - OBClient 版本须为 [V2.2.9, +∞)。
            - OBProxy 版本须为 [V4.3.4, +∞)。
      - Binlog 服务暂不支持 IPv6 部署。
 5. 选择机型。如果没有对应的机型，可以单击 **新增机型**，立即在 OCP 中新增机型。

   更多操作详情，可参考 [管理机型](https://www.oceanbase.com/docs/common-ocp-1000000003339277)。
 6. 选择机房。如果没有对应的机房，可以单击 **新增机房**，立即在 OCP 中新增机房。

   更多操作详情，可参考 [管理机房](https://www.oceanbase.com/docs/common-ocp-1000000003339275) 和 [管理区域](https://www.oceanbase.com/docs/common-ocp-1000000003339276)。
 7. 选择主机类型，并为主机选择连接凭据和设置主机别名。

   | 参数 | 说明 |
   | --- | --- |
   | 主机类型 | 选择所添加主机的类型，包括物理机与 ECS。 |
   | 凭据 | 选择密码箱中的凭据，如果没有对应的凭据，可以单击 **新增凭据** 为该主机创建新的连接凭据。      - 凭据名：以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2 ~ 32。   - 授权类型：包含 **用户名/密码**、**SSH 私钥** 和 **已配置免密** 三种方式。   - 用户类型：连接服务器的用户类型，支持 **root 用户** 及 **普通用户** 两种。          - **root 用户**：拥有 ROOT 权限的 SSH 用户。         - **普通用户**：拥有 ROOT 权限的普通用户，该用户须先配置免密执行 sudo 指令。OCP 目前仅支持配置所有指令免密执行 sudo，即在 `/etc/sudoers` 文件中，添加 `username ALL=(ALL) NOPASSWD:ALL`。   - 用户名：当用户类型为 **普通用户** 时填写，填写连接服务器的用户。   - 密码：当授权类型为 **用户名/密码** 时填写，填写连接服务器的密码。   - 私钥：当授权类型为 **SSH 私钥** 时填写，为服务器添加 SSH 凭证。   - OCP 主机私钥文件路径：当授权类型为 **已配置免密** 时填写，填写主机私钥文件的存放路径，默认为 `/home/admin/.ssh/id_rsa`。若 OCP 部署方式为 Docker，私钥文件请使用 Docker 内的文件路径。   - 说明：为凭据补充额外信息。 |
   | 主机别名 | 选填，为主机设置其它名称。 |
 8. （可选）填写主机说明。
 9. 单击 **确定** 。

#### 说明

若您需要自定义 agent 的端口号，可联系 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) 咨询热线