【亲测免费】 Gemini Balance 安装与配置指南

1. 项目基础介绍

Gemini Balance 是一个开源项目，旨在提供一个基于 Python FastAPI 的应用程序，用于 Google Gemini API 的代理和负载均衡功能。它支持多 Key 负载均衡、可视化配置即时生效、双协议 API 兼容等特点，同时还具备图像生成和多种图床上传功能。

主要编程语言：Python

2. 项目使用的关键技术和框架

• FastAPI: 用于构建 API 的现代、快速（高性能）的 Web 框架，使用 Python 3.6 及以上版本编写。
• SQLAlchemy: Python SQL 工具包和对象关系映射（ORM）系统，用于数据库操作。
• uvicorn: ASGI 服务器，用于运行 FastAPI 应用。
• Docker: 用于容器化应用，便于部署和运维。

3. 项目安装和配置的准备工作及详细步骤

准备工作

• 确保你的系统安装了 Python 3.9 或更高版本。
• 安装 Docker（推荐使用 Docker，但也可以选择不使用）。
• 准备好 MySQL 数据库，并记下相关配置信息。

安装步骤

使用 Docker 部署（推荐）

1. 克隆项目仓库到本地：

   git clone https://github.com/snailyp/gemini-balance.git
   cd gemini-balance
   

2. 使用 Docker 构建镜像：

   docker build -t gemini-balance .
   

3. 运行 Docker 容器：

   docker run -d -p 8000:8000 --env-file .env gemini-balance
   

   这条命令会使用 .env 文件中的环境变量启动一个后台运行的容器，并将容器的 8000 端口映射到主机的 8000 端口。

不使用 Docker 部署

1. 克隆项目仓库到本地：

   git clone https://github.com/snailyp/gemini-balance.git
   cd gemini-balance
   

2. 在项目根目录下创建并配置 .env 文件，包含如下内容（根据实际情况修改）：

   MYSQL_HOST=localhost
   MYSQL_PORT=3306
   MYSQL_USER=your_db_user
   MYSQL_PASSWORD=your_db_password
   MYSQL_DATABASE=defaultdb
   API_KEYS=["your-gemini-api-key-1", "your-gemini-api-key-2"]
   ALLOWED_TOKENS=["your-access-token-1", "your-access-token-2"]
   

   更多配置项请参考项目 README.md 文件中的 “完整配置项列表”。

3. 安装项目依赖：

   pip install -r requirements.txt
   

4. 启动应用：

   uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
   

   当你修改代码时，服务会自动重启，非常适合开发环境。

访问应用

应用启动后，你可以通过浏览器或 API 工具访问 http://localhost:8000（或你指定的主机和端口）来使用该服务。