yetone/alma-relay

这是什么？

核心功能

• 01将手机端的 HTTP、SSE 流式输出和 WebSocket 请求转发到桌面端。
• 02桌面端主动向外连接，无需端口转发或 VPN。
• 03支持端到端加密，会话使用 AES-256-GCM，中继只能看到密文。
• 04可部署在 Cloudflare Workers 免费套餐、Docker（自动 HTTPS）或普通 Node 进程上。
• 05可通过共享注册密钥或按用户签发的 JWT Token 限制访问。

适用场景

• 外出时用手机远程操控家里或办公室的桌面 Alma。
• 在离自己更近的地区或自有基础设施上运行中继。
• 与团队共用一个中继，并可单独撤销某位成员的访问权限。
• 不依赖官方托管中继，自主运行 Alma 远程访问。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/yetone/alma-relay && cd alma-relay
2. 2

   安装依赖

   npm install
3. 3

   部署到 Cloudflare Workers（免费套餐）

   npx wrangler deploy
4. 4

   或在本地以 Node 版本运行，端口 8787

   npm start

使用前须知

• !自建中继无法向官方 Alma iOS 应用发送手机通知。
• !要使用实时浏览器视图，需要额外配置 TURN 服务器并开放防火墙端口。
• !要获得完整的端到端加密保护，桌面端需运行 Alma 0.4.329 或更高版本。

收录于专题

标签

常见问题

alma-relay 是什么？

可自托管的中继服务，让手机上的 Alma 应用无需端口转发或 VPN 即可远程控制桌面端 Alma。 Alma Relay 是 Alma Remote Access 的自托管中继服务。桌面端主动向中继建立并保持连接，手机把请求发到中继，再由中继通过该连接转发给桌面端，支持普通 HTTP、流式输出（SSE）和 WebSocket。无需开放入站端口，也不需要 VPN，即可在任何地方访问自己的桌面 Alma。

alma-relay 可以免费使用吗？用的什么许可证？

alma-relay 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

alma-relay 还在维护吗？

活跃维护中。alma-relay 最近一次提交是在 2026年11月2日。

alma-relay 适合用来做什么？

外出时用手机远程操控家里或办公室的桌面 Alma。 在离自己更近的地区或自有基础设施上运行中继。 与团队共用一个中继，并可单独撤销某位成员的访问权限。 不依赖官方托管中继，自主运行 Alma 远程访问。

alma-relay 怎么安装和运行？

克隆仓库: git clone https://github.com/yetone/alma-relay && cd alma-relay 安装依赖: npm install 部署到 Cloudflare Workers（免费套餐）: npx wrangler deploy 或在本地以 Node 版本运行，端口 8787: npm start

在哪里获取 alma-relay？

源代码和安装说明在 GitHub 上：https://github.com/yetone/alma-relay