From 0da12c336710cc3c05a628271419b3d3505aaf5e Mon Sep 17 00:00:00 2001 From: groales Date: Mon, 1 Dec 2025 19:48:48 +0100 Subject: [PATCH] Actualizar Notificaciones.md: env_file y Microsoft 365 Mail Protection --- Notificaciones.md | 83 ++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 79 insertions(+), 4 deletions(-) diff --git a/Notificaciones.md b/Notificaciones.md index f50f6f3..822bec7 100644 --- a/Notificaciones.md +++ b/Notificaciones.md @@ -2,11 +2,86 @@ Watchtower integra [Shoutrrr](https://containrrr.dev/shoutrrr/v0.5/), permitiendo enviar avisos a múltiples destinos. -## Variables -- `WATCHTOWER_NOTIFICATIONS=shoutrrr` -- `WATCHTOWER_NOTIFICATION_URL=` (puedes separar varias con `;`) +## Configuración + +Watchtower usa `env_file` en `docker-compose.yaml` para cargar variables desde `.env`: + +1. **Copiar archivo de ejemplo:** +```bash +cp .env.example .env +``` + +2. **Editar `.env`** con tu configuración + +3. **Reiniciar contenedor:** +```bash +docker compose up -d +``` + +## Variables principales + +- `WATCHTOWER_NOTIFICATIONS=shoutrrr` - Activar notificaciones +- `WATCHTOWER_NOTIFICATION_URL=` - URL del servicio (separa varias con `;`) +- `WATCHTOWER_NOTIFIER_LEVEL=info` - Nivel de log (panic, fatal, error, warn, info, debug, trace) +- `WATCHTOWER_NOTIFICATIONS_REPORT=true` - Enviar reporte final con resumen + +## Ejemplos de Notificaciones + +### Email SMTP sin autenticación (puerto 25) + +Ideal para servidores relay internos o Microsoft 365 Mail Protection: + +```env +WATCHTOWER_NOTIFICATIONS=shoutrrr +WATCHTOWER_NOTIFICATION_URL=smtp://mail.midominio.com:25/?from=noreply@midominio.com&to=admin@midominio.com&subject=Watchtower%20-%20Actualizaciones +WATCHTOWER_NOTIFIER_LEVEL=info +WATCHTOWER_NOTIFICATIONS_REPORT=true +``` + +### Microsoft 365 Mail Protection + +Microsoft 365 permite recibir correos desde servidores externos mediante conectores de entrada: + +**Formato del endpoint:** +``` +tudominio-com.mail.protection.outlook.com +``` +(Reemplaza los puntos del dominio por guiones) + +**Ejemplo de configuración:** +```env +WATCHTOWER_NOTIFICATION_URL=smtp://midominio-com.mail.protection.outlook.com:25/?from=noreply@midominio.com&to=admin@midominio.com&subject=Watchtower%20-%20Actualizaciones +``` + +**Requisitos previos en Microsoft 365:** +1. Crear conector de entrada en **Exchange Admin Center** +2. Configurar IP del servidor Docker en lista de IPs autorizadas +3. Configurar dominio remitente (si es necesario) + +**Características:** +- Puerto 25 (no requiere TLS/STARTTLS) +- Sin autenticación (basada en IP) +- Solo acepta correos desde IPs configuradas +- Ideal para entornos corporativos con Microsoft 365 + +### Email SMTP con autenticación (puerto 587) + +Para servidores que requieren usuario/contraseña:TP con autenticación (puerto 587) + +Para servidores que requieren usuario/contraseña: + +```env +WATCHTOWER_NOTIFICATIONS=shoutrrr +WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes +WATCHTOWER_NOTIFIER_LEVEL=info +WATCHTOWER_NOTIFICATIONS_REPORT=true +``` + +**Notas:** +- Escapa caracteres especiales en `USUARIO`/`PASS` si es necesario +- Puerto 587: STARTTLS (usa `starttls=Yes`) +- Puerto 465: SSL/TLS directo (usa `encryption=ssl`) -## Ejemplos ### Telegram ``` WATCHTOWER_NOTIFICATIONS=shoutrrr