Repolode
nanami-0713

nanami-0713/relay-kit

可自托管的端到端加密中继服务器,部署在 Cloudflare Workers 上,让手机安全访问桌面本地端口。

Star
194
Fork
22
未关闭 Issue
0
最近提交
7天前

这是什么?

relay-kit 是一个介于远程客户端(如手机)与桌面服务之间的中继服务器。中继运行在 Cloudflare Workers 与 Durable Objects 上,只转发密文和路由令牌,解密只发生在两端。配对使用一个 256 位的配对码,同时派生路由令牌和 PAKE 盐值,因此没有配对码,中继也无法完成握手。

仓库包含中继服务端、一个可代理任意本地 HTTP 或 WebSocket 端口的参考 agent,以及一个在隧道上提供 fetch 和 WebSocket 能力的参考客户端。另有基于 Node 的中继实现,用于本地测试或单进程自托管。协议规范见 PROTOCOL.md,核心包仅依赖 WebCrypto,可在 Node 18+、浏览器和 Capacitor WebView 中运行。

项目的协议源自 AI 助手 Alma 的中继设计,与其官方客户端不兼容。默认不包含限流,握手方案也未经过正式审计。

核心功能

  • 01通过一条 wrangler 命令将中继部署到 Cloudflare Workers。
  • 02中继只处理密文和路由令牌,解密仅发生在两端。
  • 03一个配对码同时派生路由令牌和 PAKE 盐值。
  • 04参考 agent 可代理任意本地 HTTP 与 WebSocket 端口。
  • 05核心加密包只依赖 WebCrypto,可运行于 Node 18+ 与浏览器。
  • 06提供 Node 版中继实现,便于本地测试或自托管。

适用场景

  • 在不同网络下,用手机访问桌面上的本地开发服务或 Web 面板。
  • 在自己的 Cloudflare 账户上自托管私有的加密隧道。
  • 依据文档中的 relay-e2e/v1 协议,自行实现 agent 或客户端。

快速上手

  1. 1

    安装依赖

    npm install
  2. 2

    登录你的 Cloudflare 账户(仅需一次)

    npx wrangler login
  3. 3

    进入中继服务器目录

    cd workers/relay
  4. 4

    将中继部署到 Cloudflare Workers

    npx wrangler deploy

使用前须知

  • 握手协议是自研的类 PAKE 方案,尚未经过形式化验证或安全审计。
  • 该协议开箱即用时无法与 Alma 官方客户端互通。
  • *.workers.dev 域名在中国大陆许多网络中被屏蔽,可能需要自定义域名或代理。

收录于专题

标签

常见问题

relay-kit 是什么?
可自托管的端到端加密中继服务器,部署在 Cloudflare Workers 上,让手机安全访问桌面本地端口。 relay-kit 是一个介于远程客户端(如手机)与桌面服务之间的中继服务器。中继运行在 Cloudflare Workers 与 Durable Objects 上,只转发密文和路由令牌,解密只发生在两端。配对使用一个 256 位的配对码,同时派生路由令牌和 PAKE 盐值,因此没有配对码,中继也无法完成握手。
relay-kit 可以免费使用吗?用的什么许可证?
relay-kit 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
relay-kit 还在维护吗?
活跃维护中。relay-kit 最近一次提交是在 2026年11月1日。
relay-kit 适合用来做什么?
在不同网络下,用手机访问桌面上的本地开发服务或 Web 面板。 在自己的 Cloudflare 账户上自托管私有的加密隧道。 依据文档中的 relay-e2e/v1 协议,自行实现 agent 或客户端。
relay-kit 怎么安装和运行?
安装依赖: npm install 登录你的 Cloudflare 账户(仅需一次): npx wrangler login 进入中继服务器目录: cd workers/relay 将中继部署到 Cloudflare Workers: npx wrangler deploy
在哪里获取 relay-kit?
源代码和安装说明在 GitHub 上:https://github.com/nanami-0713/relay-kit

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目