appstore/apps/gpt-load

GPT-Load

产品介绍

GPT-Load 是多渠道 AI API 透明代理服务，面向需要统一管理多个上游模型服务、密钥池、负载均衡和调用监控的场景。

主要功能

• 提供 OpenAI、Gemini、Claude 等 API 的透明代理入口
• 支持密钥池管理、自动轮询、失败恢复和负载均衡
• 管理端和代理端分离鉴权，并支持 SQLite 单容器轻量部署

访问说明

安装后通过 http://<服务器 IP>:15077 访问管理界面，实际端口以安装表单中的 PANEL_APP_PORT_HTTP 为准；API 代理地址为 http://<服务器 IP>:<端口>/proxy。

Introduction

GPT-Load is a multi-channel AI API transparent proxy for managing upstream providers, key pools, load balancing and request monitoring.

Features

• Transparent proxy entry for OpenAI, Gemini, Claude and similar APIs
• Key pool management, rotation, failure recovery and load balancing
• Separate authentication for management and proxy access, with SQLite single-container deployment by default

部署说明

• 本应用使用官方 GitHub Container Registry 镜像 ghcr.io/tbphp/gpt-load 部署。
• 默认采用官方文档中的 SQLite 单容器形态，只挂载 /app/data 数据目录。
• 应用分类：AI。
• 支持架构：amd64、arm64。
• 可选版本：latest。

端口

变量	说明	默认值	必填
PANEL_APP_PORT_HTTP	GPT-Load Web 管理端与 API 代理端口	15077	是

数据持久化

变量	说明	默认值	必填
APP_DATA_DIR	GPT-Load 数据目录，挂载到容器 /app/data	./data	是

升级、迁移、变更加密密钥或切换外部数据库前，请先在 1Panel 中备份 APP_DATA_DIR。

参数说明

变量	说明	默认值	必填
AUTH_KEY	管理端登录密钥，安装时随机生成	随机生成	是
ENCRYPTION_KEY	API Key 静态加密密钥，安装后请保持稳定	随机生成	是
TZ	容器时区	Asia/Shanghai	是

使用说明

• 请妥善保存 AUTH_KEY，它用于登录管理界面。
• ENCRYPTION_KEY 用于加密存储 API Key；已有数据后请勿随意修改，否则可能需要按官方迁移流程处理加密数据。
• 本应用是 AI API 代理服务，使用前请确认你已合法取得上游 API Key、账号、模型服务和接口权限。
• 如对公网开放访问，请同步配置防火墙、安全组、反向代理、HTTPS 和访问控制。
• 如需 MySQL、PostgreSQL、Redis 或集群部署，请参考官方文档后再调整配置。

参考资料

• 项目仓库: https://github.com/tbphp/gpt-load
• Docker 快速开始: https://github.com/tbphp/gpt-load#method-1-docker-quick-start
• Compose 部署说明: https://github.com/tbphp/gpt-load#method-2-using-docker-compose-recommended