可自托管的中继服务,让手机上的 Alma 应用无需端口转发或 VPN 即可远程控制桌面端 Alma。
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
安装依赖
npm install - 2
登录你的 Cloudflare 账户(仅需一次)
npx wrangler login - 3
进入中继服务器目录
cd workers/relay - 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 数据每日更新。
相关项目
一条命令把本地开发服务器暴露为公网 HTTPS 地址,支持 WebSocket 和热更新,免费且无需账号。
一款命令行工具,用共享的连接码在任意两台电脑之间安全传输文件和文件夹。
可自托管的开源 WebRTC 一对一视频通话平台,支持屏幕共享与端到端加密。
以 Durable Object 为存储单元的 Git 服务器,可部署在 Cloudflare Workers 或自建于 celld。
一个自托管守护进程,可在自己的机器上运行 Cloudflare Workers 应用和 Durable Objects,状态保存在对象存储桶中。