配置指南

详细了解 GPT-Load 的各种配置选项，优化您的部署

环境变量配置

GPT-Load 支持通过环境变量进行灵活配置。您可以创建 .env 文件或直接设置环境变量。

创建配置文件

# 复制示例配置
cp .env.example .env

# 编辑配置
vim .env

核心配置

变量名	默认值	说明
PORT	3000	服务器监听端口
HOST	0.0.0.0	服务器绑定地址
KEYS_FILE	keys.txt	API 密钥文件路径
OPENAI_BASE_URL	https://api.openai.com	上游 API 基础地址

性能配置

变量名	默认值	说明
MAX_CONCURRENT_REQUESTS	100	最大并发请求数
REQUEST_TIMEOUT	30	请求超时时间（秒）
RESPONSE_TIMEOUT	30	响应超时时间（秒）
ENABLE_GZIP	true	启用 Gzip 压缩

密钥管理

密钥文件格式

创建一个文本文件，每行包含一个 API 密钥：

# keys.txt
sk-your-openai-key-1
sk-your-openai-key-2
sk-your-openai-key-3

# 支持注释（以 # 开头）
# sk-disabled-key-4

轮询配置

变量名	默认值	说明
START_INDEX	0	密钥轮换起始索引
BLACKLIST_THRESHOLD	1	拉黑前的错误次数
MAX_RETRIES	3	使用不同密钥的最大重试次数

CORS 配置

变量名	默认值	说明
ENABLE_CORS	true	启用 CORS 支持
ALLOWED_ORIGINS	*	允许的来源（逗号分隔）
ALLOWED_METHODS	GET,POST,PUT,DELETE,OPTIONS	允许的 HTTP 方法
ALLOWED_HEADERS	*	允许的头部（逗号分隔）

安全配置

认证设置

变量名	默认值	说明
AUTH_KEY	-	可选的认证密钥

⚠️ 安全提示

• 在生产环境中设置 AUTH_KEY 来保护您的代理服务
• 使用强密码并定期更换认证密钥
• 限制 ALLOWED_ORIGINS 到可信域名
• 定期监控访问日志

配置示例

生产环境配置

# .env
PORT=3000
HOST=0.0.0.0
KEYS_FILE=/etc/gpt-load/keys.txt
OPENAI_BASE_URL=https://api.openai.com

# 性能优化
MAX_CONCURRENT_REQUESTS=200
REQUEST_TIMEOUT=60
ENABLE_GZIP=true

# 安全配置
AUTH_KEY=your-super-secret-auth-key
ALLOWED_ORIGINS=https://yourdomain.com,https://app.yourdomain.com

# 日志配置
LOG_LEVEL=info
LOG_ENABLE_FILE=true
LOG_FILE_PATH=/var/log/gpt-load/app.log

开发环境配置

# .env.development
PORT=3000
KEYS_FILE=./keys.txt
OPENAI_BASE_URL=https://api.openai.com

# 开发调试
LOG_LEVEL=debug
LOG_ENABLE_REQUEST=true
ENABLE_CORS=true
ALLOWED_ORIGINS=*

# 较低的并发限制
MAX_CONCURRENT_REQUESTS=10