环境配置
配置特点
加载方式
- • 通过环境变量或 .env 文件
- • 应用启动时一次性读取
- • 运行时不可修改
- • 提供基础配置默认值
适用场景
- • 服务器基础参数配置
- • 数据库连接信息
- • 安全认证密钥
- • 日志和监控设置
服务器配置
| 配置项 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
| 服务端口 | PORT | 3001 | HTTP 服务器监听端口 |
| 服务地址 | HOST | 0.0.0.0 | HTTP 服务器绑定地址 |
| 读取超时 | SERVER_READ_TIMEOUT | 60秒 | HTTP 服务器读取请求超时 |
| 写入超时 | SERVER_WRITE_TIMEOUT | 600秒 | HTTP 服务器写入响应超时 |
| 优雅关闭超时 | SERVER_GRACEFUL_SHUTDOWN_TIMEOUT | 10秒 | 服务优雅关闭等待时间 |
| 并发数量 | MAX_CONCURRENT_REQUESTS | 100 | 最大并发请求数量 |
数据库配置
MySQL 数据库
环境变量：
DATABASE_DSNuser:pass@tcp(host:3306)/db?charset=utf8mb4Redis 缓存
环境变量：
REDIS_DSNredis://localhost:6379/0安全配置
认证设置
AUTH_KEY必需项：访问 Web 管理界面的认证密钥
CORS 设置
启用 CORS：
ENABLE_CORS=true允许来源：
ALLOWED_ORIGINS=*允许方法：
ALLOWED_METHODS=GET,POST,...代理配置
优先级说明
代理配置支持三层优先级：分组配置 > 系统配置 > 环境配置
环境代理作为全局兜底配置，仅在系统配置和分组配置都未设置代理时生效。
GPT-Load 会自动从环境变量中读取代理设置，作为最低优先级的全局代理配置。
代理设置
| 配置项 | 环境变量 | 说明 |
|---|---|---|
| HTTP 代理 | HTTP_PROXY | 用于 HTTP 请求的代理服务器地址 |
| HTTPS 代理 | HTTPS_PROXY | 用于 HTTPS 请求的代理服务器地址 |
| 无代理 | NO_PROXY | 不需要通过代理访问的主机或域名，逗号分隔 |
支持的协议格式
HTTP:
http://user:pass@host:portHTTPS:
https://user:pass@host:portSOCKS5:
socks5://user:pass@host:port环境配置总结
环境配置是 GPT-Load 配置系统的基石，主要负责提供应用运行所需的基础设施参数。
- 基础服务参数：定义了应用启动和运行所依赖的核心服务，如服务器端口、数据库连接等。
- 管理特性：通过
.env文件或操作系统环境变量进行配置，在应用启动时加载，确保了配置的稳定性和一致性。 - 使用优势：为系统提供了可靠的默认值，同时将敏感信息（如数据库密码、API密钥）与代码库分离，增强了安全性。