代理与请求头
这一页是给非标场景准备的:网络受限、不同凭据需要不同出口,或上游要求特殊请求头。用不到就不用看。
什么时候需要§
常见的几种情况:
- 服务器访问不了某些上游——需要走代理出去
- 不同凭据要走不同出口——比如按区域分流
- 上游要求特定请求头——某些中转服务会校验来源标识
- 浏览器需要跨域调用,或客户端需要自定义响应头
没有这些需求的话,这一页的配置全都留空即可。
出站代理§
代理配置有三种模式:
- 继承——用上一级的配置,这是默认值
- 直连——明确不走代理, 即使上一级配了也不用
- 选择代理——从统一代理列表中选择已启用的代理
先在侧栏「代理」页新增或批量导入代理,每行一个 HTTP 或 SOCKS5 地址,重复配置会跳过;再在全局、分组或凭据设置中选择。同一代理可被多处引用,修改地址会影响所有使用它的资源。
停用或删除被引用的代理后,对应层级按继承处理,继续查找上一级,最终可能直连;重新启用后,保留的引用会自动恢复使用。测试只验证服务器经该代理访问测试地址的结果,不会自动改变启用状态。
这两个容易混。继承是「跟着上级走」,上级配了代理就走代理;直连是「明确不走」,用来给个别凭据开例外—— 比如大部分上游要代理,但有一个在内网、走代理反而不通。
Azure OpenAI、AWS Bedrock 与 Google Vertex AI 当前不支持 GPT-Load 托管代理。其他渠道的准确状态以支持矩阵为准。
四级覆盖§
代理可以配在四个层级,越具体的优先。 完整的优先级链是:凭据 → 分组 → 全局 → 环境变量 → 直连。
- 环境变量——
HTTP_PROXY与HTTPS_PROXY,进程级的兜底出口。 只在上面三级都没有明确指定时才生效,改完需要重启进程 - 全局——管理台里配置的默认出口
- 分组——覆盖全局,这个分组的所有凭据都走它
- 单个凭据——覆盖分组,只对这一个凭据生效
管理台里选继承时,才会继续往下找;一路都是继承,最后才落到HTTP_PROXY 这类环境变量上。所以在管理台配了全局代理之后, 环境变量就不再起作用了。反过来,任何一级选了直连, 环境变量同样不生效。
这三个变量在 环境变量 页有完整说明。
凭据级这一层是很多网关没有的。实际用途: 同一个服务商的多个账号分属不同区域, 需要各自从对应区域的出口访问,否则会被判定为异地登录。
上游请求头规则§
可以在转发前修改发往上游的请求头,支持添加和删除两类动作。配置分全局与分组两级。
典型用途:
- 补上游要求的标识头——某些中转服务需要特定的来源标记
- 去掉客户端带来的干扰头—— 有些客户端会附带自己的追踪头,上游可能不接受
认证相关的头由网关自己管理——它需要按选中的凭据动态填充。 用规则去改它会导致请求失败。
响应头与跨域§
在「设置 → 浏览器访问」配置下游响应头规则,可设置或移除返回客户端的自定义 Header。 认证、协议必要字段和网关保留头不能覆盖,CORS 头通过专用配置管理。
CORS 默认关闭。浏览器跨域调用时,启用后配置允许的来源、方法和请求头;携带凭据时不能将允许来源设为 *。
这两项仅作用于 /v1、/v1beta 数据面,不影响 /api 管理接口。 允许的预检会自动处理,实际请求仍需 AccessKey 认证。
配置位置见 运行时设置。