Inicio/Artículo
Esadax JournalApps

ntfy

Guía de instalación del servidor ntfy Esta guía proporciona instrucciones para instalar el servidor ntfy en varias distribuciones de Linux, así como otros sistemas operativos. ntfy es un simple servicio de notificación

ntfy logo

Guía de instalación del servidor ntfy

Esta guía proporciona instrucciones para instalar el servidor ntfy en varias distribuciones de Linux, así como otros sistemas operativos. ntfy es un simple servicio de notificación pub-sub basado en HTTP.

Requisitos previos

  • Un sistema Linux (u otro sistema operativo compatible)
  • Acceso de root o privilegios de sudo
  • Una conexión a Internet para descargar binarios y paquetes

1. Aplicación. Instalación manual desde el código fuente (tarballs binarios)

Este método funciona en cualquier distribución de Linux que soporte la arquitectura específica de su sistema.

Paso 1: Identifique su arquitectura

Ejecute uname -m para comprobar su arquitectura:

  • x86_64 o amd64
  • armv7 o armhf
  • arm64 (aarch64)
  • armv6

Paso 2: Descargar y extraer el binario

Ejemplo para x86_64/amd64:

wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_amd64.tar.gz
tar zxvf ntfy_2.28.0_linux_amd64.tar.gz

Ejemplo para armv7/armhf:

wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_armv7.tar.gz
tar zxvf ntfy_2.28.0_linux_armv7.tar.gz

Ejemplo para arm64:

wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_arm64.tar.gz
tar zxvf ntfy_2.28.0_linux_arm64.tar.gz

Paso 3: Instalar los archivos binarios y de configuración

# Copy the binary to /usr/bin
sudo cp -a <architecture>/ntfy /usr/bin/ntfy

# Create config directory and copy files
sudo mkdir -p /etc/ntfy
sudo cp <architecture>/client/client.yml /etc/ntfy/
sudo cp <architecture>/server/server.yml /etc/ntfy/

Paso 4: Inicie el servidor

sudo ntfy serve

2. Instalar como servicio del sistema (Systemd)

Si desea que el servidor se inicie automáticamente al arrancar, utilice systemd.

Requisitos previos

  • Asegúrese de que su sistema operativo utiliza systemd (systemctl --version).
  • Debe haber instalado los archivos binarios y de configuración en el paso 1 anterior.

Pasos

Verificar estado:

sudo systemctl status ntfy

Recargue Systemd e inicie el servicio:

sudo systemctl daemon-reload
sudo systemctl enable ntfy
sudo systemctl start ntfy

Copie el archivo de la unidad de servicio:

# Replace <architecture> with your system's architecture (e.g., amd64, armv7)
sudo mv <architecture>/server/ntfy.service /etc/systemd/system/
sudo chmod 644 /etc/systemd/system/ntfy.service

3. Instalar como servicio del sistema (OpenRC)

Para sistemas que usan OpenRC (por ejemplo, Alpine Linux, Gentoo).

Pasos

Añadir al nivel de ejecución predeterminado (para iniciar al arrancar):

sudo rc-update add ntfy default

Comience el servicio:

sudo rc-service ntfy start

Copie el script de servicio:

# Replace <architecture> with your system's architecture
sudo mv <architecture>/server/ntfy.openrc /etc/init.d/ntfy
sudo chmod 755 /etc/init.d/ntfy

4. Instalación a través de repositorios de paquetes

Debian/Ubuntu

Nota: A finales de 2025, el repositorio oficial se ha trasladado a archive.ntfy.sh. El antiguo (heckel.io) está obsoleto.

Usando APT (Recomendado)

# Add keyring
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

# Add repository
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

# Update and Install
sudo apt update
sudo apt install ntfy

Instalación manual.deb

wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_amd64.deb
sudo dpkg -i ntfy_*.deb
sudo systemctl enable ntfy
sudo systemctl start ntfy

Fedora/RHEL/CentOS

# Install RPM
sudo rpm -ivh https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_amd64.rpm

# Enable and Start
sudo systemctl enable ntfy
sudo systemctl start ntfy

Acerca de Arch Linux

Usando AUR Helper (Recomendado)

paru -S ntfysh-bin

Instrucciones de instalación manual

curl https://aur.archlinux.org/cgit/aur.git/snapshot/ntfysh-bin.tar.gz | tar xzv
cd ntfysh-bin
makepkg -si

NixOS / Nix

  • Configuración de NixOS: Añade services.ntfy-sh.enable = true; a tu /etc/nixos/configuration.nix y ejecuta nixos-rebuild switch.
  • Entorno de usuario: nix-env -iA ntfy-sh

FreeBSD

pkg install go-ntfy

Artículo 5. Instalación de macOS

macOS soporta la CLI (ntfy publish, ntfy subscribe) pero no soporta el servidor a través de paquetes oficiales.

Instalación manual de CLI

curl -L https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_darwin_all.tar.gz > ntfy.tar.gz
tar zxvf ntfy.tar.gz
sudo cp -a ntfy_2.28.0_darwin_all/ntfy /usr/local/bin/ntfy
mkdir ~/Library/Application\ Support/ntfy
cp ntfy_2.28.0_darwin_all/client/client.yml ~/Library/Application\ Support/ntfy/client.yml
Nota: Para ejecutar el servidor en macOS, debe compilarlo manualmente usando Go (consulte Instrucciones de compilación).

Artículo 6. Instalación de Homebrew

brew install ntfy

Esto instala solo la CLI. La instalación del servidor requiere pasos manuales.


Artículo 7. Instalación de Windows

Como programa de usuario

  1. Descarga el ZIP desde GitHub Releases.
  2. Extraiga y coloque ntfy.exe en su %Path% (por ejemplo, C:\Program Files\).

Ejecuta comandos como:

ntfy.exe -h

Como servicio de Windows

  1. Abre un símbolo del sistema elevado.

Inicie el servicio:

sc start ntfy

Crear el servicio:

sc create ntfy binPath="C:\path\to\ntfy.exe serve" start=auto

Artículo 8. Instalación de Docker

Uso básico (sin caché persistente)

docker run -p 80:80 -it binwiederhier/ntfy serve

Con caché persistente

docker run \
  -v /var/cache/ntfy:/var/cache/ntfy \
  -p 80:80 \
  -it \
  binwiederhier/ntfy \
  serve \
  --cache-file /var/cache/ntfy/cache.db

Con configuración personalizada (usuario no root)

docker run \
  -v /etc/ntfy:/etc/ntfy \
  -e TZ=UTC \
  -p 80:80 \
  -u UID:GID \
  -it \
  binwiederhier/ntfy \
  serve

Ejemplo de Docker Compose

version: '3'
services:
  ntfy:
    image: binwiederhier/ntfy
    container_name: ntfy
    command: ["serve"]
    environment:
      - TZ=UTC
    user: "1000:1000" # Replace with your UID/GID
    volumes:
      - /var/cache/ntfy:/var/cache/ntfy
      - /etc/ntfy:/etc/ntfy
    ports:
      - "80: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

Artículo 9. Implementación de Kubernetes (K8s)

StatefulSet con caché persistente

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: ntfy
spec:
  serviceName: ntfy
  replicas: 1
  selector:
    matchLabels:
      app: ntfy
  template:
    metadata:
      labels:
        app: ntfy
    spec:
      containers:
        - name: ntfy
          image: binwiederhier/ntfy
          args: ["serve", "--cache-file", "/var/cache/ntfy/cache.db"]
          ports:
            - containerPort: 80
              name: http
          volumeMounts:
            - name: config
              mountPath: /etc/ntfy
              readOnly: true
            - name: cache
              mountPath: /var/cache/ntfy
      volumes:
        - name: config
          configMap:
            name: ntfy
        - name: cache
          persistentVolumeClaim:
            claimName: ntfy-cache
---
apiVersion: v1
kind: Service
metadata:
  name: ntfy
spec:
  selector:
    app: ntfy
  ports:
    - port: 80
      targetPort: 80
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: ntfy-cache
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi

Solución de problemas

  • Servicio no iniciado: Compruebe los registros con sudo journalctl -u ntfy (systemd) o sudo rc-service ntfy status (OpenRC).
  • Permiso denegado: Asegúrese de que los archivos binarios y de configuración sean propiedad de root o de un usuario específico si no se ejecuta como root.
  • Puerto ya en uso: Cambie el puerto en server.yml o el comando de ejecución de Docker (-p 8080:80).

Archivos de configuración

  • Configuración del cliente: /etc/ntfy/client.yml (o ~/.config/ntfy/client.yml para usuarios no root).
  • Configuración del servidor: /etc/ntfy/server.yml.

Edite estos archivos para personalizar la configuración, como la zona horaria, el tamaño máximo de mensaje o la política de retención.


Notas de seguridad

  • Siempre ejecute ntfy como un usuario que no sea root en producción si es posible (configure a través de la bandera user en Docker o el servicio systemd).
  • Asegúrese de que la IU web sea accesible solo a través de redes de confianza si se expone públicamente.
  • Actualice regularmente su instalación para corregir las vulnerabilidades de seguridad.

Para obtener más detalles, visite el ntfy GitHub Repository.

Parámetros de configuración

Después de comprar esta aplicación en Esadax, se le pedirá que proporcione los parámetros de configuración a continuación. Esadax añade las variables suministradas al despliegue para que la aplicación pueda ser lanzada con la configuración que requiera.

Parámetro Descripción
ADMIN_USERNAME Valor suministrado a la implementación para ADMIN_USERNAME.
ADMIN_PASSWORD Valor suministrado a la implementación para ADMIN_PASSWORD.

Una vez configurados los valores, haga clic en Deploy para iniciar la aplicación. La aplicación comprada utilizará los valores de configuración suministrados, incluidas credenciales como nombres de usuario y contraseñas cuando se proporcionen esos parámetros.

Suscribirse