单机部署

单机部署是 GPT-Load 最简单的部署方式，适合个人用户和小团队快速上手。支持从轻量化快速启动到完整功能的可选部署。

快速启动

轻量化部署

使用 SQLite 数据库和内存存储，最适合个人使用和快速体验

环境要求

Docker 20.10+ 和 Docker Compose
Linux/macOS/Windows 操作系统
至少 128MB 内存和 1GB 磁盘空间

安装步骤

🚨

关键安全警告

部署前必须更改默认管理密钥，否则存在严重安全风险！

安全密钥要求：

• 最少 20 个字符
• 包含大小写字母、数字、特殊符号
• 避免使用字典词汇或个人信息
• 推荐格式：sk-prod-[32位随机字符串]

⚠️ 使用弱密钥可能导致系统被恶意访问，造成数据泄露或服务滥用！

创建工作目录

# 创建目录并进入
mkdir -p gpt-load && cd gpt-load

下载并配置安全参数

# 下载 Docker Compose 配置
wget https://raw.githubusercontent.com/tbphp/gpt-load/refs/heads/main/docker-compose.yml

# 下载环境变量配置
wget -O .env https://raw.githubusercontent.com/tbphp/gpt-load/refs/heads/main/.env.example

⚠️

必须执行：修改管理密钥

立即编辑 .env 文件，将：

AUTH_KEY=sk-123456

替换为安全的密钥：

AUTH_KEY=sk-prod-AbCdEfGh123456$#@!XyZabc789012

提醒：请生成您自己的随机密钥，不要使用上面的示例密钥！

启动服务

# 启动 GPT-Load 服务
docker compose up -d

验证部署

访问管理界面：

http://localhost:3001

🔐

使用您自定义的管理密钥登录

即您在 .env 文件中设置的AUTH_KEY 值

💡

安全提示：请妥善保管您的管理密钥，不要在日志、文档或代码中明文存储。

常用命令

查看状态

docker compose ps

查看日志

docker compose logs -f

重启服务

docker compose down && docker compose up -d

更新版本

docker compose pull && docker compose down && docker compose up -d

可选部署

增强性能

配置 MySQL/PostgreSQL 数据库和 Redis 缓存，提升系统性能和可靠性

数据库配置

MySQL 配置

1. 编辑 docker-compose.yml ，取消 MySQL 服务的注释：

  depends_on:
    mysql:
      condition: service_healthy
      restart: true

mysql:
  image: mysql:8.2
  container_name: gpt-load-mysql
  restart: always
  environment:
    MYSQL_ROOT_PASSWORD: 123456
    MYSQL_DATABASE: gpt-load
  volumes:
    - ./data/mysql:/var/lib/mysql
  healthcheck:
    test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
    interval: 5s
    timeout: 5s
    retries: 10

2. 在 .env 文件中配置数据库连接：

DATABASE_DSN=root:123456@tcp(mysql:3306)/gpt-load?charset=utf8mb4&parseTime=True&loc=Local

PostgreSQL 配置

1. 编辑 docker-compose.yml ，取消 PostgreSQL 服务的注释：

  depends_on:
    postgres:
      condition: service_healthy
      restart: true

postgres:
  image: "postgres:16"
  container_name: gpt-load-postgres
  environment:
    POSTGRES_USER: postgres
    POSTGRES_PASSWORD: 123456
    POSTGRES_DB: gpt-load
  volumes:
    - ./data/postgres:/var/lib/postgresql/data
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres -d "]
    interval: 5s
    timeout: 5s
    retries: 10

2. 在 .env 文件中配置数据库连接：

DATABASE_DSN=postgres://postgres:123456@postgres:5432/gpt-load?sslmode=disable

Redis 配置

1. 编辑docker-compose.yml，取消 Redis 服务的注释：

  depends_on:
    redis:
      condition: service_healthy
      restart: true

redis:
  image: redis:latest
  container_name: gpt-load-redis
  restart: always
  healthcheck:
    test: ["CMD", "redis-cli", "ping"]
    interval: 5s
    timeout: 3s
    retries: 3

2. 在 .env 文件中配置 Redis 连接：

REDIS_DSN=redis://redis:6379/0

重新启动服务

配置完成后，重新启动所有服务：

# 停止服务
docker compose down

# 重新启动服务
docker compose up -d

故障排除

常见问题

无法登录管理界面

请检查您是否使用了正确的管理密钥：

• 确认 .env 文件中的 AUTH_KEY 已修改
• 重启服务后新密钥才会生效：docker compose restart
• 密钥区分大小写，请确保输入正确

端口冲突

如果 3001 端口被占用，可以在 .env 文件中修改：

PORT=3002

数据库连接失败

检查数据库服务是否正常启动：

docker compose logs mysql

内存不足

确保系统有足够的内存资源，开发数据库服务后，建议至少 1GB 可用内存

下一步

部署完成后，您可以：

配置代理密钥和管理 AI 服务分组
添加和管理 AI 服务商 API 密钥
调整系统配置和性能参数
开始使用 API 代理服务

查看配置说明管理端配置