反向代理规则
反向代理规则把命中条件的请求转发到你指定的上游节点(IP 或域名)。浏览器访问的地址不变,由帽子云网关代为请求上游并返回结果。
入口:应用详情页 → 规则 → 反向代理规则 → 添加反向代理规则。

配置项
规则名称 和 匹配规则 见 规则。规则配置 包括:
| 字段 | 说明 | 默认值 |
|---|---|---|
| 协议 | 网关访问上游时使用的协议:HTTP 或 HTTPS | HTTP |
| Host 透传 | 使用 Upstream 节点 Host:请求头 Host 改为节点的 Host;透传客户端 Host:保留用户访问的域名 | 使用 Upstream 节点 Host |
| 节点 | 上游服务器列表,至少 1 个 | - |
| 超时(秒) | 连接超时、发送超时、读取超时,范围 1 ~ 3600 | 15 |
节点
| 列 | 说明 |
|---|---|
| Host(IP / 域名) | 必填,例如 api.example.com 或 10.0.0.1 |
| Port | 1 ~ 65535。HTTP 一般为 80,HTTPS 一般为 443 |
| Weight | 权重 0 ~ 100。多个节点时按权重比例分配请求;权重为 0 的节点不接收请求 |
点击 添加节点 增加节点,最后一个节点不能删除。
tip
上游是 HTTPS 站点(例如第三方 API)时,协议 选择 HTTPS、Port 填 443,Host 透传 选择"使用 Upstream 节点 Host",否则上游可能因为 Host 不匹配返回 404 或证书错误。
示例
示例 1:把 /api 转发到后端服务
前端部署为静态网站,后端运行在自己的服务器 api.example.com 上:
- 匹配规则:自定义筛选,请求路径 开头是
/api - 协议:HTTPS
- Host 透传:使用 Upstream 节点 Host
- 节点:
api.example.com,Port443,Weight100
访问 https://www.example.com/api/users 时,网关会请求 https://api.example.com/api/users。
示例 2:按比例灰度
把 10% 的流量切到新版本服务器:
- 匹配规则:匹配所有请求
- 节点 1:
10.0.0.1,Port80,Weight90 - 节点 2:
10.0.0.2,Port80,Weight10
示例 3:海外用户访问海外节点
- 匹配规则:国家/地区 不包含以下各项 中国
- 节点:海外服务器地址
注意事项
- 规则按列表顺序从上到下匹配,更具体的条件请放在前面。
- 上游响应慢时可以适当调大 读取超时。
- 规则在网关上生效,保存后无需重新部署应用。
更新于