文档中心

云搜索服务

实例访问

配置实例私网 IP 白名单

配置实例私网 IP 白名单

实例默认支持私网访问，允许相同 VPC 环境内的所有设备访问实例，建议您为实例配置私网 IP 白名单，限制访问实例的私网 IP 地址。

注意事项

配置 IP 白名单时，支持配置为单个 IP 地址或 IP 网段的形式，配置时注意格式要求：

IP 地址格式：必须是有效的 IPv4 地址，由四个 0~255 的整数组成，用英文句号（.）分隔。

CIDR 网段：应为标准格式，IP 和掩码要对应。

IP 地址部分必须是网络地址，即子网中的第一个地址；所有主机位必须为零。

网络前缀长度范围为0~32。/0是有效的，表示整个 IPv4 地址空间（0.0.0.0/0）；/32表示单个主机地址。

不得使用保留的 IP 范围，如回环地址 127.0.0.0/8。

不得配置为 0.0.0.0/x。

有效 CIDR 表示的例子	无效 CIDR 表示的例子
192.168.0.0/24：正确的 C 类网络地址； 10.0.0.0/8：正确的 A 类网络地址； 172.16.0.0/12：正确的 B 类网络地址。	192.168.1.1/24：不是网络地址（最后一个八位字节不是 0）； 192.168.0.0/33：无效的前缀长度（超过 32）； 256.0.0.0/24：无效的 IP 地址（第一个八位字节超过 255）； 192.168.01.0/24：格式错误（第三个八位字节有前导零）。

操作步骤

登录云搜索服务控制台。

在顶部导航栏，选择目标项目和地域。

在实例列表页面，单击目标实例名称。

在左侧导航栏选择基本信息，然后在服务访问区域单击实例私网访问地址后的 IP 白名单配置。

在 IP 白名单配置对话框，添加需要继续访问实例的私网 IP 地址，然后单击确定。

说明

您在配置 IP 白名单时，需要了解以下事项：

所有分组一共最多支持上传 300 个 IP 地址或 IP 网段。

127.0.0.1 代表禁止所有 IPv4 地址访问，0.0.0.0/0 代表允许所有 IPv4 地址访问。

从安全角度不建议您配置允许所有 IP 地址访问。

使用 CIDR 网段时，应为标准格式，IP 和掩码要对应。详细格式要求，请参见注意事项。

例如 192.168.0.0/16，如果输入 192.168.1.0/16 则不正确。

查看实例配置 IP 白名单进度。

返回实例列表页面，实例状态显示为更新中。当状态显示为运行中，则表示配置 IP 白名单成功，此时只有添加到白名单中的 IP 地址才可以访问实例。

最近更新时间：2026.03.25 17:29:45

这个页面对您有帮助吗？

有用

有用

无用

无用