Files
appstore/apps/gpt-load/README.md
T
2026-06-27 19:29:29 +08:00

59 lines
2.8 KiB
Markdown

# 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>