ntfy — El mensajero discreto¶

Te avisa cuando algo requiere tu atención, pero solo cuando es realmente importante. Las tareas cotidianas no molestan. Las alertas del sistema, la finca y las emergencias llegan aquí.

Como usuario¶

Qué podrás hacer¶

Recibir alertas push en el móvil cuando algo importante ocurre
Suscribirte solo a los topics que te interesan
Ver el historial de notificaciones
Integración con Matrix para recibir alertas en el chat

Cómo se accederá¶

Plataforma	Cómo
Navegador	https://ntfy.sc
Ubuntu	Cliente web
Android	App ntfy desde Google Play o F-Droid
FireTV	No aplica

Primeros pasos (previstos)¶

Instalar app ntfy en Android
Añadir servidor: https://ntfy.sc
Suscribirte a los topics que te interesen: critico, finca, backups, sistema

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Matrix	Bot publica alertas críticas en salas
n8n	Dispara notificaciones
Node-RED	Alertas de sensores
Prometheus	Alertas de métricas
Uptime Kuma	Alertas de disponibilidad
PBS (sistema de copias de seguridad de Proxmox)	Resultados de backup
Grafana	Alertas configuradas

Servicios que lo hacen posible¶

Caddy — proxy reverso

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	191
IP	10.10.20.191
Tier	B
Impacto	🟡 Medio

Docker: binwiederhier/ntfy:latest.

Almacenamiento persistente¶

ZFS (sistema de archivos con integridad de datos): rpool/datos/ntfy → /opt/ntfy/ Subdirectorios: config/ data/ logs/ Backup: PBS diario + ZFS snapshot @15min.

Healthcheck¶

curl https://ntfy.sc/v1/health

Logs y diagnóstico¶

docker logs --tail 100 ntfy

Backup manual¶

zfs snapshot rpool/datos/ntfy@manual-$(date +%Y%m%d)

Problemas comunes¶

No llegan notificaciones → Verificar que el topic existe y la app está suscrita.
App no conecta → Verificar VPN (red privada virtual) activa.

Topics: critico (emergencias), backup (resultados de copias), updates (actualizaciones), finca (sensores de campo), sistema (estado general).

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Caddy -->|TLS| ntfy
    n8n -->|HTTP POST| ntfy
    Node-RED -->|HTTP POST| ntfy
    ntfy -->|WebSocket| AppMóvil

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr2	80	Caddy (LXC 102)

En Pi-hole¶

ntfy.sc  →  10.10.20.191

En Caddy¶

ntfy.sc {
    reverse_proxy 10.10.20.191:80
}

Sin forward_auth — ntfy usa token-based auth interna.

En Authentik¶

No. ntfy gestiona sus propios tokens de acceso.

Orquestación¶

Componente	Path
Rol Ansible	`roles/ntfy/`
Playbook	`deploy-ntfy.yml`
Módulo OpenTofu	`modules/ntfy/`
Semaphore	Proyecto `ntfy`
Forgejo Actions	`.forgejo/workflows/ntfy.yml`
Repo Forgejo	`infra-core/`
Ficha versionada	`docs/fichas/programas/ntfy.md`

Los topics son el mecanismo de enrutamiento: cada servicio publica en su topic designado. La app móvil usa WebSocket para recibir notificaciones en tiempo real.

Secciones relacionadas¶

🌐 Enlaces de interés¶

Sitio oficial · Documentación · GitHub