分组配置管理

分组创建和配置的完整指南,包括基础配置、上游地址、高级设置等功能的详细配置说明

基础配置

分组名称

分组的唯一标识符,用于系统内部识别和管理,建议使用有意义的命名

显示名称

分组的友好显示名称,用于前端界面展示,提高可读性

渠道类型

上游服务的类型标识,决定了API兼容性和请求格式

测试模型

用于连接测试的模型名称,确保配置正确性

代理密钥

系统生成的代理密钥,用于API访问认证,支持生成和复制操作

排序权重

分组的优先级权重,数值越高优先级越高,影响负载均衡策略

上游地址配置

多地址负载均衡

支持配置多个上游地址实现负载分担和高可用性。注意:多个地址应为同一服务的不同接入点,而非不同的服务提供商。

基于权重的轮询算法分发请求

所有地址必须为同一上游服务的不同节点

支持加权轮询,实现智能负载分担

配置示例

https://api.openai.com
权重: 1 (主要地址)
https://ai.proxy.com/openai
权重: 1 (备用地址)

特性优势

  • 高可用性:单点故障时自动切换
  • 自动故障转移:异常节点自动剔除
  • 性能优化:就近节点访问提升响应速度
  • 实时监控:节点状态和响应时间监控

高级配置

分组配置覆盖

分组级别的配置参数,优先级高于全局系统配置。未配置的参数将使用系统默认值。

配置优先级
  1. 1. 分组配置(最高优先级)
  2. 2. 系统配置(中等优先级)
  3. 3. 默认配置(最低优先级)
参考文档

详细的可覆盖配置项请参考项目配置页面说明

自定义请求头

功能说明
  • 添加自定义HTTP请求头
  • 删除现有的请求头字段
  • 修改已存在的请求头值
配置示例
Authorization: Bearer custom-tokenUser-Agent: GPT-Load/1.0

参数覆盖

高级JSON格式的请求参数覆盖功能,用于强制覆盖用户请求中的特定参数。配置后将自动合并到所有请求中。

JSON格式
{
  "generationConfig": {
    "thinkingConfig": {
      "includeThoughts": true
    }
  },
  "tools": [
    {
      "google_search": {}
    }
  ]
}
使用场景
  • 设置默认参数值
  • 限制参数范围
  • 强制安全参数

配置最佳实践

配置管理
  • 配置变更前先在测试环境验证
  • 重要配置变更前备份当前设置
  • 使用测试功能验证配置有效性
安全建议
  • 定期轮换API密钥确保安全
  • 限制管理界面访问权限
  • 监控异常访问和错误日志