应用管理/规则

反向代理规则

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

入口:应用详情页 → 规则 → 反向代理规则 → 添加反向代理规则。

添加反向代理规则

配置项

规则名称 和 匹配规则 见 规则。规则配置 包括:

字段说明默认值
协议网关访问上游时使用的协议:HTTP 或 HTTPSHTTP
Host 透传使用 Upstream 节点 Host:请求头 Host 改为节点的 Host;透传客户端 Host:保留用户访问的域名使用 Upstream 节点 Host
节点上游服务器列表,至少 1 个-
超时(秒)连接超时、发送超时、读取超时,范围 1 ~ 360015

节点

列说明
Host(IP / 域名)必填,例如 api.example.com 或 10.0.0.1
Port1 ~ 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,Port 443,Weight 100

访问 https://www.example.com/api/users 时,网关会请求 https://api.example.com/api/users。

示例 2:按比例灰度

把 10% 的流量切到新版本服务器:

  • 匹配规则:匹配所有请求
  • 节点 1:10.0.0.1,Port 80,Weight 90
  • 节点 2:10.0.0.2,Port 80,Weight 10

示例 3:海外用户访问海外节点

  • 匹配规则:国家/地区 不包含以下各项 中国
  • 节点:海外服务器地址

注意事项

  • 规则按列表顺序从上到下匹配,更具体的条件请放在前面。
  • 上游响应慢时可以适当调大 读取超时。
  • 规则在网关上生效,保存后无需重新部署应用。

更新于

此页面是否有帮助?