mirror of https://github.com/Wei-Shaw/claude-relay-service.git synced 2026-01-22 16:43:35 +00:00

Files

shaw 12b41ceb25 feat: 添加API Key并发控制和编辑功能

- 新增API Key并发控制功能
  - 创建API Key时可设置并发限制（0为不限制）
  - 在认证中间件中实现并发检查
  - 使用Redis原子操作确保计数准确
  - 添加自动清理机制处理异常情况

- 新增API Key编辑功能
  - 支持修改Token限制和并发限制
  - 前端添加编辑按钮和模态框
  - 后端限制只能修改指定字段

- 其他改进
  - 添加test-concurrency.js测试脚本
  - 添加详细的功能说明文档
  - 所有代码通过ESLint检查

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

2025-07-16 09:48:07 +08:00

2.3 KiB

Raw Blame History

API Key 编辑功能

功能说明

现在支持在管理后台编辑已创建的 API Key，可以修改以下参数：

Token 限制：设置该 API Key 的最大 token 使用量
并发限制：设置该 API Key 可同时处理的最大请求数

使用方法

进入管理后台
- 登录管理后台
- 进入 "API Keys" 标签页
编辑 API Key
- 在 API Key 列表中找到要编辑的项
- 点击 "编辑" 按钮（蓝色铅笔图标）
- 在弹出的编辑框中修改参数：
  - Token 限制：输入数字，0 或留空表示无限制
  - 并发限制：输入数字，0 或留空表示无限制
- 点击 "保存修改" 完成编辑

注意事项

不可修改的字段
- API Key 名称不可修改（显示为灰色禁用状态）
- API Key 的密钥值不可修改
- 描述信息不可修改
参数验证
- Token 限制和并发限制必须为非负整数
- 0 表示无限制
- 留空也表示无限制
即时生效
- 修改保存后立即生效
- 正在进行的请求不受影响
- 新的请求将使用更新后的限制

技术实现

前端部分

在 API Key 列表添加编辑按钮
<EFBFBD><EFBFBD><EFBFBD>建编辑模态框，仅显示可编辑字段
使用 PUT 请求更新 API Key

后端部分

更新路由只接受 tokenLimit 和 concurrencyLimit 参数
严格验证参数类型和范围
使用现有的 apiKeyService.updateApiKey 方法

安全性

需要管理员认证才能编辑
只允许修改限制相关参数
不会暴露敏感信息（如 API Key 值）

API 接口

PUT /admin/api-keys/:keyId
Authorization: Bearer <admin_token>
Content-Type: application/json

{
  "tokenLimit": 1000000,
  "concurrencyLimit": 5
}

响应：

{
  "success": true,
  "message": "API key updated successfully"
}

常见问题

Q: 为什么不能修改 API Key 的名称？ A: 为了保持数据一致性和避免混淆，API Key 创建后名称不可修改。

Q: 修改限制后，已经超过限制的请求会怎样？ A: 已经在处理中的请求不受影响，新的请求将受到新限制的约束。

Q: 可以通过 CLI 或 API 修改吗？ A: 目前仅支持通过管理后台修改，后续可能会添加 CLI 支持。

2.3 KiB Raw Blame History Unescape Escape