概述

本文介绍插件的安装、绑定、配置修改、启用/禁用与卸载操作。

安装到实例

1. 点击插件卡片的 安装 将插件安装到实例，或点击插件卡片的 配置 ，进入配置页将插件安装到实例。
2. 选择目标实例（可多选）。
3. 完成安装，插件对实例的全部流量生效。

绑定到 API

1. 点击插件卡片的 点击 配置 进入配置页，找到对应实例 或 找到对应实例，进入「实例详情 」>「插件管理」，找到对应插件
2. 在操作列中，点击 规则配置。
3. 在 规则配置 抽屉中，选择API级别插件规则，点击 添加规则
4. 在 添加API级别规则 抽屉中，选择要绑定的API，完成插件规则配置
5. 完成安装，插件对当前API的流量生效

说明：API 级别规则可按基础 API、Model API、Agent API 分别选择目标 API。

绑定到域名

跨域、请求响应转换等传输协议类插件支持按域名生效，适用于同一域名下全部 API 需要统一策略的场景。

1. 点击插件卡片的 配置 进入配置页。
2. 选择域名级别插件规则，点击 添加规则。
3. 选择目标域名并完成插件规则配置，保存后对该域名的全部流量生效。

实例规则配置

1. 点击插件卡片的 点击 配置 进入配置页，找到对应实例 或 在实例管理中找到对应实例，进入「实例详情 」>「插件管理」，找到对应插件。
2. 在操作列中，点击 规则配置。
3. 在 规则配置 抽屉中，选择实例级插件规则，完成插件规则配置
4. 保存后热更新生效，不影响在线流量。

查看已绑定的插件

• 实例级：实例详情的 插件管理 列表展示安装在该实例上的插件，含插件类型与插件来源信息。
• API 级：API 详情的请求链路图在「策略与插件」节点中按序展示作用在该 API 上的策略与插件，并标注「策略」「系统插件」「自定义插件」标签。

启用与禁用

插件规则支持一键 启用 或 禁用：

• 禁用后插件规则不再执行，但保留配置，便于临时排查问题或快速恢复。
• 启用后立即恢复执行。

卸载插件

对不再使用的插件绑定执行 卸载（删除绑定），卸载后该级别的插件逻辑立即停止执行。

注意：

• 卸载认证、限流类插件会立即放开对应的防护能力，请评估安全风险后操作。
• API 侧无法卸载继承自实例的插件，卸载按钮为禁用状态并提示「无法卸载实例插件，如需卸载，请前往实例详情的插件管理进行操作」。