Repolode
Enviar
yetone

yetone/alma-relay

Relay auto-hospedável que permite controlar o app Alma para desktop pelo app Alma para celular usando uma conexão de saída, sem redirecionamento de portas ou VPN.

Ver no GitHubSite
Estrelas
471
Forks
64
Issues abertas
0
Último commit
há 5 dias

O que é?

O Alma Relay é um relay auto-hospedável para o Alma Remote Access. O app para desktop inicia uma conexão com o relay e a mantém aberta; o celular envia as solicitações ao relay, que as encaminha ao desktop por essa conexão. Todo o tráfego HTTP, streaming (SSE) e WebSocket é encaminhado, para que você acesse seu desktop de qualquer lugar sem abrir portas de entrada nem usar VPN.

Com a criptografia ponta a ponta ativada (o padrão para novos pareamentos), o relay só lida com texto cifrado: o celular e o desktop fazem um handshake ECDH e derivam uma sessão AES-256-GCM, e o relay não armazena nada em disco. Ele pode ser executado como Cloudflare Worker com Durable Objects no plano gratuito, como uma stack Docker Compose com HTTPS automático via Caddy ou como um processo Node simples atrás do seu próprio reverse proxy.

As configurações opcionais incluem uma chave de registro ou tokens assinados por usuário para limitar quem pode usar o relay, credenciais TURN para visualização ao vivo no navegador via WebRTC e chaves APNs para notificações no celular.

Recursos principais

  • 01Encaminha tráfego HTTP, streaming SSE e WebSocket do celular para o desktop.
  • 02O desktop se conecta de saída, sem necessidade de redirecionamento de portas ou VPN.
  • 03Criptografia ponta a ponta com sessões AES-256-GCM; o relay só vê texto cifrado.
  • 04Funciona no plano gratuito do Cloudflare Workers, em Docker com HTTPS automático ou com Node simples.
  • 05Controle de acesso opcional por chave de registro compartilhada ou tokens JWT por usuário.

Casos de uso

  • Controlar pelo celular o Alma no desktop de casa enquanto você está fora.
  • Executar um relay em uma região mais próxima de você ou em uma infraestrutura sob seu controle.
  • Compartilhar um relay com uma equipe e revogar o acesso de integrantes individualmente.
  • Usar o Alma Remote Access sem depender do relay hospedado.

Início rápido

  1. 1

    Clone o repositório

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

    Instale as dependências

    npm install
  3. 3

    Implante no Cloudflare Workers (plano gratuito)

    npx wrangler deploy
  4. 4

    Ou execute localmente a edição Node na porta 8787

    npm start

Antes de usar

  • O relay auto-hospedado não pode enviar notificações para o celular ao app oficial Alma para iOS.
  • Configurar o TURN para a visualização ao vivo no navegador exige configuração adicional e a abertura de portas no firewall.
  • Para ter proteção completa de ponta a ponta, o desktop precisa executar o Alma 0.4.329 ou posterior.

Em coleções

Apps auto-hospedados

Tópicos

#remote-access#relay#websocket#end-to-end-encryption#self-hosted#cloudflare-workers#docker

Perguntas frequentes

O que é alma-relay?
Relay auto-hospedável que permite controlar o app Alma para desktop pelo app Alma para celular usando uma conexão de saída, sem redirecionamento de portas ou VPN. O Alma Relay é um relay auto-hospedável para o Alma Remote Access. O app para desktop inicia uma conexão com o relay e a mantém aberta; o celular envia as solicitações ao relay, que as encaminha ao desktop por essa conexão. Todo o tráfego HTTP, streaming (SSE) e WebSocket é encaminhado, para que você acesse seu desktop de qualquer lugar sem abrir portas de entrada nem usar VPN.
alma-relay é gratuito? Qual é a licença?
alma-relay é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
alma-relay ainda é mantido?
Manutenção ativa. O último commit de alma-relay foi em 2 de nov. de 2026.
Para que posso usar alma-relay?
Controlar pelo celular o Alma no desktop de casa enquanto você está fora. Executar um relay em uma região mais próxima de você ou em uma infraestrutura sob seu controle. Compartilhar um relay com uma equipe e revogar o acesso de integrantes individualmente. Usar o Alma Remote Access sem depender do relay hospedado.
Como instalar alma-relay?
Clone o repositório: git clone https://github.com/yetone/alma-relay && cd alma-relay Instale as dependências: npm install Implante no Cloudflare Workers (plano gratuito): npx wrangler deploy Ou execute localmente a edição Node na porta 8787: npm start
Onde consigo alma-relay?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yetone/alma-relay

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados