NewAPI-Tool 是一个专为 NewAPI (One API 分支) 设计的现代化增强管理中间件。它通过直观的 Web 界面，补全了原版系统在数据可视化、充值记录审计、批量兑换码管理等方面的功能，帮助管理员更高效地运维系统。
-
📊 可视化仪表盘 (Dashboard)
- 实时概览：用户数、Token、渠道、模型、兑换码等关键指标一目了然。
- 趋势分析：基于 ECharts/Recharts 的每日请求量、活跃用户趋势图。
- 排行统计：请求之王、消费榜首等趣味统计。
- 模型分布：Top 8 活跃模型使用占比分析。
-
🎟️ 兑换码增强管理
- 批量生成：支持自定义前缀、固定/随机额度、过期时间（天数/指定日期）。
- 高级筛选：按状态（未使用/已使用/过期）、日期范围、名称搜索。
- 统计卡片：顶部直观展示未使用、已使用、已过期的数量及总价值。
- 批量操作：一键复制、批量删除、软删除机制。
-
💰 充值记录审计
- 全量记录：查看系统内所有用户的充值历史。
- 财务统计：统计成功、待处理、失败的充值笔数及总金额（CNY/USD）。
- 支付分析：支持按支付方式筛选，快速定位支付渠道状态。
-
🛡️ 安全与架构
- 独立认证：拥有独立的管理后台登录机制，支持 JWT Session。
- 零侵入性：作为中间件运行，直接读取 NewAPI 数据库，不修改原版代码。
- 多数据库支持：完美支持 MySQL 和 PostgreSQL。
如果您的 NewAPI 部署在 Linux 服务器上，可以使用一键脚本自动检测环境并部署。
bash <(curl -sSL https://raw.githubusercontent.com/james-6-23/new_api_tools/main/install.sh)脚本功能：
- 自动定位 NewAPI 安装目录
- 自动读取数据库配置
- 交互式设置管理员密码
- 自动配置 Docker 网络并启动服务
适用于熟悉 Docker 的用户或非标准环境。
-
下载项目
git clone https://github.com/james-6-23/new_api_tools.git cd new_api_tools -
配置环境变量
cp .env.example .env vim .env
请参考下方配置说明填写数据库信息。
-
启动服务
docker-compose up -d
部署完成后访问：
http://your-server-ip:1145
| 变量名 | 说明 | 示例/默认值 |
|---|---|---|
| 基础配置 | ||
FRONTEND_PORT |
服务访问端口 | 1145 |
ADMIN_PASSWORD |
管理后台登录密码 | 123456 |
API_KEY |
后端 API 密钥（可选） | - |
JWT_SECRET |
JWT 签名密钥 | random_string |
JWT_EXPIRE_HOURS |
JWT 过期时间（小时） | 24 |
| 数据库配置 | ||
DB_ENGINE |
数据库类型 | postgres 或 mysql |
DB_DNS |
数据库地址 (Docker网络名或IP) | new-api-db |
DB_PORT |
数据库端口 | 5432 或 3306 |
DB_NAME |
数据库名称 | new-api |
DB_USER |
数据库用户名 | postgres |
DB_PASSWORD |
数据库密码 | - |
| Redis 缓存配置 | ||
REDIS_HOST |
Redis 服务地址 | redis（Docker内部） |
REDIS_PORT |
Redis 端口 | 6379 |
REDIS_PASSWORD |
Redis 密码（可选） | 留空或设置密码 |
REDIS_DB |
Redis 数据库编号 | 0 |
| Docker配置 | ||
NEWAPI_NETWORK |
NewAPI 所在的 Docker 网络名称 | new-api_default |
cd backend
# 推荐使用 uv 进行依赖管理
uv sync
# 启动开发服务器
uv run uvicorn app.main:app --reload --port 8000cd frontend
npm install
# 启动开发服务器
npm run dev后端启动后，可访问 http://localhost:8000/docs 查看完整的 Swagger API 文档。
主要端点：
POST /api/auth/login: 管理员登录GET /api/dashboard/*: 仪表盘数据聚合GET /api/top-ups: 充值记录查询POST /api/redemptions/generate: 生成兑换码GET /api/redemptions/statistics: 兑换码统计
欢迎提交 Issue 和 Pull Request！
MIT License