All Products
Search
Document Center

PolarDB:Configure a whitelist

Last Updated:Mar 30, 2026

An IP address whitelist controls which IP addresses can connect to your PolarDB-X 1.0 instance. Configure a whitelist to grant access only to trusted IP addresses.

Prerequisites

Before you begin, ensure that you have:

  • A PolarDB-X 1.0 instance

  • The IP addresses or CIDR blocks of the clients that need access

Configure the whitelist

  1. Log on to the PolarDB for Xscale console.

  2. In the top navigation bar, select the region where your instance is located.

  3. In the left-side navigation pane, click Instances.

  4. Find the target instance and click its ID.

  5. In the left-side navigation pane, choose Configuration and Management > Whitelist Settings.

  6. Select the whitelist group to update and click Edit. In the dialog box, enter the IP addresses to allow.

  7. Click OK.

Supported IP formats and limits

Format Example
Single IP address 192.168.0.1
CIDR block 192.168.0.0/24
Wildcard range 192.168.10.*
IP range 192.168.10.2-192.168.10.30
  • Each whitelist group supports up to 300 IP addresses or CIDR blocks.

  • Separate multiple entries with commas (,). For example: 192.168.0.1,192.168.0.0/24.

  • The IP address 0.0.0.0 is not supported.

FAQ

Why can IP addresses outside the whitelist still access my instance?

Check whether the whitelist contains *.*.*.* or is left blank. Either condition allows all IP addresses to connect to the instance. Remove the open entry and add only the specific IP addresses you trust.

My IP address changes frequently. How should I configure the whitelist?

Use a CIDR block that covers the expected IP range instead of a single IP address. For example, 203.0.113.0/24 covers 256 addresses.