Actualizar documentación: env_file y Microsoft 365 Mail Protection
This commit is contained in:
65
README.md
65
README.md
@@ -54,26 +54,67 @@ environment:
|
|||||||
- Mantén backups si actualizas servicios con datos persistentes
|
- Mantén backups si actualizas servicios con datos persistentes
|
||||||
- Excluye servicios que gestionas manualmente (`enable=false`)
|
- Excluye servicios que gestionas manualmente (`enable=false`)
|
||||||
|
|
||||||
## Notificaciones SMTP (Shoutrrr)
|
## Notificaciones
|
||||||
Activa notificaciones con Shoutrrr y usa una URL SMTP en `.env`:
|
|
||||||
|
Watchtower usa **env_file** para cargar variables desde `.env`, simplificando la configuración.
|
||||||
|
|
||||||
|
### Configuración básica
|
||||||
|
|
||||||
|
1. Copia el archivo de ejemplo:
|
||||||
|
```bash
|
||||||
|
cp .env.example .env
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Edita `.env` con tu configuración:
|
||||||
```env
|
```env
|
||||||
WATCHTOWER_NOTIFICATIONS=shoutrrr
|
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_NOTIFICATION_URL=smtp://tu-servidor-smtp:25/?from=noreply@midominio.com&to=admin@midominio.com&subject=Watchtower%20-%20Actualizaciones
|
||||||
WATCHTOWER_NOTIFIER_LEVEL=info
|
WATCHTOWER_NOTIFIER_LEVEL=info
|
||||||
WATCHTOWER_NOTIFICATIONS_REPORT=true
|
WATCHTOWER_NOTIFICATIONS_REPORT=true
|
||||||
```
|
```
|
||||||
Consejos:
|
|
||||||
- Escapa caracteres especiales en usuario/contraseña.
|
|
||||||
- Verifica puerto TLS/STARTTLS de tu servidor (587 suele ser STARTTLS).
|
|
||||||
|
|
||||||
### Múltiples destinos y destinatarios
|
3. Reinicia Watchtower:
|
||||||
- Varios destinatarios SMTP (separados por coma):
|
```bash
|
||||||
```env
|
docker compose up -d
|
||||||
WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com,devops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes
|
|
||||||
```
|
```
|
||||||
- Varios destinos (ej. SMTP + Telegram) separados por ';':
|
|
||||||
|
### SMTP sin autenticación (puerto 25)
|
||||||
|
|
||||||
|
Ideal para servidores relay internos o Microsoft 365 Mail Protection:
|
||||||
|
|
||||||
```env
|
```env
|
||||||
WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes;telegram://TOKEN@CHATID
|
# Microsoft 365 Mail Protection (sin autenticación)
|
||||||
|
WATCHTOWER_NOTIFICATION_URL=smtp://midominio-com.mail.protection.outlook.com:25/?from=noreply@midominio.com&to=admin@midominio.com&subject=Watchtower%20-%20Actualizaciones
|
||||||
|
```
|
||||||
|
|
||||||
|
**Nota sobre Microsoft 365 Mail Protection:**
|
||||||
|
- Endpoint format: `tudominio-com.mail.protection.outlook.com` (reemplaza `.` del dominio por `-`)
|
||||||
|
- Puerto 25, sin autenticación ni TLS
|
||||||
|
- Requiere configuración previa de conector de entrada en Microsoft 365
|
||||||
|
- Solo acepta correos desde IPs autorizadas (configura en Exchange Admin Center)
|
||||||
|
|
||||||
|
### SMTP con autenticación (puerto 587)
|
||||||
|
|
||||||
|
Para servidores que requieren credenciales:
|
||||||
|
|
||||||
|
```env
|
||||||
|
WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes
|
||||||
|
```
|
||||||
|
|
||||||
|
**Nota:** Escapa caracteres especiales en usuario/contraseña si es necesario.
|
||||||
|
|
||||||
|
### Múltiples destinatarios
|
||||||
|
|
||||||
|
Separa direcciones con comas:
|
||||||
|
```env
|
||||||
|
WATCHTOWER_NOTIFICATION_URL=smtp://servidor:25/?from=noreply@midominio.com&to=admin@midominio.com,devops@midominio.com&subject=Watchtower%20-%20Actualizaciones
|
||||||
|
```
|
||||||
|
|
||||||
|
### Múltiples canales
|
||||||
|
|
||||||
|
Separa URLs con punto y coma:
|
||||||
|
```env
|
||||||
|
WATCHTOWER_NOTIFICATION_URL=smtp://servidor:25/?from=noreply@midominio.com&to=admin@midominio.com;telegram://TOKEN@telegram?channels=CHAT_ID
|
||||||
```
|
```
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|||||||
Reference in New Issue
Block a user