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".
Compatibilidad actual del escritorio
La página de Notificaciones puede listar canales configurados y enviar una prueba. La interfaz de escritorio actual no ofrece un flujo completo para añadir, editar, deshabilitar o eliminar canales. Los adaptadores internos no sustituyen esa interfaz ausente.
Seguridad de credenciales
El daemon actual guarda los secretos completos en secrets/notification-channels.json, dentro de los datos de Dockerman. En Unix restringe el archivo al usuario actual, pero los valores no se almacenan en el llavero del sistema.
Trata el directorio de datos de Dockerman como información sensible. Las URL de webhook genéricas pueden incluir credenciales en la ruta o la consulta; revisa logs y diagnósticos antes de compartirlos.
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.
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.