单机部署
单机部署是 GPT-Load 最简单的部署方式，适合个人用户和小团队快速上手。支持从轻量化快速启动到完整功能的可选部署。
快速启动
轻量化部署
使用 SQLite 数据库和内存存储，最适合个人使用和快速体验
环境要求
- Docker 20.10+ 和 Docker Compose
- Linux/macOS/Windows 操作系统
- 至少 128MB 内存和 1GB 磁盘空间
安装步骤
1
创建工作目录
# 创建目录并进入
mkdir -p gpt-load && cd gpt-load2
下载配置文件
# 下载 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.example3
启动服务
# 启动 GPT-Load 服务
docker compose up -d4
验证部署
访问管理界面：
http://localhost:3001默认管理密钥：sk-123456（用于登录管理界面）
常用命令
查看状态
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
ports:
- "3306:3306"
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: 102. 在 .env 文件中配置数据库连接：
DATABASE_DSN=root:123456@tcp(mysql:3306)/gpt-load?charset=utf8mb4&parseTime=True&loc=LocalPostgreSQL 配置
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
ports:
- "5432:5432"
volumes:
- ./data/postgres:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres -d "]
interval: 5s
timeout: 5s
retries: 102. 在 .env 文件中配置数据库连接：
DATABASE_DSN=postgres://postgres:123456@postgres:5432/gpt-load?sslmode=disableRedis 配置
1. 编辑 docker-compose.yml，取消 Redis 服务的注释：
depends_on:
redis:
condition: service_healthy
restart: true
redis:
image: redis:latest
container_name: gpt-load-redis
restart: always
ports:
- "6379:6379"
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 5s
timeout: 3s
retries: 32. 在 .env 文件中配置 Redis 连接：
REDIS_DSN=redis://redis:6379/0重新启动服务
配置完成后，重新启动所有服务：
# 停止服务
docker compose down
# 重新启动服务
docker compose up -d故障排除
常见问题
端口冲突
如果 3001 端口被占用，可以在 .env 文件中修改：
PORT=3002数据库连接失败
检查数据库服务是否正常启动：
docker compose logs mysql内存不足
确保系统有足够的内存资源，开发数据库服务后，建议至少 1GB 可用内存