---
title: "查看和设置租户白名单 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 查看和设置租户白名单 通过租户白名单功能可以设置允许哪些客户端访问当前租户。 背景信息 租户白名单指的是该租户允许登录的客户端列表，通过租户系统变量 ob_tcp_invited_nodes 的值来确定，默认为本机的 IP 地址。您可以根据业务需要自定义租户的白名单，系统支持以下多种租户白名单格式： IP 地址的形式…
---
切换语言

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

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

# 查看和设置租户白名单

更新时间：2026-06-29 18:00:25

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/600.manage/200.tenant-management/600.common-tenant-operations/500.view-and-set-whitelist.md)  

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

## 背景信息

租户白名单指的是该租户允许登录的客户端列表，通过租户系统变量 `ob_tcp_invited_nodes` 的值来确定，默认为本机的 IP 地址。您可以根据业务需要自定义租户的白名单，系统支持以下多种租户白名单格式：

- 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`

## 查看租户白名单

1. 租户管理员登录数据库。

   ```shell
   obclient -h172.30.xx.xx -P2883 -uroot@mq_t1#cluster  -A

   ```
 2. 查看租户白名单。

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

   ```

## 设置租户白名单

租户白名单可以通过 sys 租户的管理员用户进行修改，也可以通过本租户的管理员进行修改。

### sys 租户管理员修改租户白名单

1. 使用 root 用户登录到集群的 sys 租户。

   ```shell
   obclient -h172.30.xx.xx -P2883 -uroot@sys#cluster -p**** -A

   ```
 2. 修改租户的白名单配置。

   ```shell
   obclient> ALTER TENANT mq_t1 VARIABLES ob_tcp_invited_nodes = '10.10.10.%';

   ```

### 用户租户管理员修改本租户白名单

1. 租户管理员登录数据库。

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

   ```
 3. 设置成功后，退出当前 Session，重新登录，使设置生效。
 4. 查看修改结果。

   ```shell
   obclient> SHOW VARIABLES LIKE 'ob_tcp_invited_nodes';
   +----------------------+------------+
   | Variable_name        | Value      |
   +----------------------+------------+
   | ob_tcp_invited_nodes | 10.10.10.% |
   +----------------------+------------+

   ```

## 相关文档

[ob_tcp_invited_nodes](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685126)

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