分组配置管理
分组创建和配置的完整指南,包括基础配置、上游地址、高级设置等功能的详细配置说明
基础配置
分组名称
分组的唯一标识符,用于系统内部识别和管理,建议使用有意义的命名
显示名称
分组的友好显示名称,用于前端界面展示,提高可读性
渠道类型
上游服务的类型标识,决定了API兼容性和请求格式
测试模型
用于连接测试的模型名称,确保配置正确性
代理密钥
系统生成的代理密钥,用于API访问认证,支持生成和复制操作
排序权重
分组的优先级权重,数值越高优先级越高,影响负载均衡策略
上游地址配置
多地址负载均衡
支持配置多个上游地址实现负载分担和高可用性。注意:多个地址应为同一服务的不同接入点,而非不同的服务提供商。
• 基于权重的轮询算法分发请求
• 所有地址必须为同一上游服务的不同节点
• 支持加权轮询,实现智能负载分担
配置示例
https://api.openai.com
权重: 1 (主要地址)
https://ai.proxy.com/openai
权重: 1 (备用地址)
特性优势
- • 高可用性:单点故障时自动切换
- • 自动故障转移:异常节点自动剔除
- • 性能优化:就近节点访问提升响应速度
- • 实时监控:节点状态和响应时间监控
高级配置
分组配置覆盖
分组级别的配置参数,优先级高于全局系统配置。未配置的参数将使用系统默认值。
配置优先级
- 1. 分组配置(最高优先级)
- 2. 系统配置(中等优先级)
- 3. 默认配置(最低优先级)
参考文档
详细的可覆盖配置项请参考项目配置页面说明
自定义请求头
功能说明
- • 添加自定义HTTP请求头
- • 删除现有的请求头字段
- • 修改已存在的请求头值
配置示例
Authorization: Bearer custom-token
User-Agent: GPT-Load/1.0
参数覆盖
高级JSON格式的请求参数覆盖功能,用于强制覆盖用户请求中的特定参数。配置后将自动合并到所有请求中。
JSON格式
{ "generationConfig": { "thinkingConfig": { "includeThoughts": true } }, "tools": [ { "google_search": {} } ] }
使用场景
- • 设置默认参数值
- • 限制参数范围
- • 强制安全参数
配置最佳实践
配置管理
- • 配置变更前先在测试环境验证
- • 重要配置变更前备份当前设置
- • 使用测试功能验证配置有效性
安全建议
- • 定期轮换API密钥确保安全
- • 限制管理界面访问权限
- • 监控异常访问和错误日志