Gemini Balance使用docker-compose部署教程

详细安装教程：Gemini-Balance 负载均衡服务

第一步：创建项目目录

在用户根目录创建项目文件夹（推荐位置）

mkdir -p ~/gemini-balance/data
cd ~/gemini-balance

第二步：创建配置文件
创建 .env 文件

复制粘贴以下内容（替换实际API密钥）：

API_KEYS=["your-gemini-api-key-1","your-gemini-api-key-2"]
ALLOWED_TOKENS=["your-access-token-1","your-access-token-2"]
DATABASE_TYPE=sqlite
SQLITE_DATABASE=default_db
TZ=Asia/Shanghai

创建 docker-compose.yml 文件

version: "3.8"

services:
  gemini-balance:
    image: ghcr.io/snailyp/gemini-balance:latest
    container_name: gemini-balance
    restart: unless-stopped
    ports:
      - "8000:8000"
    env_file:
      - .env
    volumes:
      - ./data:/app/data
    healthcheck:
      test:
        - CMD
        - curl
        - -f
        - http://localhost:8000/health
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 10s

第三步：在Gemini-Balance文件夹目录启动服务

docker-compose up -d

第四步：验证安装

# 查看容器状态
docker ps

# 查看实时日志
docker logs -f gemini-balance

当看到 Application startup complete 提示时表示启动成功

第五步：访问服务
打开浏览器访问：

本地访问：http://localhost:8000

服务器访问：http://你的服务器IP:8000

登录后台：

密码：your-access-token-1（.env 中设置的第一个令牌）

第六步：修改密码（重要！）

删除默认令牌

点击 “+” 生成新令牌

复制保存新令牌