Todos los productos
Search

Este producto

    Container Registry:Configurar el control de acceso VPC

    Centro de documentos

    Container Registry:Configurar el control de acceso VPC

    Última actualización: Sep 21, 2026

    Para acceder a una instancia de ACR Enterprise Edition desde una VPC, configure el control de acceso VPC. Esto establece la conectividad de red entre la VPC y la instancia.

    Requisitos previos

    Alibaba Cloud DNS PrivateZone es obligatorio para la resolución de nombres de dominio de la VPC. Si no necesita acceso por VPC, use directamente el endpoint público sin configurar el control de acceso VPC ni activar PrivateZone.

    Cómo funciona el control de acceso VPC

    La conexión de una VPC a una instancia de Enterprise Edition ocupa una dirección IP dentro de la VPC. ACR utiliza Alibaba Cloud DNS PrivateZone para resolver automáticamente el nombre de dominio de la VPC de la instancia hacia esta dirección IP. No se requiere ninguna configuración manual.

    Nota

    El control de acceso se configura a nivel de VPC. Seleccione cualquier vSwitch que tenga direcciones IP disponibles. Una vez configurado, todos los recursos de la VPC pueden acceder a la instancia mediante su nombre de dominio de VPC.

    Al configurar el control de acceso VPC, se crea automáticamente un rol vinculado al servicio llamado AliyunServiceRoleForContainerRegistryAccessCustomerPrivateZone para la resolución de nombres de dominio a través de Alibaba Cloud DNS PrivateZone. Para obtener más información, consulte Service-linked role for Alibaba Cloud DNS PrivateZone.

    Aviso

    No modifique la zona DNS que se crea automáticamente en Alibaba Cloud DNS PrivateZone. De lo contrario, operaciones como extraer o eliminar imágenes podrían fallar.

    Agregar una VPC

    Nota

    La cuota de control de acceso VPC debe comprarse por separado. Es posible que la cuota inicial sea 0. Si la cuota es insuficiente o aparece un error de cuota excedida al agregar una VPC, consulte las preguntas frecuentes. Para conocer los detalles de cuotas y precios, consulte Billing of Enterprise Edition instances.

    1. Inicie sesión en la consola de Container Registry.

    2. En la barra de navegación superior, seleccione una región.

    3. En el panel de navegación izquierdo, haga clic en Instances.

    4. En la página Instances, haga clic en la instancia de Enterprise Edition que desea gestionar.

    5. En la página de gestión de la instancia, dentro del panel de navegación izquierdo, elija Repository > Access Control.

      Nota

      Para configurar el control de acceso de un Helm chart, elija Helm Chart > Access Control.

    6. En la pestaña VPC, haga clic en.

    7. En el cuadro de diálogo Add VPC , seleccione una VPC y un vSwitch; después, haga clic en Confirm.

      Nota

      Solo es necesario vincular un vSwitch. Después de vincularlo, todas las instancias ECS de la VPC pueden acceder a la instancia de Enterprise Edition.

      La VPC se agrega cuando su estado cambia de Creating a Running.

    8. Opcional: Consulte la zona DNS en Alibaba Cloud DNS PrivateZone.

      Después de agregar la VPC, ACR crea automáticamente una zona DNS en Alibaba Cloud DNS PrivateZone. Esta zona DNS se puede consultar en la consola de PrivateZone.

      1. Inicie sesión en la consola de Alibaba Cloud DNS.

      2. En el panel de navegación izquierdo, elija Configurations > Private Zone.

        En la pestaña User Defined Zones, consulte la zona DNS.

    Preguntas frecuentes

    ¿Por qué no puedo hacer ping a la instancia de ACR Enterprise Edition ni resolver DNS dentro de la misma VPC?

    La instancia de Enterprise Edition no está vinculada a la VPC en la consola de ACR. Sin este vínculo, Alibaba Cloud DNS PrivateZone no crea la zona DNS correspondiente. Por lo tanto, los recursos de la VPC no pueden resolver el nombre de dominio de VPC de la instancia.

    Para solucionar este problema, siga los pasos de la sección Agregar una VPC y vincule la VPC y el vSwitch de destino a la instancia de Enterprise Edition. Cuando el estado de la VPC cambie a Running, la resolución DNS y el acceso dentro de la VPC funcionarán con normalidad.

    ¿Qué debo hacer si aparecen los errores "Image address must be a VPC endpoint" o "Get EOF" al enviar o extraer imágenes a través de una VPC?

    Dependiendo del mensaje de error, aplique una de las siguientes soluciones:

    1. Error "Image address must be a VPC endpoint": se utilizó una dirección de endpoint de VPC en un entorno que no es VPC, o bien se usó una dirección de endpoint público dentro de una VPC. Compruebe el entorno de red y utilice el formato de endpoint correcto:

      • Dentro de una VPC: use una dirección con el formato *-registry-vpc.{region-id}.cr.aliyuncs.com.

      • A través de una red pública: use una dirección con el formato *-registry.{region-id}.cr.aliyuncs.com.

    2. Error "Get EOF" al enviar imágenes: el cliente no se encuentra en la red de la VPC vinculada o la conexión de red no está disponible. Confirme que el cliente se ejecuta en la VPC vinculada a la instancia de ACR Enterprise Edition. Si es necesario, cambie a la dirección del endpoint público.

    ¿Qué debo hacer si la cuota de VPC es 0 o aparece un error de cuota excedida al agregar una VPC?

    La cuota de control de acceso VPC debe comprarse por separado. Es posible que la cuota inicial sea 0. Si no necesita acceso desde una VPC, no se requiere ninguna configuración ni se generan cargos adicionales. Si necesita extraer imágenes desde una VPC (por ejemplo, desde instancias ECS o clústeres de ACK), compre la cuota antes de vincular la VPC. Para conocer los detalles de cuotas y precios, consulte Billing of Enterprise Edition instances.

    Si aparece un error de cuota excedida al agregar una VPC, siga estos pasos para aumentarla:

    1. Inicie sesión en la consola de VPC y compruebe el uso de la cuota.

    2. En la página de gestión de cuotas, haga clic en Upgrade para comprar cuota adicional de VPC.

    3. Una vez completada la compra, borre la caché del navegador y espere a que la nueva cuota surta efecto.

    4. Regrese a la instancia de Enterprise Edition, vaya a la página Access Control y haga clic en Add VPC.

    Documentos relacionados

    Para acceder a una instancia de Enterprise Edition desde otra región o desde instalaciones locales en un entorno de VPC, consulte Access an Enterprise Edition instance across regions or from an on-premises data center.

    Si surgen problemas durante la configuración del control de acceso VPC, como conectividad con errores entre la VPC y la instancia, errores de resolución DNS o códigos de error de PrivateZone, consulte VPC access control troubleshooting.