# 讯速 (Xunsu Gemini Proxy)

一个功能完整的 Gemini API 反向代理服务，提供 OpenAI 兼容的 API 接口。

## 版本信息

- **版本**: v1.2
- **发布日期**: 2026-03-06
- **下载地址**: https://dl.xunsu.app/xunsu-gemini-proxy-v1.2.tar.gz

## 快速开始

### 下载并安装

```bash
# 下载
wget https://dl.xunsu.app/xunsu-gemini-proxy-v1.2.tar.gz

# 解压
tar -xzf xunsu-gemini-proxy-v1.2.tar.gz
cd gemini-proxy

# 运行安装脚本
sudo bash install.sh
```

### 系统要求

- **操作系统**: Ubuntu 20.04+ / Debian 11+ / CentOS 8+
- **Node.js**: v18.0.0 或更高版本（安装脚本会自动安装）
- **内存**: 最低 1GB RAM
- **磁盘**: 最低 2GB 可用空间

## 核心功能

### API 管理
- ✅ OpenAI 兼容 API 接口
- ✅ API Key 管理（配额、有效期）
- ✅ 自动生成 API Key
- ✅ 使用统计和排行榜

### 账户管理
- ✅ 多 Google 账户支持
- ✅ 负载均衡（least-used, round-robin, random, weighted）
- ✅ Cookie 自动刷新
- ✅ 健康检查和自动恢复

### 虚拟货币
- ✅ Token 计费系统
- ✅ 可配置单价和单位
- ✅ 消费统计和报表

### 管理后台
- ✅ Web 管理界面
- ✅ 用户认证和权限管理
- ✅ 实时统计和监控
- ✅ 配置管理

### 公开功能
- ✅ Key Query 统计页面
- ✅ 个人使用统计
- ✅ 排行榜
- ✅ 使用趋势分析

### 数据持久化
- ✅ SQLite 数据库
- ✅ 自动备份（每周日凌晨 2:00）
- ✅ 备份恢复功能

## 安装说明

### 方式一：一键安装（推荐）

```bash
# 下载并解压
wget https://dl.xunsu.app/xunsu-gemini-proxy-v1.2.tar.gz
tar -xzf xunsu-gemini-proxy-v1.2.tar.gz
cd gemini-proxy

# 运行安装脚本
sudo bash install.sh
```

安装脚本会自动完成：
- 安装 Node.js、Nginx、Certbot
- 部署应用
- 配置 systemd 服务
- 配置 Nginx 反向代理
- 申请 Let's Encrypt SSL 证书

### 方式二：手动安装

详细步骤请参考 `DEPLOYMENT.md` 文档。

## 配置说明

### 环境变量 (.env)

```env
PORT=3001

# Session 密钥（请修改为随机字符串）
SESSION_SECRET=your-random-secret-key-here

# 管理员密钥（用于 API 接口）
ADMIN_KEY=your-admin-api-key-here

# 负载均衡策略
LOAD_BALANCE_STRATEGY=least-used

# 每个账户每分钟最大请求数
MAX_REQUESTS_PER_MINUTE=10
```

### 虚拟货币配置

默认配置：
- **单价**: 0.00001 ¥/token
- **单位**: ¥

可在管理后台的设置页面修改。

## 使用说明

### 访问地址

- **主页**: https://your-domain.com
- **管理后台**: https://your-domain.com/dashboard
- **API 端点**: https://your-domain.com/v1/chat/completions
- **公开统计**: https://your-domain.com/key-query

### 首次使用

1. 访问管理后台
2. 创建管理员账户
3. 添加 Google 账户
4. 创建 API Keys
5. 测试 API 功能

### API 调用示例

```bash
curl https://your-domain.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-pro",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

## 管理命令

### 服务管理

```bash
# 查看状态
systemctl status gemini-proxy

# 启动服务
systemctl start gemini-proxy

# 停止服务
systemctl stop gemini-proxy

# 重启服务
systemctl restart gemini-proxy

# 查看日志
journalctl -u gemini-proxy -f
```

### 数据库备份

```bash
# 手动备份
cd /opt/gemini-proxy
node src/backup.js backup

# 列出备份
node src/backup.js list

# 恢复备份
node src/backup.js restore <backup_file>
```

## 文档

### 部署文档
- `DEPLOYMENT.md` - 完整部署手册
- `QUICK_DEPLOY.md` - 快速部署指南
- `install.sh` - 一键安装脚本

### 功能文档
- `LOGIN_INFO.md` - 登录信息
- `DATABASE_BACKUP.md` - 数据库备份说明
- `PUBLIC_STATS.md` - 公开统计页面说明
- `CURRENCY_FEATURE.md` - 虚拟货币功能

### 技术文档
- `MULTI-ACCOUNT.md` - 多账户管理
- `SSL_CERTIFICATE.md` - SSL 证书配置
- `README.md` - 项目说明

## 技术栈

- **后端**: Node.js 20.x + Express
- **数据库**: SQLite 3
- **模板引擎**: EJS
- **前端**: Bootstrap 5 + Chart.js
- **反向代理**: Nginx
- **SSL**: Let's Encrypt
- **进程管理**: systemd
- **定时任务**: node-cron

## 安全建议

1. **首次部署后**:
   - 修改管理员密码
   - 修改 .env 中的密钥
   - 配置强密码策略

2. **定期维护**:
   - 检查日志异常
   - 更新系统和依赖
   - 备份数据库

3. **监控**:
   - 设置证书到期提醒
   - 监控服务运行状态
   - 监控磁盘空间

## 更新日志

### v1.2 (2026-03-06)

**新功能**:
- ✅ 虚拟货币计费系统
- ✅ 统计页面优化（移除 API Key 显示）
- ✅ 仪表盘添加消费金额统计
- ✅ 配置动态更新

**改进**:
- ✅ 修复 HTTPS 反向代理 Session 问题
- ✅ 修复登录认证问题
- ✅ 优化 API Key 创建流程
- ✅ 增强安全性（Admin API Key 加密）

**文档**:
- ✅ 完整的部署文档
- ✅ 一键安装脚本
- ✅ 故障排查指南

## 支持

- **文档**: https://dl.xunsu.app/
- **问题反馈**: 请查看项目文档或联系管理员

## 许可证

MIT License

---

**版本**: v1.2  
**发布日期**: 2026-03-06  
**下载地址**: https://dl.xunsu.app/xunsu-gemini-proxy-v1.2.tar.gz