---
title: "添加主机 - 云平台 OCP V4.3.2 | OceanBase 文档中心"
description: 添加主机 本页面为您介绍添加主机的操作步骤，添加主机操作旨在于将线下设备添加到 OCP 控制台中。 前提条件 当前登录用户需要具备主机管理权限。 操作步骤 登录 OCP。 在左侧导航栏中单击 主机 。 在页面右上角单击 添加主机 。 填写 IP 地址 和 SSH 端口号 。输入新主机的 IPv4 地址，支持同时添加多…
---
切换语言

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

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

# 添加主机

更新时间：2026-04-14 15:15:54

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.2/zh-CN/850.host-features/200.add-a-host.md)  

本页面为您介绍添加主机的操作步骤，添加主机操作旨在于将线下设备添加到 OCP 控制台中。

## 前提条件

当前登录用户需要具备主机管理权限。

## 操作步骤

1. 登录 OCP。
 2. 在左侧导航栏中单击 **主机**。
 3. 在页面右上角单击 **添加主机** 。

   ![05191443](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/410/%E6%B7%BB%E5%8A%A0%E4%B8%BB%E6%9C%BA.png)
 4. 填写 **IP 地址** 和 **SSH 端口号** 。输入新主机的 IPv4 地址，支持同时添加多个 IP 地址（多个 IP 之间用英文逗号分隔）；SSH 端口号默认 22。
 5. 选择机型。如果没有对应的机型，可以单击 **新增机型**，立即在 OCP 中新增机型。

   机型是用户为配置相同的主机指定的一个标签，建议用户指定有意义的名称，便于更好地管理主机。

   ![1725](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/410/%E6%96%B0%E5%A2%9E%E6%9C%BA%E5%9E%8B.png)
 6. 选择机房。如果没有对应的机房，可以单击 **新增机房**，立即在 OCP 中新增机房。

      - 区域用于表示主机所处的地理区域，一个物理区域下可以存在一个或多个物理机房。
      - 区域和机房是 OceanBase 负载均衡和 SQL 语句路由策略的参考项，请按照实际情况填写。  

   #### 说明

   OCP V3.1.1 版本开始支持多可用区模式，新增机房时，将在当前 OCP 所在的可用区中创建新的机房。

   ![1726](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/410/%E6%96%B0%E5%A2%9E%E5%8C%BA%E5%9F%9F.png)
 7. 选择主机类型，并为主机选择连接凭据和设置主机别名。

   | 参数 | 说明 |
   | --- | --- |
   | 主机类型 | 选择所添加主机的类型，包括物理机、容器与 ECS。 |
   | 端口映射 | 当主机选择 **容器** 时填写，需指定 ocp-agent 与宿主机、ocp export 与宿主机一共 2 组的映射关系，对应的格式为 `“<主机端口>:<docker 中 ocp-agent 端口>,<主机端口>:<docker 中 ocp-exporter 端口 1>”`。 |
   | 凭据 | 选择密码箱中的凭据，如果没有对应的凭据，可以单击 **新增凭据** 为该主机创建新的连接凭据。       - 凭据名：以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2 ~ 32。   - 授权类型：包含密码验证、公钥验证和已配置免密三种方式。   - 用户类型：支持拥有 ROOT 权限的 SSH 用户，拥有 ROOT 权限的普通用户须先配置免密执行 sudo 指令。OCP 目前仅支持配置所有指令免密执行 sudo，即在 `/etc/sudoers` 文件中，添加 `username ALL=(ALL) NOPASSWD:ALL`。 |
   | 主机别名 | 选填，为主机设置其它名称。 |

   ![1728](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/432/%E6%96%B0%E5%BB%BA%E5%87%AD%E6%8D%AE.png)
 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) 咨询热线
