全部產品
Search
文件中心

API Gateway:管理外掛程式

更新時間:Sep 26, 2025

AI 網關提供了外掛程式市場,內建認證鑒權、流量管控、安全防護等多種功能擴充外掛程式,支援您上傳自訂外掛程式,可以對網關進行靈活、個人化的能力擴充。本文主要介紹如何安裝、啟用、卸載外掛程式。

外掛程式介紹

AI 網關外掛程式市場中的外掛程式,依據外掛程式來源,主要分為以下三類:

  • 官方外掛程式:Higress官方開放到外掛程式市場的外掛程式。

  • 社區外掛程式:Higress社區貢獻到外掛程式市場的外掛程式。

  • 自訂外掛程式:使用者上傳到外掛程式市場的外掛程式,僅供使用者自身使用。

安裝並啟用外掛程式

安裝外掛程式是指將AI網關外掛程式市場中的外掛程式安裝到具體的網關執行個體的過程,任何外掛程式要在網關執行個體上生效,必須先安裝外掛程式、然後配置規則,最後啟用外掛程式。

外掛程式規則根據範圍分為以下三類:

  • MCP/路由級外掛程式規則:作用在路由上,當請求匹配到指定路由時,規則生效。

  • 網域名稱級外掛程式規則:作用在網域名稱上,特定網域名稱的匹配優先順序高於泛網域名稱。

  • 執行個體級外掛程式規則:作用在網關全域,當路由和網域名稱級規則都沒有匹配到的時候則匹配該規則。

AI 網關提供如下兩種方式安裝外掛程式:

說明
  • 僅專享執行個體型AI網關支援安裝與啟用外掛程式,Serverless版不支援。

方式一:在外掛程式市場安裝

  1. 登入AI網關控制台

  2. 在左側導覽列,選擇外掛程式,並在頂部功能表列選擇地區。

  3. 外掛程式市場頁面的快捷導航欄處,選擇外掛程式類型或者搜尋外掛程式名稱,單擊外掛程式卡片上的安裝,在彈出的安裝外掛程式框中選擇需要使用此外掛程式的網關執行個體,單擊確定

  4. 配置欄中,單擊目標網關執行個體操作列下的規則配置,在規則配置頁面選擇生效範圍

    • 當選擇MCP/路由級外掛程式規則網域名稱級外掛程式規則時,單擊添加規則,在添加MCP/路由層級規則添加網域名稱層級規則頁面,開啟啟用狀態(預設開啟),選擇生效目標並配置外掛程式規則,單擊確定

    • 當選擇執行個體級外掛程式規則時,開啟啟用狀態並配置外掛程式規則,單擊儲存

方式二:在網關執行個體頁面安裝

  1. 登入AI網關控制台

  2. 在左側導覽列,選擇執行個體,並在頂部功能表列選擇地區。

  3. 執行個體頁面,單擊目標執行個體ID

  4. 在左側導覽列,選擇外掛程式,並在頂部功能表列選擇地區。

  5. 單擊安裝外掛程式,在安裝外掛程式頁面的快捷導航處,選擇要安裝的外掛程式類型或者搜尋外掛程式名稱,單擊外掛程式卡片,在彈出的安裝外掛程式框中,單擊安裝並配置

  6. 在彈框規則配置頁面,為所選外掛程式配置規則並選擇生效範圍。單擊確定。

  7. (可選)您可通過網關執行個體頁面,在左側導覽列選擇外掛程式,單擊外掛程式列表操作列中的規則配置,為所選外掛程式配置規則並選擇生效範圍。

    • 當選擇MCP/路由級外掛程式規則網域名稱級外掛程式規則時,單擊添加規則,在添加MCP/路由層級規則添加網域名稱層級規則頁面,開啟啟用狀態(預設開啟),選擇生效目標並配置外掛程式規則,單擊確定

    • 當選擇執行個體級外掛程式規則時,開啟啟用狀態並配置外掛程式規則,單擊儲存

卸載外掛程式

使用背景

當您想要將外掛程式徹底從網關上刪除時,您可以選擇卸載外掛程式。AI 網關提供了如下兩種方式卸載外掛程式:

重要

卸載外掛程式時,如果存在啟用的外掛程式規則,請先停用外掛程式再卸載;如果外掛程式未啟用,卸載外掛程式會將配置的外掛程式規則一併刪除。

方式一:在外掛程式市場卸載

  1. 登入AI網關控制台

  2. 在左側導覽列,選擇外掛程式,並在頂部功能表列選擇地區。

  3. 外掛程式頁面的快捷導航欄處,選擇外掛程式類型或者搜尋外掛程式名稱,單擊要卸載的外掛程式卡片。

  4. 單擊配置欄,在要卸載此外掛程式的網關執行個體操作欄中,單擊卸載

  5. 在彈出框中,點擊確定按鈕,頁面提示卸載外掛程式成功。

方式二:在網關執行個體頁面卸載

  1. 登入AI網關控制台

  2. 在左側導覽列,選擇執行個體,並在頂部功能表列選擇地區。

  3. 執行個體頁面,單擊目標執行個體ID

  4. 在左側導覽列,選擇外掛程式,並在頂部功能表列選擇地區。

  5. 在外掛程式列表中,單擊所要卸載外掛程式操作列中的卸載

  6. 在彈出框中單擊確定按鈕,頁面提示卸載外掛程式成功。