Notificaciones
Recibe alertas a través de Telegram, ntfy, Gotify, Discord, Webhook o notificaciones del sistema.
Dockerman puede enviar notificaciones a través de múltiples canales para que sepas cuando algo sucede mientras estás lejos de tu escritorio. Los canales usan un esquema de URL compatible con Shoutrrr, el mismo formato usado por Watchtower, Beszel y otras herramientas de homelab.
Canales soportados
| Canal | Formato de URL | Notas |
|---|---|---|
| Telegram | telegram://token@telegram?chats=chat_id | Token de bot de BotFather |
| ntfy | ntfy://ntfy.sh/topic o ntfy://user:pass@ntfy.sh/topic | Autoalojado o ntfy.sh |
| Gotify | gotify://gotify.example.com/token | Servidor Gotify autoalojado |
| Discord | discord://token@id | URL de webhook convertida a formato Shoutrrr |
| Webhook | generic://example.com/webhook | POST JSON genérico a cualquier endpoint |
| Notificación del sistema | Integrado, no se necesita URL | Notificaciones nativas de macOS, Windows y Linux |
Las notificaciones del sistema siempre están disponibles y habilitadas por defecto. No cuentan como un canal "externo".
Agregar un canal de notificación
Abrir configuración de notificaciones
Ve a la página de Notificaciones desde la barra lateral o vía Spotlight.
Agregar un canal
Haz clic en Agregar canal, dale un nombre y pega la URL de Shoutrrr.
Probar el canal
Haz clic en Probar para enviar un mensaje de prueba inmediatamente. Si el mensaje llega, el canal está listo.
Guardar
Guarda el canal. Ahora está disponible para reglas de alerta y monitoreo de actualizaciones de imágenes.
Seguridad de credenciales
Las partes sensibles de la URL de Shoutrrr, como tokens y contraseñas, se almacenan en tu Keychain del sistema (macOS Keychain, Windows DPAPI o Linux Secret Service). La base de datos solo almacena una versión redactada de la URL con secretos reemplazados por marcadores de posición.
Dockerman nunca envía tus credenciales a ningún servidor que no sea el canal de notificación mismo. Las credenciales se leen del Keychain en el momento de envío y nunca se registran en logs.
Dónde se usan las notificaciones
Los canales de notificación son consumidos por dos sistemas:
Reglas de alerta
Cada regla de alerta se vincula a uno o más canales. Cuando la regla se dispara, transmite a todos los canales vinculados.
Monitoreo de actualizaciones de imágenes
Los monitoreos de imágenes usan una lista de canales por defecto global. Cuando se encuentra una nueva versión de imagen, todos los canales por defecto reciben la notificación.
Gestión de canales
Desde la página de Notificaciones puedes:
- Editar el nombre o URL de un canal
- Deshabilitar un canal sin eliminarlo (los canales deshabilitados se omiten durante la entrega)
- Eliminar un canal (las reglas de alerta que lo referenciaban dejarán de entregar a él)
- Volver a probar un canal en cualquier momento
Consejos
- Si ya usas URLs de Shoutrrr con Watchtower o Beszel, puedes pegar la misma URL en Dockerman.
- Para Discord, convierte tu URL de webhook (
https://discord.com/api/webhooks/ID/TOKEN) al formato Shoutrrr:discord://TOKEN@ID. - El canal de webhook genérico envía un POST JSON con campos
titleybody. Úsalo para integrar con cualquier servicio que acepte webhooks.