mirror of
https://github.com/router-for-me/CLIProxyAPIPlus.git
synced 2026-03-08 06:43:41 +00:00
- Add IAM Identity Center (IDC) authentication with CLI flags (--kiro-idc-login, --kiro-idc-start-url, --kiro-idc-region) and login flow - Add ProfileArn auto-fetching in Execute/ExecuteStream for imported IDC accounts - Simplify endpoint preference with map-based alias lookup and getAuthValue helper - Redesign fingerprint as global singleton with external config and per-account deterministic generation - Add StartURL and FingerprintConfig fields to Kiro config - Add AgentContinuationID/AgentTaskType support in Kiro translators - Add comprehensive tests for executor, fingerprint, SSO OIDC, and AWS helpers - Add CLI login documentation to README
4.2 KiB
4.2 KiB
CLIProxyAPI Plus
English | 中文
这是 CLIProxyAPI 的 Plus 版本,在原有基础上增加了第三方供应商的支持。
所有的第三方供应商支持都由第三方社区维护者提供,CLIProxyAPI 不提供技术支持。如需取得支持,请与对应的社区维护者联系。
该 Plus 版本的主线功能与主线功能强制同步。
与主线版本版本差异
- 新增 GitHub Copilot 支持(OAuth 登录),由em4go提供
- 新增 Kiro (AWS CodeWhisperer) 支持 (OAuth 登录), 由fuko2935、Ravens2121提供
新增功能 (Plus 增强版)
- OAuth Web 认证: 基于浏览器的 Kiro OAuth 登录,提供美观的 Web UI
- 请求限流器: 内置请求限流,防止 API 滥用
- 后台令牌刷新: 过期前 10 分钟自动刷新令牌
- 监控指标: 请求指标收集,用于监控和调试
- 设备指纹: 设备指纹生成,增强安全性
- 冷却管理: 智能冷却机制,应对 API 速率限制
- 用量检查器: 实时用量监控和配额管理
- 模型转换器: 跨供应商的统一模型名称转换
- UTF-8 流处理: 改进的流式响应处理
Kiro 认证
命令行登录
注意: 由于 AWS Cognito 限制,Google/GitHub 登录不可用于第三方应用。
AWS Builder ID(推荐):
# 设备码流程
./CLIProxyAPI --kiro-aws-login
# 授权码流程
./CLIProxyAPI --kiro-aws-authcode
从 Kiro IDE 导入令牌:
./CLIProxyAPI --kiro-import
获取令牌步骤:
- 打开 Kiro IDE,使用 Google(或 GitHub)登录
- 找到令牌文件:
~/.kiro/kiro-auth-token.json - 运行:
./CLIProxyAPI --kiro-import
AWS IAM Identity Center (IDC):
./CLIProxyAPI --kiro-idc-login --kiro-idc-start-url https://d-xxxxxxxxxx.awsapps.com/start
# 指定区域
./CLIProxyAPI --kiro-idc-login --kiro-idc-start-url https://d-xxxxxxxxxx.awsapps.com/start --kiro-idc-region us-west-2
附加参数:
| 参数 | 说明 |
|---|---|
--no-browser |
不自动打开浏览器,打印 URL |
--no-incognito |
使用已有浏览器会话(Kiro 默认使用无痕模式),适用于需要已登录浏览器会话的企业 SSO 场景 |
--kiro-idc-start-url |
IDC Start URL(--kiro-idc-login 必需) |
--kiro-idc-region |
IDC 区域(默认:us-east-1) |
--kiro-idc-flow |
IDC 流程类型:authcode(默认)或 device |
网页端 OAuth 登录
访问 Kiro OAuth 网页认证界面:
http://your-server:8080/v0/oauth/kiro
提供基于浏览器的 Kiro (AWS CodeWhisperer) OAuth 认证流程,支持:
- AWS Builder ID 登录
- AWS Identity Center (IDC) 登录
- 从 Kiro IDE 导入令牌
Docker 快速部署
一键部署
# 创建部署目录
mkdir -p ~/cli-proxy && cd ~/cli-proxy
# 创建 docker-compose.yml
cat > docker-compose.yml << 'EOF'
services:
cli-proxy-api:
image: eceasy/cli-proxy-api-plus:latest
container_name: cli-proxy-api-plus
ports:
- "8317:8317"
volumes:
- ./config.yaml:/CLIProxyAPI/config.yaml
- ./auths:/root/.cli-proxy-api
- ./logs:/CLIProxyAPI/logs
restart: unless-stopped
EOF
# 下载示例配置
curl -o config.yaml https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml
# 拉取并启动
docker compose pull && docker compose up -d
配置说明
启动前请编辑 config.yaml:
# 基本配置示例
server:
port: 8317
# 在此添加你的供应商配置
更新到最新版本
cd ~/cli-proxy
docker compose pull && docker compose up -d
贡献
该项目仅接受第三方供应商支持的 Pull Request。任何非第三方供应商支持的 Pull Request 都将被拒绝。
如果需要提交任何非第三方供应商支持的 Pull Request,请提交到主线版本。
许可证
此项目根据 MIT 许可证授权 - 有关详细信息,请参阅 LICENSE 文件。