规则
规则在帽子云网关上处理进入应用的 HTTP 请求。你可以按请求的域名、路径、方法、来源国家、参数等条件匹配请求，然后转发、改写请求头/响应头，或返回重定向，无需修改应用代码。
静态网站、Web 应用都可以使用规则。入口：应用详情页 → 规则。
规则类型
| 类型 | 作用 | 典型场景 | 文档 |
|---|---|---|---|
| 反向代理规则 | 按匹配条件转发请求到上游节点 | /api 转发到后端服务器；接入第三方服务 | 反向代理规则 |
| 请求头重写 | 在转发前设置、增加或删除请求头 | 给上游传递标识、去掉敏感头 | 请求头重写 |
| 响应头重写 | 在返回前设置、增加或删除响应头 | 跨域 CORS、缓存控制、安全头 | 响应头重写 |
| 重定向规则 | 命中后返回 HTTP 重定向到目标地址 | 旧域名跳新域名、旧链接跳新链接 | 重定向规则 |
左侧选择类型后，右侧列出该类型的所有规则（共 N 条），右上角按钮用于添加该类型的规则。
通用字段
每条规则都包含：
- 规则名称：必填，1 ~ 30 个字符，例如"API 转发"。
- 匹配规则：
- 匹配所有请求：对所有请求生效。
- 自定义筛选：只对满足条件的请求生效，条件配置见下文。
- 规则配置：不同类型的具体配置。
匹配条件
选择 自定义筛选 后，每一行是一个条件，由 匹配字段、运算符 和 值 组成。参数类字段还需要填写 参数值（参数名）。
条件组合
- 行右侧的 ⊕ 在同一组内增加条件，⊖ 删除条件。同一组内的条件需要同时满足（且）。
- 点击 或者 新增一个条件组。多个组之间满足任意一组即可（或）。
例如：组 1 为"请求路径 开头是 /api"且"请求方法 等于 POST"，组 2 为"主机名 等于 api.example.com"。请求满足组 1 或组 2 都会命中。
匹配字段与运算符
| 匹配字段 | 说明 | 可用运算符 | 值示例 |
|---|---|---|---|
| 主机名（域名） | 请求的 Host | 字符串运算符 | *.maoziyun.com |
| 完整 URL | 路径 + 查询参数 | 字符串运算符 | /api/user?id=1 |
| 请求路径 | 不含查询参数的路径 | 字符串运算符 | /api |
| 请求方法 | HTTP 方法 | 等于、不等于、包含以下各项、不包含以下各项 | GET、POST、PUT、PATCH、DELETE、OPTIONS |
| 文件后缀 | 请求路径的扩展名 | 包含以下各项、不包含以下各项 | 输入后按回车，如 jpg、png，最多 50 个 |
| 国家/地区 | 根据客户端 IP 识别的国家或地区 | 等于、不等于、包含以下各项、不包含以下各项 | 中国、美国 |
| GET参数 | URL 查询参数 | 字符串运算符、小于、大于、存在、不存在 | 参数值 lang，值 en |
| POST参数 | 表单参数 | 同 GET参数 | 参数值 type，值 vip |
| Cookie参数 | Cookie 中的字段 | 同 GET参数 | 参数值 ab_test，值 b |
字符串运算符：等于、不等于、通配符、包含、不包含、开头是、开头不是、结尾是、结尾不是。
- 通配符 使用
*匹配任意字符，例如*.example.com、/static/*。 - 小于 / 大于 时值为数字。
- 存在 / 不存在 只判断参数是否存在，无需填写值。
执行顺序
- 规则按列表中从上到下的顺序匹配。拖动规则左侧的拖拽图标可以调整顺序。
- 新建的规则默认添加到列表末尾。
- 更具体的规则（如
/api/v2）建议放在更宽泛的规则（如/api）前面。
启用、编辑和删除
- 每条规则右侧的开关可以随时 启用 或 关闭，关闭后规则保留但不生效。新建的规则默认启用。
- 点击编辑按钮修改规则。
- 删除规则需要确认，删除后不可恢复。如果只是临时停用，建议关闭开关。
列表中每条规则会显示摘要，例如 1 组匹配 · 2 个节点 · HTTP。
更新于