Todos los productos
Search

Este producto

    API Gateway:Gestionar plugins

    Centro de documentos

    API Gateway:Gestionar plugins

    Última actualización: Sep 03, 2026

    Cloud-native API Gateway ofrece plugins integrados para autenticación, control de tráfico y protección de seguridad. También admite plugins personalizados para extender la funcionalidad del gateway de forma flexible. Puede instalar, habilitar, desinstalar y gestionar versiones de plugins, lo que incluye actualizaciones continuas, mejoras y reversiones sin interrupciones.

    Introducción a los plugins

    Los plugins de Cloud-native API Gateway se clasifican en tres categorías según su origen:

    • Plugins oficiales: Plugins publicados por el equipo de Higress.

    • Plugins de la comunidad: Plugins aportados por la comunidad de Higress.

    • Plugins personalizados: Plugins que los usuarios cargan para su propio uso.

    Instalar y habilitar un plugin

    Para usar un plugin, selecciónelo en la consola de Cloud-native API Gateway e instálelo en una instancia de gateway. Un plugin solo surte efecto después de instalarlo, configurar sus reglas y habilitarlo. Puede instalar plugins de dos maneras:

    Nota

    • MCP/Route Level Plugin Rules: Estas reglas se aplican a las rutas y surten efecto cuando una solicitud coincide con una ruta específica.

    • Domain-level plug-in rules: Estas reglas se aplican a nombres de dominio. Las reglas para nombres de dominio específicos tienen mayor prioridad que las reglas para nombres de dominio con comodines.

    • Instance-level plug-in rules: Estas reglas se aplican globalmente al gateway y se evalúan cuando no coinciden reglas a nivel de ruta ni de dominio.

    Método 1: Instalar desde fuera de una instancia de gateway

    1. Vaya a la página Plugins en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. En la página Plug-in, dentro del panel Quick Navigation, seleccione un tipo de plugin o busque uno por nombre. Haga clic en Install failed. en la tarjeta del plugin correspondiente. En el cuadro de diálogo Install Plug-in, seleccione la instancia de gateway para el plugin y luego haga clic en OK.

    3. En la sección Configuration, localice la instancia de gateway deseada y haga clic en Rule Configuration en la columna Actions. En la página de configuración de reglas, seleccione un Effective Scope.

      • Si selecciona MCP/Route Level Plugin Rules o Domain-level plug-in rules, haga clic en Add Rule. En la página Add Routing Level Rule o Add Domain Level Rule, active Status (habilitado de forma predeterminada). Seleccione un Target, configure las Plug-in Rules y luego haga clic en OK.

      • Si selecciona Instance-level plug-in rules, habilite Status (habilitado de forma predeterminada), configure las Plug-in Rules y luego haga clic en Save.

    Método 2: Instalar desde una instancia de gateway

    1. Vaya a la página Instances en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. Vaya a la página de detalles de la instancia deseada. En el panel de navegación izquierdo, seleccione Plug-in.

    3. Haga clic en Install Plug-in. En la página Install Plugin, utilice el panel Quick Navigation para seleccionar un tipo de plugin o buscar uno por nombre. Haga clic en la tarjeta del plugin y luego en Install and Configure dentro del cuadro de diálogo que aparece.

    4. En el cuadro de diálogo Rule Configuration, configure las reglas del plugin seleccionado, elija un ámbito de aplicación y haga clic en OK.

    5. (Opcional) En la página de la instancia de gateway, seleccione Plug-in en el panel de navegación izquierdo. En la lista de plugins, localice el plugin deseado y haga clic en Rule Configuration en la columna Actions. A continuación, configure las reglas y seleccione un ámbito de aplicación.

      • Si selecciona MCP/Route Level Plugin Rules o Domain-level plug-in rules, haga clic en Add Rule. En la página Add Routing Level Rule o Add Domain Level Rule, active Status (habilitado de forma predeterminada), seleccione un Target, configure las Plug-in Rules y haga clic en OK.

      • Si selecciona Instance-level plug-in rules, active Status (habilitado de forma predeterminada), configure las Plug-in Rules y haga clic en Save.

    Desinstalar un plugin

    Contexto

    Al desinstalar un plugin, este se elimina por completo del gateway. Puede desinstalar plugins de dos maneras.

    Importante

    Antes de desinstalar un plugin, deshabilite todas las reglas activas del mismo. Si un plugin no está habilitado, al desinstalarlo también se eliminan todas las reglas configuradas.

    Método 1: Desinstalar desde fuera de una instancia de gateway

    1. Vaya a la página Plugins en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. En la página Plug-in, dentro del panel Quick Navigation, seleccione un tipo de plugin o busque uno por nombre. Haga clic en la tarjeta del plugin que desea desinstalar.

    3. Haga clic en la pestaña Configuration. Localice la instancia de gateway de la cual desea desinstalar el plugin y haga clic en Uninstall en la columna Actions.

    4. En el cuadro de diálogo que aparece, haga clic en el botón OK. Un mensaje confirmará que el plugin se desinstaló correctamente.

    Método 2: Desinstalar desde una instancia de gateway

    1. Vaya a la página Instances en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. Vaya a la página de detalles de la instancia deseada y, en el panel de navegación izquierdo, seleccione Plug-in.

    3. En la lista de plugins, localice el que desea desinstalar y haga clic en Uninstall en la columna Actions.

    4. En el cuadro de diálogo que aparece, haga clic en el botón OK. Un mensaje confirmará que el plugin se desinstaló correctamente.

    Agregar una versión a un plugin personalizado

    Importante

    No es posible agregar versiones a plugins personalizados de Lua.

    Agregar una versión crea un nuevo registro de versión por cada modificación realizada en un plugin personalizado, lo que facilita el seguimiento de cambios y el control de lanzamientos. Siga estos pasos:

    1. Vaya a la página Plugins en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. En la página Plug-in, dentro del panel Quick Navigation, establezca Plug-in Type en Custom o busque un plugin por nombre. Haga clic en Add Version en la tarjeta del plugin. En el panel Add Version, configure la Version Information:

      • Version: Introduzca el número de versión del plugin. El número de versión debe cumplir con la especificación de versionado semántico (semver), como 1.0.1.

      • Version Description: Una breve descripción de las funciones y cambios en esta versión, como Added rate limiting feature.

      • WASM File: El archivo compilado .wasm que ejecuta la lógica del plugin en el gateway.

      • Execution Stage: Seleccione la fase del flujo de procesamiento de solicitudes en la que se ejecuta el plugin, como Default Phase.

      • Execution Priority: Introduzca un número para especificar el orden de ejecución del plugin. Un número mayor indica una prioridad más alta.

      • Adapt to Gateway Version: Introduzca el número de versión del motor del gateway con el que este plugin es compatible. Esto garantiza que el plugin se ejecute correctamente.

        Nota

        Esta es la versión mínima del gateway en la que se puede instalar este plugin.

    Cambios de versión de plugins

    Importante

    Para garantizar una actualización sin problemas, asegúrese de que la nueva versión sea compatible con la configuración de reglas de la versión original.

    1. Vaya a la página Instances en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. Vaya a la página de detalles de la instancia deseada. En el panel de navegación izquierdo, seleccione Plug-in.

    3. En la lista de plugins, localice el plugin deseado. Luego, haga clic en Version Change en la columna Actions.

    4. En el cuadro de diálogo Version Change, seleccione la versión deseada y luego haga clic en OK.

    Eliminar una versión

    1. Vaya a la página Plugins en la consola de Cloud-native API Gateway. En la barra de menú superior, seleccione una región.

    2. En la página Plug-in, localice un plugin estableciendo Plug-in Type en Custom dentro del panel Quick Navigation o buscando el plugin por nombre. Pase el cursor sobre el icono image en la tarjeta del plugin.

    3. Luego haga clic en Deleted.. En el cuadro de diálogo que aparece, seleccione la versión que desea eliminar y haga clic en OK.