Todos los productos
Search
Centro de documentos

PolarDB:Configuración de listas blancas para un clúster

Última actualización: Oct 11, 2026

Las listas blancas de IP controlan qué direcciones IP o security groups pueden acceder a un clúster de PolarDB for MySQL. Después de crear un clúster, debe agregar las direcciones IP de su entorno local o de sus instancias ECS a la lista blanca del clúster para poder acceder a él.

Precauciones

  • PolarDB no admite obtener automáticamente las direcciones IP privadas de las instancias ECS en VPCs. Debe introducir manualmente en la lista blanca la dirección IP privada de la instancia ECS que necesita acceder al clúster de PolarDB for MySQL.

  • Es posible configurar tanto listas blancas de IP como security groups. Las instancias ECS incluidas en la lista blanca de IP y las que pertenecen al security group pueden acceder al clúster de PolarDB for MySQL.

  • Los grupos ali_dms_group (lista blanca de IP para DMS), hdm_security_ips (lista blanca de IP para DAS) y dtspolardb (lista blanca de IP para DTS) se generan automáticamente cuando utiliza los servicios relacionados. No modifique ni elimine estos grupos para evitar afectar el uso de dichos servicios.

    Importante

    No agregue las direcciones IP de su negocio a estos grupos. De lo contrario, podrían sobrescribirse cuando se actualicen los servicios relacionados, lo cual afectaría las operaciones normales del negocio.

    Whitelists

  • Puede crear hasta 50 grupos de listas blancas de IP. Todos los grupos admiten un total acumulado de 1,000 direcciones IP o bloques CIDR.

Escenarios

Las listas blancas de IP controlan qué direcciones IP o security groups pueden acceder a un clúster de PolarDB for MySQL. Configurar estas listas proporciona un alto nivel de seguridad de acceso para su clúster de PolarDB for MySQL. Se recomienda mantener las listas blancas de forma periódica. A continuación se describen escenarios comunes donde es necesario configurar listas blancas de IP:

  • Si su instancia ECS necesita acceder a un clúster de PolarDB for MySQL, consulte la dirección IP de la instancia ECS en la página Instance Details y agréguela a la lista blanca de IP.

    Nota
    • Si la instancia ECS y el clúster de PolarDB for MySQL están en la misma VPC, introduzca la dirección IP privada de la instancia ECS o el bloque CIDR de la VPC.

    • Si la instancia ECS y el clúster de PolarDB for MySQL no están en la misma VPC, introduzca la dirección IP pública de la instancia ECS o agregue el security group al que pertenece dicha instancia. También puede migrar la instancia ECS a la VPC donde reside el clúster de PolarDB for MySQL y, después, introducir la dirección IP privada de la instancia ECS o el bloque CIDR de la VPC.

  • Si sus servidores locales, computadoras u otros servidores en la nube necesitan acceder a un clúster de PolarDB, agregue sus direcciones IP públicas a la lista blanca de IP.

Configuración de listas blancas de IP

  1. Inicie sesión en la consola de PolarDB. En el panel de navegación izquierdo, haga clic en Clusters. Seleccione la Region donde se desplegó el clúster y, a continuación, haga clic en el ID del clúster para ir a la página de detalles del clúster.

  2. En el panel de navegación izquierdo, elija Settings and Management > Cluster Whitelists.

  3. En la página Cluster Whitelists, puede usar Add IP Whitelist o Modify un grupo de listas blancas existente.

    • Agregar un grupo de listas blancas de IP:

      Haga clic en Add IP Whitelist. En el cuadro de diálogo Add IP Whitelist, introduzca el nombre del grupo y las direcciones IP con permiso para acceder al clúster.

    • Configurar un grupo de listas blancas de IP:

      Haga clic en Modify a la derecha del nombre del grupo de listas blancas de IP de destino. En el cuadro de diálogo Modify Whitelist, introduzca las direcciones IP con permiso para acceder al clúster.

    Nota
    • El nombre del grupo de listas blancas de IP debe cumplir los siguientes requisitos:

      • Puede contener letras minúsculas, dígitos y guiones bajos (_).

      • Debe comenzar con una letra y terminar con una letra o un dígito.

      • Debe tener entre 2 y 120 caracteres de longitud.

    • Para las direcciones IP en la lista blanca:

      • Puede introducir una dirección IP (por ejemplo, 192.168.0.1) o un bloque CIDR (por ejemplo, 192.168.0.0/24).

      • Cuando los pods de un clúster de Kubernetes (como ACK) acceden al clúster, las direcciones IP de los pods cambian al recrearse los contenedores. Configure el bloque CIDR al que pertenecen las direcciones IP de los pods en lugar de una sola dirección IP de pod. Por ejemplo, si las direcciones IP de los pods están en el rango 172.19.34.x, configure 172.19.34.0/24. Si no tiene certeza sobre el bloque CIDR, configure 172.19.0.0/16. También puede asociar un security group. Las instancias ECS del security group se agregan automáticamente a la lista blanca.

      • Separe varias direcciones IP con comas (,), por ejemplo, 192.168.0.1,192.168.0.0/24.

      • 127.0.0.1 indica que ninguna dirección IP tiene permiso para acceder al clúster.

      • 0.0.0.0/0 indica que cualquier dirección IP puede acceder al clúster de base de datos. Esta configuración reduce significativamente la seguridad de la base de datos. No la utilice a menos que sea necesario.

    • Cada clúster incluye un grupo de listas blancas de IP predeterminado llamado default que contiene la dirección IP 127.0.0.1, lo cual significa que ninguna dirección IP puede acceder al clúster.

Preguntas frecuentes

Una instancia ECS no puede conectarse a un clúster de **PolarDB**

Resuelva el problema de la siguiente manera:

  1. Compruebe si el clúster de PolarDB está en estado running.

  2. Compruebe que el endpoint de la base de datos, el puerto, la cuenta y la contraseña sean correctos. Obtain the database endpoint and port.

  3. Pruebe la conectividad de red desde la instancia ECS mediante ping <database endpoint> o telnet <database endpoint> <port>.

    1. Si utiliza un endpoint de private network:

      1. Compruebe si la instancia ECS y el clúster de PolarDB están en la misma VPC. Si no están en la misma VPC, no podrá utilizar el endpoint de private network. Use una de las siguientes soluciones para colocar la instancia ECS y el clúster de PolarDB en la misma VPC:

      2. Compruebe si la dirección IP privada, el rango de direcciones IP o el security group de la instancia ECS se agregó a cluster whitelist.

    2. Si utiliza un endpoint de public network, compruebe si la dirección IP pública o el security group de la instancia ECS se agregó a cluster whitelist.

Nota

Los hosts virtuales y los servidores de aplicaciones simples no pueden conectarse a PolarDB mediante un endpoint de private network.

Un entorno local no puede conectarse a un clúster de **PolarDB**

Resuelva el problema de la siguiente manera:

  1. Compruebe si el clúster de PolarDB está en estado running.

  2. Compruebe que el endpoint de la base de datos, el puerto, la cuenta y la contraseña sean correctos. Obtain the database endpoint and port.

    Nota

    El endpoint de la base de datos debe ser un endpoint de public network. Si utiliza una instancia ECS que está en la misma VPC que el clúster de PolarDB, puede usar un endpoint de private network.

  3. Pruebe la conectividad de red desde su entorno local mediante ping <database endpoint> o telnet <database endpoint> <port>.

  4. Compruebe si la dirección IP pública o el rango de direcciones IP de su entorno local se agregó a cluster whitelist.

    Obtenga su dirección IP pública:

    • Sistema operativo Linux: abra la terminal y ejecute el comando curl ifconfig.me.

    • Sistema operativo Windows: abra el símbolo del sistema y ejecute el comando curl ip.me.

    • Sistema operativo macOS: abra la terminal y ejecute el comando curl ifconfig.me.

    Si su entorno de red local utiliza un servidor proxy o tiene otras configuraciones similares, es posible que la dirección IP obtenida con los métodos anteriores no sea su dirección IP pública real. Puede agregar el rango de direcciones IP 0.0.0.0/0 a la lista blanca del clúster de PolarDB. Una vez que se conecte correctamente al clúster, ejecute el comando SHOW PROCESSLIST; para obtener la dirección IP pública real y agréguela a la lista blanca del clúster. Después, quite el rango de direcciones IP 0.0.0.0/0 de la lista blanca.

    image

No es posible conectarse a un clúster de PolarDB y aparece el error "Can't connect to MySQL server on 'xxx'" o "Connection timed out"

Es probable que la dirección IP pública o el rango de direcciones IP de su entorno no esté en la lista blanca del clúster de PolarDB, o bien que la dirección IP introducida sea incorrecta.

Obtenga su dirección IP pública:

  • Sistema operativo Linux: abra la terminal y ejecute el comando curl ifconfig.me.

  • Sistema operativo Windows: abra el símbolo del sistema y ejecute el comando curl ip.me.

  • Sistema operativo macOS: abra la terminal y ejecute el comando curl ifconfig.me.

Si su entorno de red local utiliza un servidor proxy o tiene otras configuraciones similares, es posible que la dirección IP obtenida con los métodos anteriores no sea su dirección IP pública real. Puede agregar el rango de direcciones IP 0.0.0.0/0 a la lista blanca del clúster de PolarDB. Una vez que se conecte correctamente al clúster, ejecute el comando SHOW PROCESSLIST; para obtener la dirección IP pública real y agréguela a la lista blanca del clúster. Después, quite el rango de direcciones IP 0.0.0.0/0 de la lista blanca.

image

Después de quitar una dirección IP de una lista blanca, ¿se desconectan las conexiones existentes?

No. La lista blanca solo se comprueba cuando se establece una conexión nueva. Después de quitar una dirección IP, las conexiones existentes no se ven afectadas, pero las nuevas conexiones se bloquean. Para desconectar las conexiones existentes, finalice las sesiones manualmente.

¿Cómo soluciono problemas de conexiones desde direcciones IP desconocidas?

Si detecta conexiones desde direcciones IP desconocidas, siga estos pasos para identificar el origen de la IP:

  1. Inicie sesión en la consola de PolarDB, vaya a la página de detalles del clúster y elija Settings and Management>Cluster Whitelists.

  2. Revise cada grupo de listas blancas en la lista de IP para buscar direcciones IP desconocidas o una entrada 0.0.0.0/0. 0.0.0.0/0 indica que cualquier dirección IP puede acceder al clúster de base de datos. Esta configuración reduce significativamente la seguridad de la base de datos. No la utilice a menos que sea necesario.

  3. hdm_security_ips (lista blanca de IP para DAS), ali_dms_group (lista blanca de IP para DMS) y otros grupos del sistema contienen direcciones IP de los servicios internos de monitoreo y comprobación de estado de Alibaba Cloud. Este comportamiento es normal.

  4. Confirme el origen de la dirección IP desconocida antes de tomar medidas. Eliminar por accidente las direcciones IP de los grupos del sistema puede provocar que el monitoreo y otras funciones de los servicios relacionados fallen.

Para obtener más información sobre problemas con las listas blancas de IP, consulte Troubleshoot IP whitelist issues.

Referencias

  • Set up a global IP whitelist template: una plantilla global de lista blanca de IP le permite mantener un único conjunto de plantillas de listas blancas de IP que se aplican dinámicamente a todos los clústeres de PolarDB asociados.

  • Configure a security group: después de agregar un security group, las instancias ECS que contiene se añaden automáticamente a la lista blanca del clúster de PolarDB y se mantienen actualizadas. Esto elimina la necesidad de actualizar manualmente la lista blanca del clúster de PolarDB tras agregar nuevas instancias ECS.

Operaciones de API relacionadas

API

Descripción

DescribeDBClusterAccessWhitelist

Consulta las direcciones IP con permiso para acceder a un clúster de PolarDB for MySQL específico.

ModifyDBClusterAccessWhitelist

Modifica las direcciones IP con permiso para acceder a un clúster de PolarDB for MySQL específico.