Repolode
Enviar
yetone

yetone/alma-relay

Relay autohospedable que permite controlar la app de escritorio de Alma desde la app móvil de Alma mediante una conexión saliente, sin redireccionar puertos ni usar una VPN.

Ver en GitHubSitio web
Estrellas
461
Forks
58
Issues abiertos
0
Último commit
hace 4 días

¿Qué es?

Alma Relay es un relay autohospedado para Alma Remote Access. La app de escritorio inicia una conexión con el relay y la mantiene abierta; el teléfono envía sus solicitudes al relay, que las reenvía al escritorio a través de esa conexión. Se transmite el tráfico HTTP, streaming (SSE) y WebSocket, para que puedas acceder a tu escritorio desde cualquier lugar sin abrir puertos entrantes ni usar una VPN.

Con el cifrado de extremo a extremo habilitado (opción predeterminada para los nuevos emparejamientos), el relay solo gestiona texto cifrado: el teléfono y el escritorio realizan un handshake ECDH y derivan una sesión AES-256-GCM, y el relay no guarda nada en disco. Puede ejecutarse como Cloudflare Worker con Durable Objects en el plan gratuito, como una pila de Docker Compose con HTTPS automático mediante Caddy o como un proceso de Node detrás de tu propio proxy inverso.

Entre las opciones se incluyen una clave de registro o tokens firmados por usuario para limitar quién puede usar el relay, credenciales TURN para la vista en directo del navegador mediante WebRTC y claves APNs para las notificaciones del teléfono.

Funciones clave

  • 01Reenvía tráfico HTTP, streaming SSE y WebSocket del teléfono al escritorio.
  • 02El escritorio se conecta de forma saliente, así que no se necesita redireccionar puertos ni usar una VPN.
  • 03Cifrado de extremo a extremo con sesiones AES-256-GCM; el relay solo ve texto cifrado.
  • 04Se ejecuta en el plan gratuito de Cloudflare Workers, con Docker y HTTPS automático, o como proceso de Node.
  • 05Control de acceso opcional mediante una clave de registro compartida o tokens JWT por usuario.

Casos de uso

  • Controlar desde el teléfono el Alma de tu escritorio en casa cuando estás fuera.
  • Ejecutar un relay en una región más cercana o en una infraestructura que controles.
  • Compartir un relay con un equipo y revocar el acceso de miembros individuales.
  • Usar Alma Remote Access sin depender del relay alojado.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Instala las dependencias

    npm install
  3. 3

    Despliega en Cloudflare Workers (plan gratuito)

    npx wrangler deploy
  4. 4

    O ejecuta localmente la edición de Node en el puerto 8787

    npm start

Antes de usarlo

  • El relay autohospedado no puede enviar notificaciones al teléfono a la aplicación oficial Alma para iOS.
  • Configurar TURN para la vista del navegador en directo requiere configuración adicional y abrir puertos del cortafuegos.
  • Para disfrutar de una protección integral de extremo a extremo, el escritorio debe ejecutar Alma 0.4.329 o posterior.

En colecciones

Apps autoalojadas

Temas

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

Preguntas frecuentes

¿Qué es alma-relay?
Relay autohospedable que permite controlar la app de escritorio de Alma desde la app móvil de Alma mediante una conexión saliente, sin redireccionar puertos ni usar una VPN. Alma Relay es un relay autohospedado para Alma Remote Access. La app de escritorio inicia una conexión con el relay y la mantiene abierta; el teléfono envía sus solicitudes al relay, que las reenvía al escritorio a través de esa conexión. Se transmite el tráfico HTTP, streaming (SSE) y WebSocket, para que puedas acceder a tu escritorio desde cualquier lugar sin abrir puertos entrantes ni usar una VPN.
¿alma-relay es gratuito? ¿Qué licencia tiene?
alma-relay es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿alma-relay sigue mantenido?
Mantenimiento activo. El último commit de alma-relay fue el 2 nov 2026.
¿Para qué puedo usar alma-relay?
Controlar desde el teléfono el Alma de tu escritorio en casa cuando estás fuera. Ejecutar un relay en una región más cercana o en una infraestructura que controles. Compartir un relay con un equipo y revocar el acceso de miembros individuales. Usar Alma Remote Access sin depender del relay alojado.
¿Cómo se instala alma-relay?
Clona el repositorio: git clone https://github.com/yetone/alma-relay && cd alma-relay Instala las dependencias: npm install Despliega en Cloudflare Workers (plan gratuito): npx wrangler deploy O ejecuta localmente la edición de Node en el puerto 8787: npm start
¿Dónde consigo alma-relay?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/yetone/alma-relay

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados