# 🤖 API Gateway Manager
**基于 Next.js 的 AI API 中转站管理系统**
支持多用户、API 站点管理、模型测试与统一认证
## 📌 系统介绍
这是一个功能完整的 AI API 中转站管理系统，基于 Next.js 构建，提供多用户支持、API 站点管理、模型测试和统一认证等功能。
---
## ✨ 功能特点
### 🔐 认证系统
- **双系统登录**：用户系统 + 管理员系统
- **统一会话管理**：管理员可无缝切换用户/管理系统
- **JWT 认证**：安全的令牌验证机制
- **自动跳转**：智能识别用户身份并跳转到对应系统
### 🚀 API 管理
- **多站点支持**：管理多个 AI API 中转站
- **自动检测**：自动检查 API 站点可用性（通过获取模型列表）
- **模型列表**：自动获取支持的 AI 模型
- **额度查询**：实时查询 API 使用额度（目前仅限 newapi）
- **批量测试**：支持批量测试模型响应
### 📊 仪表盘
- **可视化统计**：图表展示站点状态统计
- **实时监控**：显示可用/失效站点数量
- **使用情况**：展示 API 调用统计数据
### 👥 用户管理
- **角色管理**：区分普通用户和管理员
- **个人设置**：支持个人信息修改
- **聊天集成**：快速跳转到聊天应用
### 🎨 界面设计
- **响应式布局**：完美支持 PC 和移动端
- **现代化 UI**：基于 TailwindCSS 构建
- **实时搜索**：模型列表支持模糊搜索
- **Toast 提示**：友好的操作反馈
### 🏆 多平台部署
- **支持 Vercel 一键部署**
- **支持服务器手动部署**
- **支持 Docker 部署**
---
## ⭐ 系统演示
- [抱脸docker演示](https://g2i-ai-manager.hf.space)
- [vercel演示](https://aigl.vercel.app)
- hf和vercel账户数据互通
- 体验用户账号密码：linuxdo/linuxdo
## 🛠️ 快速开始
### 环境要求
- Node.js 18+（Vercel）
- MySQL 5.7+
- 现代浏览器
### 服务器部署
```bash
# 1. 克隆项目
git clone
cd ai-api-gateway
# 2. 安装依赖
npm install
# 3. 配置环境变量
# 格式如下：
MYSQL_DNS=mysql://username:password@host:port/database?ssl=true
ADMIN_USERNAME=admin
ADMIN_PASSWORD=admin123
JWT_SECRET=your-jwt-secret
# 4. 启动应用
npm run dev
```
Vercel 部署
1. 克隆项目
2. 打开 vercel.com 官网
3. 创建并导入该项目
4. 设置 `MYSQL_DNS`、`ADMIN_USERNAME`、`ADMIN_PASSWORD`、`JWT_SECRET` 环境变量
5. 部署并设置自定义域名
Docker 部署
方法 1：使用 `docker run`（端口 3000）
```bash
docker run -d \
--name api-gateway-manager \
-e MYSQL_DNS="mysql://username:password@host:port/database?ssl=true" \
-e ADMIN_USERNAME="admin" \
-e ADMIN_PASSWORD="admin123" \
-e JWT_SECRET="your-jwt-secret" \
-p 3000:3000 \
ghcr.io/eraycc/api-gateway-manager:latest
```
方法 2：使用 Docker Compose（推荐）
创建 `docker-compose.yml` 文件：
```yaml
version: '3.8'
services:
api-gateway-manager:
image: ghcr.io/eraycc/api-gateway-manager:latest
container_name: api-gateway-manager
environment:
- MYSQL_DNS=mysql://username:password@host:port/database?ssl=true
- ADMIN_USERNAME=admin
- ADMIN_PASSWORD=admin123
- JWT_SECRET=your-jwt-secret
ports:
- "3000:3000"
restart: unless-stopped
```
运行命令：
```bash
docker-compose up -d
```
方法 3：使用huggingface 抱脸 duplicate一键部署
访问[hf抱脸](https://huggingface.co/spaces/g2i/Ai-Manager?duplicate=true)样板房，点击duplicate复制空间，设置修改环境变量即可
默认账户
- 管理员账户：`admin` / `admin123`
- 首次运行：系统会自动创建数据库表和默认管理员
---
🏗️ 系统架构
数据库表结构
- `users` - 用户信息表
- `admins` - 管理员表
- `stations` - API 站点表
- `settings` - 系统设置表
- `user_stations` - 用户站点关联表
核心功能模块
1. 认证系统
```typescript
// 用户登录 → 用户系统
// 管理员登录 → 管理系统
// 统一会话，无缝切换
```
2. API 站点管理
- 添加/编辑/删除 API 站点
- 自动获取模型列表
- 检查站点可用性
- 查询使用额度
3. 模型测试
- 支持流式/非流式响应
- 多模型批量测试
- 实时结果展示
4. 统计监控
- 站点状态统计
- 使用情况分析
- 可视化图表展示
---
📖 使用指南
用户系统
1. 注册/登录：创建账户或使用现有账户登录
2. 管理 API 站点：添加和管理你的 AI API 中转站
3. 测试模型：选择模型进行实时测试
4. 查看统计：在仪表盘查看使用情况
管理员系统
1. 管理员登录：使用管理员账户登录
2. 用户管理：查看和管理所有用户
3. 系统监控：查看全局统计信息
4. 系统设置：配置系统参数
API 站点配置
添加 API 站点时需要提供：
- 站点名称
- API 地址
- API 密钥
- 可选参数
---
💻 开发特性
技术栈
- 前端：Next.js 14, React, TypeScript
- 样式：TailwindCSS
- 数据库：MySQL + Drizzle ORM
- 认证：JWT + Session
- HTTP 客户端：Axios
部分代码结构
```
src/
├── app/ # Next.js App Router
│ ├── admin/ # 管理员系统
│ ├── dashboard/ # 用户仪表盘
│ ├── api/ # API 路由
│ └── auth/ # 认证相关
├── components/ # React 组件
│ ├── ui/ # 通用 UI 组件
│ └── features/ # 功能组件
└── lib/ # 工具库
├── auth.ts # 认证工具
└── db.ts # 数据库配置
```
---
🔧 故障排除
常见问题
1. 数据库连接失败
- 检查 `MYSQL_DNS` 环境变量
- 确认 MySQL 服务运行正常
- 验证数据库权限
2. 登录问题
- 清除浏览器缓存
- 检查网络连接
- 确认账户密码正确
3. API 测试失败
- 检查 API 地址和密钥
- 确认网络连通性
- 验证 API 服务状态
日志查看
系统会在控制台输出详细的运行日志，包括：
- 数据库连接状态
- 认证过程
- API 调用详情
- 错误信息
---
🤝 贡献指南
欢迎提交 Issue 和 Pull Request 来帮助改进这个项目