环境配置

配置特点

加载方式

• 通过环境变量或 .env 文件
• 应用启动时一次性读取
• 运行时不可修改
• 提供基础配置默认值

适用场景

• 服务器基础参数配置
• 数据库连接信息
• 安全认证密钥
• 日志和监控设置

服务器配置

配置项	环境变量	默认值	说明
服务端口	`PORT`	3001	HTTP 服务器监听端口
服务地址	`HOST`	0.0.0.0	HTTP 服务器绑定地址
读取超时	`SERVER_READ_TIMEOUT`	60	HTTP 服务器读取超时（秒）
写入超时	`SERVER_WRITE_TIMEOUT`	600	HTTP 服务器写入超时（秒）
空闲超时	`SERVER_IDLE_TIMEOUT`	120	HTTP 连接空闲超时（秒）
优雅关闭超时	`SERVER_GRACEFUL_SHUTDOWN_TIMEOUT`	10	服务优雅关闭等待时间（秒）
从节点模式	`IS_SLAVE`	false	集群部署时从节点标识
时区	`TZ`	Asia/Shanghai	指定时区

认证与数据库配置

配置项	环境变量	默认值	说明
管理密钥	`AUTH_KEY`	sk-123456	管理端的访问认证密钥，请修改为强密码
数据库连接	`DATABASE_DSN`	./data/gpt-load.db	数据库连接字符串 (DSN) 或文件路径
Redis 连接	`REDIS_DSN`	-	Redis 连接字符串，为空时使用内存存储

性能与跨域配置

配置项	环境变量	默认值	说明
最大并发请求	`MAX_CONCURRENT_REQUESTS`	100	系统允许的最大并发请求数
启用 CORS	`ENABLE_CORS`	false	是否启用跨域资源共享
允许的来源	`ALLOWED_ORIGINS`	-	允许的来源，逗号分隔
允许的方法	`ALLOWED_METHODS`	GET,POST,PUT,DELETE,OPTIONS	允许的 HTTP 方法
允许的头部	`ALLOWED_HEADERS`	*	允许的请求头，逗号分隔
允许凭据	`ALLOW_CREDENTIALS`	false	是否允许发送凭据

日志配置

配置项	环境变量	默认值	说明
日志级别	`LOG_LEVEL`	info	日志级别：debug, info, warn, error
日志格式	`LOG_FORMAT`	text	日志格式：text, json
启用文件日志	`LOG_ENABLE_FILE`	false	是否启用文件日志输出
日志文件路径	`LOG_FILE_PATH`	./data/logs/app.log	日志文件存储路径

代理配置

优先级说明

代理配置支持三层优先级：分组配置 > 系统配置 > 环境配置

环境代理作为全局兜底配置，仅在系统配置和分组配置都未设置代理时生效。

GPT-Load 会自动从环境变量中读取代理设置，用于向上游 AI 服务商发起请求。

代理设置

配置项	环境变量	默认值	说明
HTTP 代理	`HTTP_PROXY`	-	用于 HTTP 请求的代理服务器地址
HTTPS 代理	`HTTPS_PROXY`	-	用于 HTTPS 请求的代理服务器地址
无代理	`NO_PROXY`	-	不需要通过代理访问的主机或域名，逗号分隔

支持的协议格式

HTTP:

http://user:pass@host:port

HTTPS:

https://user:pass@host:port

SOCKS5:

socks5://user:pass@host:port

环境配置总结

环境配置是 GPT-Load 配置系统的基石，主要负责提供应用运行所需的基础设施参数。

基础服务参数：定义了应用启动和运行所依赖的核心服务，如服务器端口、数据库连接等。
管理特性：通过 .env 文件或操作系统环境变量进行配置，在应用启动时加载，确保了配置的稳定性和一致性。
使用优势：为系统提供了可靠的默认值，同时将敏感信息（如数据库密码、API密钥）与代码库分离，增强了安全性。