# @comms-id/relay 中文文档

规范地址：https://npmcn.com/package/%40comms-id/relay/

版本：0\.1\.0
npm 元数据更新时间：2026-10-31T19:46:10.501Z
中文译文更新时间：2026-10-31T20:44:47.711Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40comms-id/relay
原文对照：https://npmcn.com/package/%40comms-id/relay/?lang=original
项目主页：https://comms.id/
源码仓库：https://github.com/comms-id/platform

弃用说明：Removed\. Use public visitor mode: the pk attribute on each Comms\.ID live element \(cdn\.comms\.id/\<product\>/latest\.js\)\. Nothing to install\.

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

- 包体积（解压后）：14.1 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-03T01:07:52.358Z
- 最新版本发布：2026-10-03T01:07:52.666Z
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

通信的服务器中继。ID产品：你的后端转发你自己的用户请求，作为你注册的应用程序签名

## 安装

```sh
npm install @comms-id/relay
```

也可以使用：`pnpm add @comms-id/relay`、`yarn add @comms-id/relay`、`bun add @comms-id/relay`

## README

# @comms-id /继电器

将您自己用户的请求转发到Comms。ID产品从您自己的服务器。你的服务器 将每个呼叫签名为您已注册的应用程序，因此浏览器永远不会持有凭证。

```ts
// app/api/comms-id/[product]/[operation]/route.ts (Next.js)
import { createNextRelay } from "@comms-id/relay/next";
import { addressProduct } from "@comms-id/address/descriptor";

export const { POST } = createNextRelay({
  products: [addressProduct],
  // Your rule: who may use this route. Return true, false (401), or your own Response.
  allow: async (request) => isSignedIn(request),
  signer,
});
```

```ts
// Hono
import { relayHandler } from "@comms-id/relay/hono";

app.post("/comms-id/:product/:operation", relayHandler({ products: [addressProduct], allow, signer }));
```

中继只到达您的产品描述符列出的操作。它不前进 任何其他路径，它不会发送您的用户的cookie或 `Authorization` 头到通信id。

专有软件;看到 [许可证](https://npmcn.com/package/%40comms-id/relay/LICENSE).

## 常见问题

### @comms-id/relay 是什么？

通信的服务器中继。ID产品：你的后端转发你自己的用户请求，作为你注册的应用程序签名注意：该包已被作者标记为弃用——Removed\. Use public visitor mode: the pk attribute on each Comms\.ID live element \(cdn\.comms\.id/\<product\>/latest\.js\)\. Nothing to install\.

### 如何安装 @comms-id/relay？

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

### @comms-id/relay 支持 TypeScript 吗？

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

### @comms-id/relay 支持 ESM 还是 CommonJS？

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

### @comms-id/relay 可以商用吗？

@comms-id/relay 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @comms-id/relay 还在维护吗？

最新版本 0\.1\.0 发布于 2026/10/03（1 个月前）；至今共发布 1 个版本，其中过去 12 个月发布了 1 个；首次发布于 2026/10/03。作者已将其标记为弃用，新项目建议寻找替代方案。