pulseweaver-heartbeat-client
Cliente multiplataforma en Kotlin Multiplatform para mantener dispositivos accesibles en un servidor PulseWeaver al cambiar de red mediante heartbeats periódicos.
Ficha actualizada 22 sept 2026, 15:29 · upstream 21 sept 2026, 20:12 · release v1.4.0
Qué es pulseweaver-heartbeat-client
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
PulseWeaver Heartbeat Client es una herramienta diseñada para reportar periódicamente la dirección IP actual del dispositivo a un servidor PulseWeaver, asegurando que las políticas de acceso auto-alojadas sigan al usuario aunque su dirección cambie. El repositorio ofrece tres implementaciones distintas: una aplicación nativa multiplataforma (Companion), un contenedor Docker ligero y una solución DIY basada en curl para usuarios avanzados.
La aplicación Companion, escrita en Kotlin Multiplatform, es la opción recomendada para teléfonos y ordenadores portátiles. Se ejecuta en segundo plano, re-anuncia automáticamente una nueva dirección cuando el usuario cambia de red y permite el emparejamiento mediante un código único sin necesidad de manejar claves manualmente. Está disponible para Android, iOS, macOS, Windows y Linux.
Para entornos headless o servidores que ya utilizan Docker, existe una imagen contenedor minimalista que envía heartbeats en un intervalo configurado. Alternativamente, la opción DIY permite usar curl impulsado por un scheduler externo (cron, systemd), ideal para cajas sin interfaz gráfica donde se desea control total sobre la programación y el entorno de ejecución.
- Uso en dispositivos móviles o portátiles que cambian frecuentemente de red (roaming), donde la aplicación Companion detecta automáticamente los cambios de red y re-anuncia la IP inmediatamente.
- Despliegue en servidores headless o NAS que ya utilizan Docker, aprovechando el contenedor ligero sin necesidad de una interfaz gráfica adicional.
- Automatización en máquinas virtuales o servidores antiguos mediante scripts cron con curl para usuarios avanzados que prefieren control total sobre la programación de las peticiones.
- Integración en entornos de red empresarial donde los dispositivos necesitan mantenerse autorizados dinámicamente sin intervención manual constante.
- Soporte multiplataforma real (Android, iOS, macOS, Windows, Linux) gracias a Kotlin Multiplatform.
- Detección automática de cambios de red en el cliente Companion, re-anunciando la IP inmediatamente sin esperar al siguiente intervalo programado.
- Licencia MIT permisiva para el cliente, fomentando integraciones de terceros y auditoría del código fuente.
- La versión Docker no es consciente de cambios de red inmediatos; requiere un reinicio o espera al próximo intervalo programado para actualizar la IP tras un cambio de red.
- El método DIY con curl exige configuración manual del scheduler y manejo de claves API, lo que lo hace menos adecuado para usuarios sin conocimientos técnicos.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendación: Priorizar la aplicación Companion en dispositivos móviles o portátiles por su capacidad de detección de red nativa y emparejamiento sencillo mediante código. En servidores headless o entornos Docker existentes, usar el contenedor es viable siempre que no sea crítico cambiar de red frecuentemente. Para usuarios avanzados con control total del sistema, la opción curl con cron/systemd ofrece máxima flexibilidad pero requiere mantenimiento manual de las peticiones y claves.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.