# @agent-relay/credential-proxy 中文文档

规范地址：https://npmcn.com/package/%40agent-relay/credential-proxy/

版本：7\.1\.1
npm 元数据更新时间：2026-05-25T06:54:01.758Z
中文译文更新时间：2026-11-06T08:04:53.046Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agent-relay/credential-proxy
原文对照：https://npmcn.com/package/%40agent-relay/credential-proxy/?lang=original
项目主页：https://github.com/AgentWorkforce/relay#readme
源码仓库：https://github.com/AgentWorkforce/relay

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：96.9 kB，46 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-04-22T07:26:37.631Z
- 最新版本发布：2026-05-25T06:54:01.429Z
- 近 30 天下载量：3991（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

上游LLM供应商的JWT认证证书代理

## 安装

```sh
npm install @agent-relay/credential-proxy
```

也可以使用：`pnpm add @agent-relay/credential-proxy`、`yarn add @agent-relay/credential-proxy`、`bun add @agent-relay/credential-proxy`

## README

# @ agent-relay/ creditial- 代理服务器

上游LLM供应商的JWT认证认证代理. 让我们的沙盒 代理调用提供者 API( OpenAI, Anthropic, OpenRouter) 而不给定 原始供应商证书——代理机持有钥匙,代理机按会场显示 JWTs,和代理执行每个证书符号预算.

## 这是什么

一个Hono应用程序加上几个帮手:

-   `createCredentialProxyApp(options)` ——挂载 HTTP 路由器(`/health`, (中文(简体) ), `/usage`,下面有一个覆盖所有供应商的前进路线 `*`) (中文(简体) ). 用这个 直接在节点(通过) `@hono/node-server`或把它绑入云层 劳工.
-   `mintProxyToken(...)` 编号 : `verifyProxyToken(...)` - JWT的帮助者 [`jose`](https://github.com/panva/jose)HS256 默认,观众 `relay-llm-proxy`。 。 。 .
-   `MeteringCollector` + 键 `checkBudget` - 模拟使用会计 悲观的保留,使同时提出的请求不能绕过宣布的保留 预算.
-   提供方适配器 `providers/` - 将收到的JWT索赔翻译为 更正上游 HTTP 对 OpenAI / Anthropic / OpenRouter 的请求.

## 环境变量

运行时需要( 代理主机) :

| 变量 | 目的 |
| --- | --- |
| `CREDENTIAL_PROXY_JWT_SECRET` | HS256 秘密使用代理来验证每个会场的JWT. |
| `CREDENTIAL_PROXY_ADMIN_JWT_SECRET` | 管理范围符号的秘密(例如 `/usage` 结束点). |
| `CREDENTIAL_PROXY_ADMIN_AUDIENCE` | 观众声称代理机需要管理令牌. |
| `OPENAI_API_KEY` | OpenAI 提供者适配器的上游证书. |
| `ANTHROPIC_API_KEY` | Anthropic供应商适配器的上游证书. |
| `OPENROUTER_API_KEY` | OpenRouter 提供者适配器的上游证书. |

只有您实际转发的提供者密钥需要设置—— 缺少密钥 表面为 `502 credential_unavailable` 在相关路线.

代理方(无论哪一种加工薄荷符号并发射沙盒CLI) 用途 `CREDENTIAL_PROXY_JWT_SECRET` 并把它们放进经纪人的 环境 `CREDENTIAL_PROXY_TOKEN` (别名: `RELAY_LLM_PROXY_TOKEN`+) 加上 (中文(简体) ) `RELAY_LLM_PROXY` 编号 : `RELAY_LLM_PROXY_URL` 所以,SDK's `proxy-env` 帮助者可以 每CLI电线 `OPENAI_BASE_URL` 编号 : `ANTHROPIC_BASE_URL` 超载.

## 使用量

```ts
import { serve } from '@hono/node-server';
import { createCredentialProxyApp } from '@agent-relay/credential-proxy';

const app = createCredentialProxyApp({
  // Defaults to process.env.CREDENTIAL_PROXY_JWT_SECRET / ADMIN_JWT_SECRET.
});

serve({ fetch: app.fetch, port: Number(process.env.PORT ?? 3001) });
```

对于SDK侧线让工作流程代理透明地使用代理, 见 [`@agent-relay/sdk/workflows`代理代理服务器 模块](https://npmcn.com/package/%40agent-relay/sdk/src/workflows/proxy-env.ts) 编辑 `credentialProxy` 打开 `SwarmConfig`。 。 。 .

## 发展

```bash
npm run build      # tsc → dist/
npm run test       # vitest
npm run dev        # builds then runs the proxy on PORT (default 3001)
```

## 常见问题

### @agent-relay/credential-proxy 是什么？

上游LLM供应商的JWT认证证书代理

### 如何安装 @agent-relay/credential-proxy？

在项目目录运行 npm install @agent-relay/credential-proxy，或使用 pnpm add / yarn add / bun add。

### @agent-relay/credential-proxy 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agent-relay/credential-proxy 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agent-relay/credential-proxy 可以商用吗？

@agent-relay/credential-proxy 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-relay/credential-proxy 的下载量有多少？

根据 npm 官方下载统计，@agent-relay/credential-proxy 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,991 次，日均约 133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agent-relay/credential-proxy 还在维护吗？

最新版本 7\.1\.1 发布于 2026/05/25（5 个月前）；至今共发布 48 个版本，其中过去 12 个月发布了 48 个；首次发布于 2026/04/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。