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_64oamd64armv7oarmhfarm64(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.nixy ejecutanixos-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
- Descarga el ZIP desde GitHub Releases.
- Extraiga y coloque
ntfy.exeen su%Path%(por ejemplo,C:\Program Files\).
Ejecuta comandos como:
ntfy.exe -h
Como servicio de Windows
- 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) osudo 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.ymlo 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.ymlpara 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
useren 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.

