---
title: "设置和查看租户白名单 - OceanBase 数据库 V4.1.0 | OceanBase 文档中心"
description: 设置和查看租户白名单 您可以通过租户白名单功能来设置允许哪些客户端访问当前租户。 背景信息 租户白名单指的是该租户允许登录的客户端列表。您可以根据业务需要自定义租户的白名单，系统支持以下多种租户白名单格式： IP 地址的形式：示例， 10.10.10.10,10.10.10.11 子网/掩码的形式：示例， 10.10…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0

# 设置和查看租户白名单

更新时间：2023-07-28 10:45:58

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/700.reference/200.administrator-guide/200.basic-database-management/400.manage-tenants/1000.configure-and-view-the-tenant-whitelist.md)  

您可以通过租户白名单功能来设置允许哪些客户端访问当前租户。

## 背景信息

租户白名单指的是该租户允许登录的客户端列表。您可以根据业务需要自定义租户的白名单，系统支持以下多种租户白名单格式：

- IP 地址的形式：示例，`10.10.10.10,10.10.10.11`
 - 子网/掩码的形式：示例，`10.10.10.0/24`
 - 模糊匹配的形式：示例，`10.10.10.%` 或者 `10.10.10._`
 - 多种格式混合的形式：示例，`10.10.10.10,10.10.10.11,10.10.10.%,10.10.10._,10.10.10.0/24`

## 操作步骤

系统变量 `ob_tcp_invited_nodes` 用于设置租户的 IP 白名单，是租户全局的白名单限制参数。默认值为 `127.0.0.1,::1`，表示仅允许本机的 IP 连接该租户。

通过 SQL 语句查看和设置租户白名单的方法如下：

1. 租户管理员登录到数据库。
 2. 执行以下语句，查看租户的白名单。

   ```sql
   obclient> SHOW VARIABLES LIKE 'ob_tcp_invited_nodes';
   +----------------------+-------+
   | Variable_name        | Value |
   +----------------------+-------+
   | ob_tcp_invited_nodes | %     |
   +----------------------+-------+

   ```

   其中，值为 `%` 表示允许任何客户端 IP 连接该租户。
 3. 如果需要更改白名单设置，可以执行以下语句，重新设置租户的白名单。

   示例如下：

   ```sql
   obclient> SET GLOBAL ob_tcp_invited_nodes='%';

   obclient> SET GLOBAL ob_tcp_invited_nodes='10.10.10.%';

   ```

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