# @dev-anywhere/relay 中文文档

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

版本：0\.10\.10
npm 元数据更新时间：2026-11-09T11:02:56.610Z
中文译文更新时间：2026-11-12T04:50:29.309Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：23.1 MB，360 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.2
- 运行依赖：7 个
- 首次发布：2026-05-08T15:01:19.252Z
- 最新版本发布：2026-11-09T11:02:56.404Z
- 近 30 天下载量：2878（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：216（近 12 个月 216 个）

## 中文简介

DEV 的中继服务器 任何地方——通过WebSocket连接本地AI CLI代理到远程网络客户端.

## 安装

```sh
npm install @dev-anywhere/relay
```

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

## README

# @ dev- anywhere/relay (英语)

合并中继服务器和网络服务器 [`@dev-anywhere/proxy`](https://www.npmjs.com/package/@dev-anywhere/proxy)它为DEV Anywhere Web/PWA客户端服务,并在WebSocket上连接本地AI CLI代理给远程客户端.

## 安装

```bash
npm install -g @dev-anywhere/relay
```

此安装 `dev-anywhere-relay` 全球指挥.

要求节点.js >= 22.22.2.

## 快开始

```bash
# Minimal, plaintext WS on port 3100:
PORT=3100 dev-anywhere-relay

# With auth tokens (recommended for any public relay):
RELAY_PROXY_TOKEN="$(openssl rand -hex 24)" \
RELAY_CLIENT_TOKEN="$(openssl rand -hex 24)" \
PORT=3100 dev-anywhere-relay
```

打开 `http://localhost:3100/` 以装入捆绑的 Web 客户端.

## 终点

| 路径 | 目的 |
| --- | --- |
| `/` | Bundled Web/PWA客户端和SPA线路 |
| `/health` | HTTP 获取——健康探测器 |
| `/status` | HTTP 获取——代理/客户点数 |
| `/api/*` | HTTP API, 远程文件和上传 |
| `/proxy` | WS — 代理守护进程连接 |
| `/client` | WS——Web/PWA客户端连接 |
| `/voice/*` | WS-语音识别和语音综合 |

## 环境变量

| 变量 | 默认 | 页:1 |
| --- | --- | --- |
| `PORT` | `3100` | HTTP + WSS 监听端口 |
| `DATA_DIR` | `~/.dev-anywhere/relay-data` | 持续状态。 设定为空字符串以禁用 . |
| `HEARTBEAT_INTERVAL` | `30000` (单位:百万美元) | WS 调情 |
| `RELAY_PROXY_TOKEN` | 未设置( 打开) `/proxy` 结束点) | 设定时, `/proxy` 没有它就拒绝连接 |
| `RELAY_CLIENT_TOKEN` | 未设置( 打开) `/client` 结束点) | 设定时, `/client` 没有它就拒绝连接 |
| `LOG_LEVEL` | `info` | 皮诺日志级 |

**生产警告:** 总是设置两个 `RELAY_PROXY_TOKEN` 财务报告和审定财务报表 `RELAY_CLIENT_TOKEN`。没有客户签名,任何能够到达中继器的人都可以连接到 `/client`,列出代理,并试图与代理绑定.

对于捆绑的网络客户端,打开应用程序 URL,然后粘贴 `RELAY_CLIENT_TOKEN` 设置 - > 中继键。 该令牌被存储在浏览器- 本地存储中并附加到 `/client` WebSocket连接.

## 电话

这个软件包服务于plain HTTP + WS的完整应用. 用于生产,放入nginx / Caddy / Cloudflare后用于TLS终止. 要安装或升级统包设置(一个多克容器 + nginx + certbot),在 Linux VPS 上作为根运行,替换公有领域/IP:

```bash
curl -fsSL https://raw.githubusercontent.com/lichenxicatapple-blip/dev-anywhere/main/install.sh | bash -s -- dev-anywhere.example.com
```

安装者会拉出最新发布的图像并保存已存在的符号. 关于从macOS、Linux或原生Windows PowerShell的部署,参见 [VPS部署指南](https://github.com/lichenxicatapple-blip/dev-anywhere/blob/main/docs/DEPLOYMENT.md)。不需要复制仓库.

## 在程序上使用嵌入式服务器

```ts
import { createRelayServer } from "@dev-anywhere/relay/server";
import pino from "pino";

const relay = createRelayServer({
  port: 3100,
  logger: pino(),
  proxyToken: process.env.RELAY_PROXY_TOKEN,
  clientToken: process.env.RELAY_CLIENT_TOKEN,
});
```

## 许可证

麻省理工学院 Catli

## 常见问题

### @dev-anywhere/relay 是什么？

DEV 的中继服务器 任何地方——通过WebSocket连接本地AI CLI代理到远程网络客户端\.

### 如何安装 @dev-anywhere/relay？

在项目目录运行 npm install @dev-anywhere/relay，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dev-anywhere-relay，可以用 npx dev-anywhere-relay 直接运行。

### @dev-anywhere/relay 支持 TypeScript 吗？

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

### @dev-anywhere/relay 支持 ESM 还是 CommonJS？

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

### @dev-anywhere/relay 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.22\.2。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dev-anywhere/relay 可以商用吗？

@dev-anywhere/relay 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dev-anywhere/relay 的下载量有多少？

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

### @dev-anywhere/relay 还在维护吗？

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