Alojar ntfy en un VPS administrado: notificaciones push desde su propio servidor

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.

Simon Vasconcelos Lee Por Publicado el 21 de noviembre de 202615 minutos de lectura

Todas las guías

Lo esencial

  1. ntfy recibe un mensaje mediante una petición HTTP PUT o POST dirigida a un tema, y lo envía al instante a los teléfonos, navegadores y scripts suscritos a ese tema.
  2. Su doble licencia, Apache 2.0 y GPLv2, permite ejecutarlo libremente en una empresa; sus condiciones se aplican a la redistribución del software.
  3. Instálelo con Docker Compose: la imagen 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.
  4. Por defecto, todo el mundo puede leer y escribir en todos los temas: defina 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.
  5. Haga copia de 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.

Qué hace ntfy

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.

Terminal, un primer mensaje
curl -d "Backup finished" https://ntfy.example.com/backups

Las licencias Apache 2.0 y GPLv2, y la marca

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.

Los recursos que hay que prever

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:

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 instalación con Docker Compose

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:

compose.yaml
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:

etc/server.yml
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
Terminal, en la carpeta del compose.yaml
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:

Sin Docker: el repositorio de Debian y Ubuntu

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:

Terminal
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".

Usuarios, control de acceso y tokens

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.

Terminal, el primer administrador
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.

Un usuario y un token por script

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:

Terminal
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

El script publica después con su token, en HTTPS:

Terminal, en la máquina que publica
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.

HTTPS: el proxy inverso

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:

Con Caddy

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:

Caddyfile
ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}

Con Nginx

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:

/etc/nginx/sites-available/ntfy
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;
    }
}
Terminal
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 Android, iOS y web

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.

Las notificaciones instantáneas en iOS

Añada una línea a server.yml y reinicie después el contenedor:

etc/server.yml
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.

Los límites de frecuencia y los archivos adjuntos

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:

AjustePor defectoLo que limita
visitor-request-limit-burst60Las peticiones de un visitante en una ráfaga
visitor-request-limit-replenish5sEl ritmo de recarga: una petición cada 5 segundos
visitor-subscription-limit30Las conexiones abiertas por visitante
visitor-message-daily-limitNingunoLos mensajes por día, regulados si no por el límite de peticiones
visitor-email-limit-burst16Los correos en una ráfaga, y después uno por hora
visitor-attachment-total-size-limit100MEl almacenamiento de archivos adjuntos por visitante
visitor-attachment-daily-bandwidth-limit500MEl tráfico de archivos adjuntos por visitante y por día
global-topic-limit15.000El número total de temas del servidor
message-size-limit4KEl tamaño de un mensaje; por encima, se convierte en archivo adjunto

Las notificaciones por correo electrónico

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.

etc/server.yml
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "smtp-password"
smtp-sender-from: "ntfy@example.com"
Terminal
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

Las copias de seguridad

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:

ElementoLo que guardaCopiarlo
etc/server.ymlLa configuración, incluidos los secretos SMTP y las claves Web PushSí
lib/user.dbLos usuarios, las entradas de control de acceso, los tokens y los contadores diariosSí
lib/cache.dbLos 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-fileLas suscripciones Web Push de los navegadores, si lo ha activadoSí

Para una copia coherente de los archivos SQLite, detenga el servicio mientras se crea el archivo comprimido:

Terminal, en la carpeta del compose.yaml
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.

Las actualizaciones

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:

Terminal, en la carpeta del compose.yaml
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.

Quién hace qué en un VPS administrado

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.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor convenga a su actividad
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaLa lectura de los registros de su instancia
ntfySeguimiento proactivo: errores, lentitud, conexiones abiertas y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA
Los accesosEl servidor que lo soporta, vigilado y con copias de seguridadLos usuarios, los permisos de los temas y los tokens de sus scripts
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaLas copias propias de ntfy, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl 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.

ntfy, en un servidor que cuidamos por usted

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.

Descubrir los VPS administrados

Preguntas frecuentes

¿ntfy es gratuito para una empresa?

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.

¿Cómo instalar ntfy con Docker Compose?

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.

¿Cómo hacer privado un servidor ntfy?

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.

¿Cómo publicar en ntfy desde un script con un token?

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.

¿Por qué definir behind-proxy en ntfy?

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.

¿Las notificaciones de ntfy llegan al instante a un iPhone?

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.

¿Cómo hacer copia de seguridad de ntfy?

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 ntfy?

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.

Fuentes y documentación oficial

Guías relacionadas

Alojar Uptime Kuma en un VPS administrado: vigile sus servicios sin pausaAlojar Uptime Kuma en un VPS administrado significa vigilar sus sitios, sus API y sus servidores desde una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Uptime Kuma es software libre con licencia MIT. Esta guía sigue su documentación oficial: la instalación con Docker Compose, HTTPS, la base de datos, las notificaciones, las copias de seguridad y las actualizaciones.Diferencia entre VPS administrado y no administrado: quién hace quéLa diferencia entre un VPS administrado y uno no administrado se reduce a una pregunta: quién se ocupa del servidor una vez que está en marcha. Sin embargo, «administrado» carece de una definición oficial y, de un proveedor a otro, la palabra va desde una simple instalación del sistema hasta la explotación completa del servidor. Esta guía muestra quién hace qué, tarea por tarea, con el nivel intermedio de la asistencia, y da las preguntas que despejan la ambigüedad antes de firmar.Copias de seguridad de un VPS: qué comprobar antes de contratarUna oferta de VPS anuncia casi siempre «copias de seguridad incluidas». Detrás de estas palabras puede haber una copia cada noche, guardada fuera de la máquina y restaurada por expertos, o una instantánea situada en el mismo disco que el servidor. Esta guía da las preguntas que marcan la diferencia, lo que significa cada respuesta y la forma de comprobar que una copia de seguridad se restaura.
Contáctenos