SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

Autohospedar ntfy con Docker para alertas del servidor

Ejecuta ntfy en tu VPS con Docker Compose y TLS. Protege topics con usuarios y ACLs, y envía alertas desde cron y unidades systemd OnFailure.

Qué hace un servidor ntfy autohospedado

Un servidor ntfy autohospedado convierte una solicitud HTTP POST en una notificación push en el teléfono. Publique con curl y el mensaje llegará a la aplicación de Android, la aplicación de iOS, una pestaña del navegador o cualquier otro cliente que pueda mantener abierta una conexión HTTP. No es necesario instalar una biblioteca cliente ni ejecutar un message broker.

ntfy direcciona los mensajes mediante topics. Un topic es un nombre en la ruta URL, como https://ntfy.example.com/alerts, y existe desde el momento en que alguien publica en él. En una instalación predeterminada, cualquiera que conozca ese nombre puede leer el topic y escribir en él. Por eso la documentación del proyecto compara el nombre del topic con una contraseña. Este modelo es adecuado para el servicio público ntfy.sh. No es adecuado para un servidor que transporta los fallos de las copias de seguridad. Por eso esta guía activa la autenticación antes de enviar el primer mensaje.

Qué necesita antes de empezar

Necesita un VPS con Ubuntu 24.04 o Debian 13, Docker Engine y el complemento Compose instalados, un nombre de dominio y muy poca RAM. Cree un registro A de DNS (sistema de nombres de dominio) que apunte ntfy.example.com a la dirección IP pública del servidor. Después, confirme que resuelve correctamente antes de continuar.

dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw status

dig debe mostrar la IP de su servidor. Para emitir el certificado, el nombre de host debe resolver públicamente al servidor mediante un registro A o AAAA. El puerto 80 debe permanecer abierto porque ACME (entorno de gestión automática de certificados), el protocolo que utiliza Let's Encrypt, lo usa para el desafío HTTP. El contenedor de ntfy no expone ningún puerto público.

Escriba el archivo de configuración de ntfy

La imagen de Docker no contiene un archivo de configuración, por lo que debe crear uno. Todos los comandos posteriores de esta guía lo leen. Primero, obtenga el ID de usuario y el ID de grupo con los que se ejecutará el contenedor.

id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.yml
base-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: false

Cuatro de esas líneas son fundamentales. base-url debe ser la dirección HTTPS pública exacta, porque ntfy la usa para generar enlaces de archivos adjuntos y notificaciones push de iOS autohospedadas. listen-http: ":2586" se enlaza a todas las interfaces dentro del contenedor. Esto parece poco cuidadoso, pero es correcto: el contenedor tiene su propio espacio de nombres de red, por lo que enlazarse a 127.0.0.1 allí haría que el puerto fuera inaccesible desde el host y el puerto publicado por Docker nunca podría conectarse. auth-default-access: "deny-all" define toda la postura de seguridad, porque rechaza las operaciones de lectura y escritura de cualquier usuario que no tenga una autorización explícita. behind-proxy: true indica a ntfy que tome la dirección del cliente de la cabecera X-Forwarded-For, para que los límites de tasa cuenten a los visitantes reales en lugar de contar el reverse proxy como un único cliente con mucha actividad.

enable-login: true permite a los usuarios iniciar sesión mediante la aplicación web o la API. enable-signup permanece en false, porque permitir la creación de cuentas por autoservicio en un servidor privado dejaría una vía de acceso abierta sin aportar ninguna ventaja.

sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.yml

Ejecutar ntfy con Docker Compose

Ponga esto en /opt/ntfy/compose.yaml y sustituya 1000:1000 por los dos números id -u y id -g mostrados arriba.

services:
  ntfy:
    image: binwiederhier/ntfy:v2.36.0
    container_name: ntfy
    command: serve
    user: "1000:1000"
    environment:
      - TZ=UTC
    volumes:
      - /etc/ntfy:/etc/ntfy
      - /var/cache/ntfy:/var/cache/ntfy
      - /var/lib/ntfy:/var/lib/ntfy
    ports:
      - "127.0.0.1:2586:2586"
    restart: unless-stopped
cd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/health

Un servidor operativo responde en {"healthy":true,"role":"active"}. Hay dos detalles intencionados en ese archivo de Compose. La imagen está fijada en v2.36.0, la versión estable actual a fecha del 1 de noviembre de 2026, en lugar de latest, porque con latest el siguiente docker compose pull descarga la imagen actual y un docker compose up -d posterior recrea el contenedor con ella; hacer pull por sí solo no cambia la versión del servidor en ejecución. Una versión fijada también necesita actualizarse. Octubre de 2026 trajo diez versiones: v2.29.0 el 7 de octubre, v2.30.0 el 12 de octubre, v2.31.0 y v2.31.1 el 16 de octubre, v2.32.0 el 18 de octubre, v2.33.0 y v2.33.1 el 23 de octubre, v2.34.0 el 24 de octubre, v2.35.0 el 30 de octubre y v2.36.0 el 31 de octubre. v2.31.0 corrige la pérdida de mensajes cuando un cliente se reconecta antes de que lleguen a la caché de mensajes, pero sus reconexiones con since=<message ID> leen todos los mensajes del tema desde la base de datos, y ntfy.sh la retiró. v2.31.1 corrige esa carga con un índice nuevo, y v2.34.0 corrige la permanencia de algunas suscripciones en usuarios revocados o eliminados. v2.35.0 corrige las solicitudes simultáneas que trataban credenciales válidas como anónimas y una omisión de autorización en la pasarela de push de Matrix sobre SQLite, así que cambie las versiones fijadas anteriores a v2.36.0. El puerto se publica como 127.0.0.1:2586:2586, por lo que el contenedor sólo es accesible desde la dirección de loopback del host. Escriba 2586:2586 en su lugar y Docker insertará sus propias reglas de firewall antes que las suyas. Por tanto, el puerto responderá desde Internet aunque ufw status indique que está cerrado. Ambos criterios se aplican al siguiente contenedor que añada: un relay de RustDesk autohospedado fija la etiqueta de su imagen de la misma forma, pero no puede ocultarse detrás de loopback porque sus puertos de señalización y relay deben responder desde Internet.

Si curl muestra Connection refused, lea el registro del contenedor. Un error de permisos en /var/lib/ntfy/user.db indica que la línea user: no coincide con el propietario de esos directorios, por lo que el proceso no puede crear su propia base de datos y termina. La guía básica de Docker Compose para un VPS explica con más detalle la propiedad de los volúmenes y las políticas de reinicio.

Configurar TLS delante con Caddy

Caddy solicita y renueva el certificado por su cuenta. Es la forma más directa de tener TLS (seguridad de la capa de transporte) funcionando.

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

Reemplace el contenido de /etc/caddy/Caddyfile por tres líneas.

ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}
sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health

La misma {"healthy":true,"role":"active"} mediante HTTPS confirma que toda la ruta funciona. Un 502 de Caddy suele indicar que ntfy no está escuchando. Compruébelo con sudo ss -lntp | grep 2586. Si ntfy está escuchando y 502 persiste, los registros de Caddy muestran el error del upstream, como una conexión restablecida. Un error de certificado suele indicar que el registro DNS es incorrecto o que la validación del certificado no puede alcanzar el servidor por el puerto 80 o 443. Revise sudo journalctl -u caddy -n 50 para consultar el error de validación. Para añadir otro servicio más adelante, basta con incluir otro bloque de hostname en el mismo Caddyfile. Así, por ejemplo, Halcyon, una interfaz de videoclub de los años 90 para su biblioteca de Jellyfin puede quedar en un segundo subdominio del mismo servidor.

Si ya usa nginx, copie la configuración del proxy que documenta ntfy: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for y tiempos de espera de lectura y envío de al menos tres minutos. Un suscriptor mantiene abierta una conexión HTTP mientras está escuchando. El valor predeterminado de nginx, proxy_read_timeout de 60 segundos, sólo cuenta el tiempo entre dos lecturas. ntfy envía un mensaje keepalive cada 45 segundos de forma predeterminada (keepalive-interval), precisamente para que los intermediarios no cierren la conexión por inactividad. Por tanto, un suscriptor sin actividad permanece conectado incluso detrás de un nginx sin modificar. Los tiempos de espera más largos proporcionan margen, pero no son lo que mantiene activa la conexión. Si aumenta keepalive-interval, manténgalo por debajo del tiempo de espera de lectura del proxy.

Crear usuarios y restringir los topics

La autenticación está activada y todavía nadie tiene acceso a nada, que es precisamente lo esperado. Cree una cuenta de administrador para usted y una cuenta de máquina para los scripts. Estos comandos leen /etc/ntfy/server.yml desde el contenedor, por eso el archivo de configuración se monta como volumen.

sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user list

Cada comando user add solicita una contraseña. Un administrador ignora la lista de control de acceso y puede leer y escribir en todos los topics, así que reserve esa cuenta para usted y para la aplicación del teléfono. robot es un usuario normal sin ningún acceso hasta que le conceda alguno.

sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy access

Una entrada de una ACL (lista de control de acceso) consta de un usuario, un topic y un permiso. El topic puede ser un nombre literal o un patrón en el que * coincide con cualquier valor, por lo que alerts_* incluye alerts_backup y alerts_db sin necesidad de ejecutar un comando por host. El permiso write significa que sólo puede publicar, de modo que un token robado de un cron job no puede suscribirse ni leer lo que envió. El nombre de usuario especial everyone define las acciones que puede realizar un visitante no autenticado. Con deny-all como valor predeterminado, normalmente lo usaría para abrir deliberadamente algo público, como ntfy access everyone status read. También acepta deny cuando quiera una regla explícita que mantenga a los visitantes anónimos fuera de un topic.

Los scripts deben usar un token, no su contraseña.

sudo docker compose exec ntfy ntfy token add robot

El comando imprime un token que comienza por tk_. Un token hereda exactamente los permisos del usuario al que pertenece, por lo que este token puede publicar en los topics alerts y no puede hacer nada más. ntfy token list muestra lo que existe y ntfy token remove revoca un token sin modificar la contraseña del usuario.

Envía tu primer mensaje y comprueba que el bloqueo funciona

Empieza comprobando que la puerta está cerrada.

curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts

Esto muestra 403, y 403 es la respuesta correcta: auth-default-access: "deny-all" rechaza una publicación anónima. Ahora envía un mensaje real.

curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
  -H "Title: Nightly backup finished" \
  -H "Priority: default" \
  -H "Tags: white_check_mark" \
  -d "42 GB copied in 11 minutes" \
  https://ntfy.example.com/alerts

El servidor responde con el mensaje almacenado en formato JSON. Así sabes que lo aceptó y no lo descartó. Title es la primera línea en negrita. Priority acepta valores del 1 al 5 o nombres desde min hasta urgent, y determina si el teléfono emite un sonido. Tags se convierten en emoji en la notificación cuando el nombre coincide con un código corto de emoji conocido, y permanecen como texto sin formato cuando no coincide.

Para supervisar un topic desde un terminal, transmite su contenido:

curl -s -u admin https://ntfy.example.com/alerts/raw

curl solicita la contraseña. Cada mensaje llega en una sola línea. Las líneas vacías que aparecen de vez en cuando son mensajes keepalive. Si abres https://ntfy.example.com en un navegador e inicias sesión con la misma cuenta, obtienes la versión web del mismo flujo.

Configurar límites de tasa para que un script no pueda saturar el servidor

De forma predeterminada, cada visitante obtiene un depósito de 60 solicitudes, que se rellena a razón de una solicitud cada 5 segundos. Es un límite amplio para un servidor privado, y un script atrapado en un bucle de reintentos lo consumirá por completo. Añada límites a server.yml.

visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500
sudo docker compose restart ntfy

Un visitante que supera el límite recibe HTTP 429 en lugar del mensaje entregado. El límite se cuenta por dirección del visitante. Por eso behind-proxy: true es tan importante: sin él, ntfy sólo ve la dirección de Caddy, todos los clientes cuentan como el mismo visitante y un único script ruidoso agota el depósito que comparten su teléfono y los demás servidores. Desde v2.36.0, los recuentos diarios sobreviven a los reinicios en la base de datos de usuarios, y la cuota de cada visitante se reinicia en su propio ciclo de 24 horas, en lugar de hacerlo a medianoche UTC.

Alerta de un trabajo de cron que falla

No incluya el token en la línea de comandos. ps aux muestra la línea de comandos completa de todos los procesos en ejecución a todos los usuarios del sistema, por lo que un token pasado con -H puede ser leído por cualquier cuenta local mientras curl esté en ejecución. Un archivo de configuración de curl evita este problema.

sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrc

Ahora envuelva el trabajo. Guarde esto como /usr/local/bin/backup-with-alert.sh y haga chmod 750 ejecutable.

#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
  printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
    -H "Title: backup.sh failed with exit $code" \
    -H "Priority: high" \
    -H "Tags: warning" \
    --data-binary @- \
    https://ntfy.example.com/alerts
fi
exit "$code"
17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1

$? se captura en la línea inmediatamente posterior al comando, porque la ejecución del siguiente comando lo sobrescribiría. La salida pasa por tail -c 1000 porque ntfy impone un tamaño máximo para los mensajes y una notificación no sustituye a un visor de registros. El exit "$code" de cierre conserva el estado original, por lo que cualquier otro componente que supervise este trabajo seguirá viendo un fallo. Pruebe todo el proceso haciendo que el script apunte a /bin/false durante una ejecución.

Una rama de error que nunca se ejecuta es peor que no tener alertas, porque da la impresión de que el silencio significa que todo funciona. Cron proporciona al trabajo un entorno casi vacío y un PATH mucho más corto que el de su shell de inicio de sesión, por lo que un script que funciona al ejecutarlo manualmente puede terminar antes de llegar a la línea de curl. La guía sobre por qué no se ejecuta un trabajo de cron explica estos problemas del entorno. Use rutas absolutas en todo el script y lea el archivo de registro después de la primera ejecución programada en lugar de dar por hecho que todo funciona.

Alertar cuando una unidad de systemd falla

Cron cubre las tareas programadas. Los servicios de larga duración necesitan OnFailure=, que systemd ejecuta cuando una unidad entra en el estado failed. Cree una unidad de plantilla y reutilícela para cada servicio del equipo. Guárdela como /etc/systemd/system/ntfy-unit-failed@.service.

[Unit]
Description=Send an ntfy alert because %i failed

[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %i

Después, /usr/local/bin/ntfy-unit-failed, con el modo 750:

#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
  -H "Title: $unit failed on $(hostname -s)" \
  -H "Priority: urgent" \
  -H "Tags: rotating_light" \
  --data-binary @- \
  https://ntfy.example.com/alerts

Asóciela a un servicio mediante un drop-in para que una actualización del paquete no sobrescriba los cambios.

sudo systemctl edit myapp.service
[Unit]
OnFailure=ntfy-unit-failed@%n.service

%n se expande al nombre completo de la unidad. Por tanto, la unidad instanciada se convierte en ntfy-unit-failed@myapp.service.service. Además, %i dentro de la plantilla pasa myapp.service al script como primer argumento. Esto permite que una sola plantilla sirva para cualquier unidad. Compruebe que funciona con una unidad que falle intencionadamente, guardada como /etc/systemd/system/ntfy-selftest.service.

[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service

[Service]
Type=oneshot
ExecStart=/bin/false
sudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.service

El comando de inicio termina con un código distinto de cero y muestra Job for ntfy-selftest.service failed because the control process exited with error code. El teléfono debería emitir una alerta aproximadamente un segundo después. Elimine la unidad de prueba cuando termine.

Hay una particularidad importante. OnFailure= sólo se ejecuta cuando una unidad alcanza el estado failed. RestartMode=direct omite ese estado durante los reinicios automáticos, por lo que también omite el controlador de fallos. Con el valor predeterminado RestartMode=normal, los reinicios automáticos pasan por el estado failed. StartLimitBurst y StartLimitIntervalSec controlan cuándo se rechazan los inicios repetidos. Configúrelos para que un bucle de fallos termine deteniéndose. Los timers son el reemplazo más limpio para el patrón anterior con cron, porque la unidad de servicio de un timer admite el mismo drop-in de OnFailure=. La guía sobre servicios y timers de systemd en un VPS explica cómo convertir uno.

Integre un monitor de disponibilidad en el mismo tema

Uptime Kuma, el monitor de estado autogestionado, incluye un tipo de notificación para ntfy. Abra Settings, después Notifications y luego Setup Notification. Seleccione Ntfy, establezca la URL del servidor en https://ntfy.example.com y el tema en alerts, elija una prioridad y pegue el token de acceso robot. Envíe la notificación de prueba antes de guardar, porque un nombre de tema incorrecto devuelve un error cuando un permiso write no lo incluye.

El límite real de esta configuración es el siguiente: un monitor que se ejecuta en el mismo VPS no puede avisarle de que el VPS está caído, y ntfy no puede entregar el aviso de que ntfy está caído. Ejecute el monitor en otra máquina y asígnele un segundo canal de notificación, como el correo electrónico, para el monitor que supervisa el propio ntfy. El tipo de monitor Push de Uptime Kuma cubre el otro punto ciego: el trabajo de cron llama a una URL de push después de ejecutarse correctamente, y Kuma genera una alerta cuando esas llamadas dejan de llegar. Una rama de error sólo se activa cuando se ejecuta el trabajo, por lo que no informa de un trabajo que nunca se inició.

¿Funciona ntfy autoalojado en Android y iPhone?

En Android, sí, sin limitaciones. Instale la aplicación desde Google Play o F-Droid, abra Settings, establezca el servidor predeterminado en https://ntfy.example.com, añada su cuenta en la pantalla de gestión de usuarios y suscríbase a alerts. La entrega instantánea mantiene activo un servicio en primer plano para que los mensajes lleguen incluso cuando el teléfono está en modo doze. La notificación permanente que la acompaña es un requisito de Android para los servicios en primer plano, no un error. La compilación de F-Droid no contiene código de Firebase, por lo que todas las suscripciones utilizan la entrega instantánea. ntfy también puede actuar como distribuidor de UnifiedPush, una alternativa abierta al servicio de notificaciones push de Google. Por tanto, otras aplicaciones compatibles con UnifiedPush también pueden entregar notificaciones a través de su servidor.

En la aplicación oficial para iOS, funciona con una dependencia que no puede eliminar. iOS suspende las aplicaciones que pasan a segundo plano. Los modos en segundo plano que permite Apple (reproducir audio, recibir actualizaciones de ubicación y procesar tareas programadas) no permiten que una aplicación permanezca esperando un mensaje de su servidor. Por eso, la activación inmediata debe llegar mediante APNs (Apple push notification service). Sólo un proveedor con credenciales autorizadas para la aplicación puede enviarle notificaciones. Por tanto, su servidor no puede contactar directamente con la aplicación oficial. ntfy resuelve esto mediante un relay: su servidor envía un poll_request que contiene el ID del mensaje a ntfy.sh. ntfy.sh lo reenvía mediante Firebase y APNs para activar la aplicación. Después, la aplicación obtiene el cuerpo del mensaje desde su servidor.

upstream-base-url: "https://ntfy.sh"

Debe tener claro cuál es el coste. El contenido del mensaje permanece en su servidor, pero el hecho de que haya llegado un mensaje y su ID pasan por una infraestructura que usted no administra. Sin esta configuración, las notificaciones de un servidor autoalojado siguen llegando al iPhone, pero la documentación de ntfy advierte que el retraso puede ser de varias horas, porque nada activa la aplicación con rapidez. Para usar una aplicación nativa de iOS sin el relay de ntfy.sh, compile y distribuya la aplicación usted mismo con su propia cuenta de desarrollador de Apple y sus propias claves de APNs. Esto implica pagar una cuota anual y recompilar la aplicación con cada actualización. Otra opción es la PWA de ntfy en iOS 16.4 o posterior: añádala a la pantalla de inicio y configure Web Push en su servidor. Esto evita el relay de ntfy.sh, pero sigue utilizando la infraestructura de notificaciones push del navegador. Si el relay no es aceptable para su caso, mantenga las alertas en Android o en la aplicación web de escritorio.

Copias de seguridad, actualizaciones y fijación de la imagen

Hay dos rutas que no se pueden regenerar: /etc/ntfy/server.yml y /var/lib/ntfy/user.db. La segunda contiene todos los usuarios, los hashes de las contraseñas, las entradas de ACL y los tokens, así que trátela como una clave privada.

sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgz

Copie ese archivo fuera del servidor. cache.db contiene los mensajes recientes, 12 horas de ellos con el cache-duration anterior, además de cualquier mensaje programado para una entrega posterior, que permanece hasta 12 horas después de su entrega. Salvo que programe mensajes con antelación, perderlo no supone un coste importante. Actualizar consiste en editar la etiqueta en el archivo de Compose, descargar la imagen y recrear el contenedor.

sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/health

Lea primero las notas de la versión. Las bases de datos SQLite se migran durante el arranque, por lo que no es seguro volver a una etiqueta anterior después de un cambio de esquema. Por ejemplo, v2.31.1 movió la caché de mensajes a la versión de esquema 17, y sus notas de actualización indican que para bajar a v2.31.0 o anterior hay que restablecer manualmente esa versión a 16. La actualización a v2.36.0 restablece una vez los recuentos diarios existentes de todos los usuarios. Conserve la copia de seguridad que acaba de hacer hasta que la nueva versión lleve un día funcionando. Las notas también señalan cambios de comportamiento. Desde v2.31.0, un cliente que se reconecta con since=<message ID> también recibe los mensajes publicados en el mismo segundo, por lo que puede ver un duplicado. Las aplicaciones de ntfy y la aplicación web descartan los duplicados mediante el ID del mensaje, pero un script propio que reproduzca un tema debe hacer lo mismo. Cada servicio del equipo tiene su propia lista breve de rutas que no se pueden regenerar, y la comparación entre PhotoPrism e Immich determina esa lista y los comandos de copia de seguridad correspondientes para una biblioteca de fotos en el mismo tipo de VPS.

Gotify y Apprise

Gotify es la opción más pequeña: un binario con una interfaz web y una aplicación para Android. Organiza los mensajes por aplicación. Es adecuado para un servidor privado cuyo único destino sea Android. Apprise es una biblioteca de Python y una herramienta de línea de comandos. También existe un servidor independiente de Apprise API. Permite enviar un mismo mensaje a más de cien servicios, incluido ntfy. Es adecuado para un script que deba llegar a varios destinos a la vez. ntfy proporciona un servidor, una API HTTP y aplicaciones para ambas plataformas móviles. Por eso es la opción habitual para enviar alertas desde un servidor alquilado.

FAQ

¿Por qué la publicación en mi servidor ntfy devuelve 403?

Con auth-default-access: "deny-all" en server.yml, se rechaza la publicación anónima. Ese es el comportamiento previsto. Envíe las credenciales con -u user:pass o -H "Authorization: Bearer tk_...". Si ya envía un token y sigue obteniendo 403, compruebe si el usuario tiene una entrada ACL que permita escribir en el topic: si no hay una entrada coincidente, read-only o deny rechaza la publicación. En v2.34.0, las solicitudes simultáneas desde la misma IP también podían hacer que unas credenciales válidas se trataran como anónimas. v2.35.0 corrige ese error, así que actualice antes de considerar un 403 intermitente como prueba de un problema de ACL. Ejecute ntfy access para mostrar la lista completa. Recuerde que una concesión write no permite suscribirse. Por tanto, una cuenta que publica correctamente seguirá siendo rechazada cuando intente leer el mismo topic.

¿Funcionan las notificaciones en iPhone con un servidor ntfy autohospedado?

Funcionan mediante un relay cuando usa la aplicación oficial de iOS. La activación de una aplicación de iPhone suspendida debe pasar por APNs (Apple push notification service). Además, el envío a la aplicación oficial requiere las credenciales de push de su editor. Por eso, ntfy reenvía un poll_request que contiene el ID del mensaje a ntfy.sh, que lo retransmite al dispositivo. Configure upstream-base-url: "https://ntfy.sh" en server.yml y reinicie el contenedor. El cuerpo del mensaje se sigue obteniendo de su servidor. Sin esa configuración, las notificaciones de iOS siguen llegando, pero la documentación de ntfy advierte de que el retraso puede ser de varias horas. La PWA ofrece otra opción en iOS 16.4 o posterior cuando Web Push está configurado en su servidor.

¿Por qué nunca llegó la alerta de ntfy de mi tarea de cron?

Ejecute primero por separado la línea de curl para comprobar que el token y el topic son correctos. Si funciona manualmente pero no desde cron, el fallo se produce antes de la alerta: cron ejecuta las tareas con un entorno mínimo y un PATH corto. Por tanto, un script que invoque un comando por su nombre sin ruta completa puede terminar antes de llegar a la línea de curl. Use rutas absolutas, redirija la salida de la tarea a un archivo de registro y lea ese archivo después de la siguiente ejecución. Una respuesta 429 en lugar de una entrega indica que un límite rechazó la solicitud. Normalmente, el script está reintentando demasiado rápido, pero un visitante que haya agotado una cuota diaria, como el límite de mensajes configurado anteriormente, será rechazado de la misma forma incluso con una sola solicitud.

¿Debo exponer ntfy en Internet público?

Las aplicaciones para teléfonos deben acceder al servidor desde redes móviles. Por eso, un endpoint HTTPS público con auth-default-access: "deny-all" y ACL por topic es la configuración normal. Es segura siempre que ningún topic pueda ser leído por everyone. Una instancia accesible sólo mediante VPN es razonable cuando todos los suscriptores son máquinas que usted controla. Es una mala opción para los teléfonos, porque la aplicación sólo recibe mensajes mientras el túnel está activo. Las alertas se acumulan hasta que el teléfono vuelve a conectarse.

¿Te resultó útil este artículo?