Alojar ntfy en un VPS administrado significa enviar notificaciones push con una simple petición HTTP, PUT o POST, desde una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. ntfy es software libre con doble licencia, Apache 2.0 y GPLv2. Esta guía sigue su documentación oficial en la versión 2.38.1: la instalación con Docker Compose, el archivo server.yml, los usuarios y el control de acceso, los tokens de acceso, HTTPS, las aplicaciones móviles, el correo, las copias de seguridad y las actualizaciones.
Por Simon Vasconcelos Lee
Publicado el 21 de noviembre de 202615 minutos de lectura
binwiederhier/ntfy, un server.yml con base-url, cache-file y auth-file, y el puerto publicado en 127.0.0.1 detrás de un proxy inverso en HTTPS.auth-default-access: deny-all, cree un administrador con ntfy user add y dé después a cada script su propio token y permisos limitados.server.yml y de user.db, que guardan la configuración, los usuarios, los permisos y los tokens; actualice cambiando la etiqueta de la imagen, después de leer las notas de la versión.ntfy, que se pronuncia como «notify», es un servicio de notificaciones de publicación y suscripción basado en HTTP. Su README lo presenta como una forma de enviar notificaciones a su teléfono o a su ordenador desde scripts, desde cualquier equipo. El proyecto mantiene una instancia pública, ntfy.sh, y el servidor puede autoalojarse: de eso trata esta guía.
curl, un script, una tarea programada u otra aplicación. Un mensaje puede llevar un título, una prioridad de 1 a 5, etiquetas y emojis, un archivo adjunto, botones de acción o una hora de entrega diferida.ntfy o la API, por WebSocket o mediante un flujo HTTP que permanece abierto.curl -d "Backup finished" https://ntfy.example.com/backups
El README de ntfy indica que el proyecto tiene doble licencia: la Apache License 2.0, en el archivo LICENSE, y la GNU GPL versión 2, en LICENSE.GPLv2. La imagen Docker declara ambas, Apache-2.0, GPL-2.0.
Ejecutar ntfy en su servidor, para su empresa, su equipo o sus clientes, no exige por tanto ninguna licencia que comprar. Los dos textos ofrecen el software sin garantía.
La licencia cubre el código. El nombre es otra cuestión: la Apache License 2.0 no concede ningún derecho sobre las marcas del licenciante, y las condiciones de servicio de ntfy.sh indican que el nombre, el logotipo y la identidad visual de ntfy son marcas de ntfy LLC, cuyo uso en relación con un producto o un servicio requiere su consentimiento previo por escrito. Esta guía nombra ntfy para describir el software.
Esta publicación es independiente del proyecto ntfy y de ntfy LLC, y no está afiliada a ellos, ni patrocinada ni aprobada por ellos.
El servidor es un único binario enlazado estáticamente, para amd64, armv7 y arm64; la imagen Docker existe también para armv6. La documentación no da ninguna cifra de memoria ni de procesador: para un servidor doméstico, dice, la escala no es motivo de preocupación. Señala en cambio lo que limita una instancia:
nofile. El servicio systemd del paquete lo fija en 10.000.En un VPS administrado, cuéntenos cómo lo usa, el número de dispositivos suscritos, el volumen de mensajes y los archivos adjuntos, y le recomendamos el tamaño adecuado.
La documentación propone la imagen binwiederhier/ntfy de Docker Hub. Sirve la aplicación web y la API en el puerto 80 del contenedor, y no contiene ningún archivo server.yml: la configuración va en una carpeta montada en /etc/ntfy. En un servidor con Docker instalado, cree una carpeta y coloque en ella este compose.yaml, basado en el ejemplo de la documentación:
services:
ntfy:
image: binwiederhier/ntfy:v2.38.1
container_name: ntfy
command:
- serve
environment:
- TZ=UTC
volumes:
- ./etc:/etc/ntfy
- ./lib:/var/lib/ntfy
ports:
- "127.0.0.1:2586:80"
healthcheck:
test: ["CMD-SHELL", "wget -q --tries=1 http://localhost:80/v1/health -O - | grep -Eo '\"healthy\"\\s*:\\s*true' || exit 1"]
interval: 60s
timeout: 10s
retries: 3
start_period: 40s
restart: unless-stopped
init: true
Después, el archivo de configuración, en etc/server.yml, con la dirección pública de su servidor:
base-url: "https://ntfy.example.com"
cache-file: "/var/lib/ntfy/cache.db"
attachment-cache-dir: "/var/lib/ntfy/attachments"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
behind-proxy: true
enable-login: true
docker compose up -d
curl http://127.0.0.1:2586/v1/health
El servidor responde {"healthy":true,"role":"active"}. Lo que hace cada ajuste:
127.0.0.1:2586: los ejemplos Docker de la documentación publican el puerto 80 en todas las direcciones, y sus ejemplos de proxy inverso reenvían a 127.0.0.1:2586. Publicado así, el puerto solo es accesible desde el propio servidor, y la API se alcanza únicamente a través del proxy inverso, en HTTPS.base-url: la dirección pública del servicio. El archivo server.yml de ejemplo la exige para los archivos adjuntos, el envío de correos y las notificaciones de iOS desde un servidor autoalojado.cache-file: sin él, los mensajes permanecen en memoria 12 horas y se pierden al reiniciar. Esta caché permite a los teléfonos con una conexión inestable recuperar los mensajes que se han perdido.attachment-cache-dir: activa los archivos adjuntos. ntfy toma el control total de esta carpeta, así que resérvela para este uso.auth-file y auth-default-access: deny-all: la base de datos de usuarios y permisos, creada en el primer arranque, y el acceso anónimo denegado por defecto. Es el ajuste que recomienda la documentación para una instancia privada.behind-proxy: sin él, detrás de un proxy, todos los visitantes comparten la dirección IP del proxy y los mismos límites de frecuencia.enable-login: permite iniciar sesión en la aplicación web. El registro abierto sigue cerrado, ya que enable-signup vale false por defecto.v2.38.1 fija la versión; latest sigue la versión más reciente. La documentación ofrece también user: UID:GID para una cuenta que no sea root: los archivos de etc y lib le pertenecen entonces.El proyecto publica también un repositorio de paquetes, firmado con la clave de huella 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. En un servidor amd64:
sudo mkdir -p /etc/apt/keyrings
sudo curl -L -o /etc/apt/keyrings/ntfy.gpg https://archive.ntfy.sh/apt/keyring.gpg
sudo apt install apt-transport-https
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ntfy.gpg] https://archive.ntfy.sh/apt stable main" \
| sudo tee /etc/apt/sources.list.d/ntfy.list
sudo apt update
sudo apt install ntfy
sudo systemctl enable ntfy
sudo systemctl start ntfy
El paquete lee /etc/ntfy/server.yml. El archivo de ejemplo recomienda /var/cache/ntfy/cache.db para la caché y /var/lib/ntfy/user.db para los usuarios, dos carpetas que crea el paquete. Detrás de un proxy, añada listen-http: "127.0.0.1:2586".
De entrada, un servidor ntfy está abierto: todo el mundo puede leer y escribir en todos los temas, y el nombre del tema hace las veces de contraseña. Con auth-file y deny-all, nada pasa sin credenciales. ntfy tiene dos roles: admin, que lee y escribe en todos los temas, y user, que solo tiene los permisos que usted le concede.
docker compose exec ntfy ntfy user add --role=admin alice
El comando pide la contraseña y después su confirmación. Los comandos ntfy user, ntfy access y ntfy token escriben directamente en la base de datos de usuarios: se ejecutan en el servidor, aquí dentro del contenedor, que lee la ruta de esa base en server.yml.
Hoy por hoy, un token de acceso da acceso completo a la cuenta de su usuario, salvo para cambiar la contraseña y eliminar la cuenta. Para un script, cree un usuario dedicado, limitado a sus temas, y después un token para él:
docker compose exec ntfy ntfy user add backup-server
docker compose exec ntfy ntfy access backup-server backups write-only
docker compose exec ntfy ntfy token add --label="backups" backup-server
read-write, read-only, write-only o deny, sobre un tema concreto o sobre un patrón como alerts-*, el único comodín admitido.everyone, o *. Para UnifiedPush en una instancia privada, la documentación abre en escritura solamente los temas que empiezan por up: ntfy access '*' 'up*' write-only.tk_, pueden caducar con --expires=30d, y cada usuario puede conservar hasta 60. ntfy token list los muestra, ntfy token remove elimina uno.auth-users, auth-access y auth-tokens crean los mismos objetos desde server.yml, en cada arranque. Un usuario retirado de esa lista se elimina de la base en el siguiente reinicio.El script publica después con su token, en HTTPS:
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Title: Backup finished" \
-H "Priority: high" \
-d "The nightly backup went fine." \
https://ntfy.example.com/backups
Una contraseña en Basic auth solo está codificada en base64, no cifrada: la documentación exige HTTPS en todo servidor autoalojado. Es lo que trata la sección siguiente.
ntfy puede servir HTTPS por sí mismo, pero detrás de un proxy la documentación recomienda dejar la terminación TLS al proxy. Dos puntos importan más que todo lo demás:
Upgrade y Connection, y deja vivir estas conexiones largas. ntfy envía por defecto un mensaje keepalive cada 45 segundos, keepalive-interval, para que ningún intermediario las cierre por inactividad.behind-proxy: true, ntfy lee la cabecera X-Forwarded-For y conserva la dirección situada más a la derecha, la que añade su proxy. Los límites de frecuencia se aplican a esa dirección.La documentación señala que Caddy gestiona a la vez HTTP y WebSocket con reverse_proxy, sin ningún ajuste adicional. Obtiene por sí mismo el certificado de Let’s Encrypt:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Este bloque sigue la configuración de la documentación, cercana a la que usa ntfy.sh: el búfer desactivado para los flujos, tiempos de espera de 3 minutos y ningún límite de tamaño para el cuerpo de las peticiones, que ntfy limita por sí mismo. Escucha en el puerto 80 para que Certbot pueda instalar HTTPS:
server {
listen 80;
listen [::]:80;
server_name ntfy.example.com;
location / {
proxy_pass http://127.0.0.1:2586;
proxy_http_version 1.1;
proxy_buffering off;
proxy_request_buffering off;
proxy_redirect off;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_connect_timeout 3m;
proxy_send_timeout 3m;
proxy_read_timeout 3m;
client_max_body_size 0;
}
}
sudo ln -s /etc/nginx/sites-available/ntfy /etc/nginx/sites-enabled/
sudo nginx -t
sudo certbot --nginx -d ntfy.example.com
Una vez que HTTP redirige a HTTPS, publique en direcciones https:// en sus scripts. Para miles de suscriptores, la documentación aumenta worker_connections en nginx.conf y el LimitNOFILE del servicio Nginx, hasta el doble de las conexiones que se buscan.
Las aplicaciones de ntfy añaden temas de su servidor igual que de ntfy.sh: introduzca su dirección al añadir el tema y, para un tema protegido, el nombre de usuario y la contraseña de un usuario que tenga acceso a él. La aplicación web se sirve en la propia dirección del servidor.
ntfy webpush keys y un certificado HTTPS válido.Añada una línea a server.yml y reinicie después el contenedor:
upstream-base-url: "https://ntfy.sh"
Por cada mensaje, su servidor publica entonces en ntfy.sh una petición de sondeo que solo contiene el identificador del mensaje y el hash SHA-256 de la URL del tema. ntfy.sh la transmite al dispositivo a través del servicio de notificaciones de Apple, y la aplicación recupera después el mensaje en su servidor. El texto que pasa por ntfy.sh es siempre el mismo, «New message», diga lo que diga el suyo. Sin este ajuste, las notificaciones llegan igualmente, con un retraso que puede alcanzar varias horas según el estado del teléfono. upstream-access-token añade un token si supera los límites de frecuencia de ntfy.sh.
ntfy limita a cada visitante, identificado por su dirección IP y, en IPv6, por su subred /64. Estos límites protegen el servidor de los abusos; en un uso normal, dice la documentación, no debería alcanzarlos. Por encima, el servidor responde 429 Too Many Requests. Los valores por defecto:
| Ajuste | Por defecto | Lo que limita |
|---|---|---|
visitor-request-limit-burst | 60 | Las peticiones de un visitante en una ráfaga |
visitor-request-limit-replenish | 5s | El ritmo de recarga: una petición cada 5 segundos |
visitor-subscription-limit | 30 | Las conexiones abiertas por visitante |
visitor-message-daily-limit | Ninguno | Los mensajes por día, regulados si no por el límite de peticiones |
visitor-email-limit-burst | 16 | Los correos en una ráfaga, y después uno por hora |
visitor-attachment-total-size-limit | 100M | El almacenamiento de archivos adjuntos por visitante |
visitor-attachment-daily-bandwidth-limit | 500M | El tráfico de archivos adjuntos por visitante y por día |
global-topic-limit | 15.000 | El número total de temas del servidor |
message-size-limit | 4K | El tamaño de un mensaje; por encima, se convierte en archivo adjunto |
visitor-request-limit-exempt-hosts, una lista de direcciones IP o de nombres de host.ntfy tier, dan a algunas cuentas límites más altos.attachment-file-size-limit, 15M por defecto, limita cada archivo, attachment-total-size-limit, 5G, el almacenamiento total, y attachment-expiry-duration, 3h, su duración. Un archivo adjunto nunca dura más que su mensaje: para conservar los adjuntos más tiempo, aumente también cache-duration.ntfy puede reenviar un mensaje por correo cuando la petición de publicación lleva la cabecera Email, o X-Email, con una dirección. Para ello pasa por un servidor SMTP saliente, en STARTTLS, con autenticación PLAIN o LOGIN: es el puerto 587. Desde un VPS de Simafri, el correo sale a través de un relé SMTP autenticado en ese mismo puerto 587: configure aquí la dirección de una cuenta de correo que ya tenga, o la de su servicio de envío de correos.
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "smtp-password"
smtp-sender-from: "ntfy@example.com"
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Email: alice@example.com" \
-d "The file server disk is over 90% full." \
https://ntfy.example.com/alerts
base-url y smtp-sender-from son obligatorios en cuanto se define smtp-sender-addr: sin ellos, el servidor se niega a arrancar.smtp-sender-verify: true limita el envío a las direcciones que cada usuario ha verificado en su cuenta, y lo cierra a los usuarios anónimos.server.yml: deje ese archivo legible solo por su propietario, con chmod 600.Con SQLite, ntfy guarda cada tipo de datos en su propio archivo. En la instalación de esta guía, todo está en las carpetas etc y lib, junto al compose.yaml:
| Elemento | Lo que guarda | Copiarlo |
|---|---|---|
etc/server.yml | La configuración, incluidos los secretos SMTP y las claves Web Push | Sí |
lib/user.db | Los usuarios, las entradas de control de acceso, los tokens y los contadores diarios | Sí |
lib/cache.db | Los mensajes de las últimas 12 horas, por defecto | Útil, su vida es corta |
lib/attachments/ | Los archivos adjuntos de las últimas 3 horas, por defecto | Útil, su vida es corta |
Archivo web-push-file | Las suscripciones Web Push de los navegadores, si lo ha activado | Sí |
Para una copia coherente de los archivos SQLite, detenga el servicio mientras se crea el archivo comprimido:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Programe esta copia a una hora tranquila y envíela fuera del servidor. Colocados en su disco, estos archivos entran también en sus copias de seguridad nocturnas. Para restaurar, vuelva a colocar las carpetas en su sitio y ejecute después docker compose up -d.
Si pierde user.db sin ninguna copia, los usuarios y los tokens declarados en server.yml mediante auth-users y auth-tokens se vuelven a crear al arrancar; los creados desde la línea de comandos hay que crearlos de nuevo.
Con Docker, cambie la etiqueta de la imagen en compose.yaml, por ejemplo de v2.38.1 a la versión siguiente, y después:
docker compose pull
docker compose up -d
Las carpetas etc y lib se quedan en su sitio, y ntfy migra sus bases de datos por sí mismo al arrancar. Con el paquete de Debian, sudo apt update y después sudo apt upgrade hacen lo mismo.
Las notas de cada versión, en la página «Releases» de la documentación, reúnen en «Upgrade notes» lo que cambia para una instancia existente, como, en la 2.36.0, una configuración que ahora se comprueba por completo al arrancar, o los contadores diarios puestos a cero. Léalas antes de actualizar y copie las dos carpetas justo antes. La versión 2.38.1 es una versión de seguridad que el proyecto recomienda encarecidamente: refuerza las plantillas de mensajes frente a ataques de denegación de servicio e impide que las subidas lentas de adjuntos a S3 y los endpoints de web push que no responden acaparen memoria y conexiones. Sucede a la 2.38.0, que comparte los límites de frecuencia entre los nodos de un clúster y se compila con Go 1.27.4.
El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; ntfy sigue siendo su software, con sus ajustes y sus datos.
| Tema | Nuestros equipos | Usted |
|---|---|---|
| El servidor | Actualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidas | El momento que mejor convenga a su actividad |
| La supervisión | Servidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamada | La lectura de los registros de su instancia |
| ntfy | Seguimiento proactivo: errores, lentitud, conexiones abiertas y espacio en disco detectados, corrección recomendada | Su instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA |
| Los accesos | El servidor que lo soporta, vigilado y con copias de seguridad | Los usuarios, los permisos de los temas y los tokens de sus scripts |
| Las copias de seguridad | Cada noche, cifradas y guardadas fuera de la máquina; restauración incluida | Las copias propias de ntfy, y la petición de restauración, cuando la necesite |
| La migración | Su servidor actual migrado, gratis | El momento del cambio |
Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.
Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de ntfy, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.
Sí. ntfy tiene doble licencia, Apache 2.0 y GPLv2: puede ejecutarlo en su empresa sin ninguna licencia que comprar. Sus condiciones se aplican a la redistribución del software. Queda el coste del servidor que lo ejecuta.
Cree un compose.yaml con la imagen binwiederhier/ntfy, el comando serve, una carpeta montada en /etc/ntfy para server.yml, otra en /var/lib/ntfy para las bases de datos, y el puerto 80 del contenedor publicado en 127.0.0.1:2586. Ejecute docker compose up -d y coloque después delante de ese puerto un proxy inverso en HTTPS.
En server.yml, defina auth-file y auth-default-access: deny-all. Cree después un administrador con ntfy user add --role=admin, usuarios limitados con ntfy user add, y sus permisos sobre los temas con ntfy access.
Cree un token con ntfy token add para un usuario dedicado al script, limitado a sus temas, y publique después con curl y la cabecera Authorization: Bearer seguida del token, en HTTPS. Un token da acceso a toda la cuenta de su usuario.
Detrás de un proxy inverso, todas las peticiones llegan desde la dirección del proxy. Con behind-proxy: true, ntfy lee la cabecera X-Forwarded-For para identificar a cada visitante; sin él, todos comparten los mismos límites de frecuencia.
Sí, con upstream-base-url: "https://ntfy.sh" en server.yml. Su servidor hace entonces que ntfy.sh retransmita una señal que solo contiene el identificador del mensaje, y la aplicación recupera el mensaje en su servidor. Sin este ajuste, la entrega puede tardar varias horas.
Haga copia de server.yml y de user.db, que guardan la configuración, los usuarios, los permisos y los tokens, además del archivo Web Push si está activado. La caché de mensajes y los archivos adjuntos tienen una vida corta. Detenga el servicio durante la copia, para obtener archivos SQLite coherentes.
Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.
Simafri
Hablemos de su proyecto
Díganos en pocas palabras lo que necesita: le respondemos rápidamente.
¡Gracias! Su solicitud ha sido enviada. Le responderemos en breve.
¿Prefiere el correo? Escríbanos a support@simafri.com.