ntfy-palvelimen asennusopas
Tässä oppaassa on ohjeet ntfy-palvelimen asentamiseen eri Linux-jakeluihin sekä muihin käyttöjärjestelmiin. ntfy on yksinkertainen HTTP-pohjainen pub-sub ilmoituspalvelu.
Edellytykset
- Linux-järjestelmä (tai muu tuettu käyttöjärjestelmä)
- Root-käyttöoikeus tai sudo-oikeudet
- Internet-yhteys binäärien ja pakettien lataamista varten
1. vaihe. Manuaalinen asennus lähdekoodista (Binary Tarballs)
Tämä menetelmä toimii millä tahansa Linux-jakelulla, joka tukee järjestelmäsi erityistä arkkitehtuuria.
Vaihe 1: Tunnista arkkitehtuuri
Suorita uname -m tarkistaaksesi arkkitehtuuri:
x86_64taiamd64armv7taiarmhfarm64(aarch64)armv6
Vaihe 2: Lataa ja pura binääri
Esimerkki x86_64/amd64-arkkitehtuurille:
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
Esimerkki armv7/armhf:lle:
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
Esimerkki arm64:lle:
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
Vaihe 3: Asenna binaari- ja määritystiedostot
# 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/
Vaihe 4: Käynnistä palvelin
sudo ntfy serve
- Kaksi. Asenna järjestelmäpalveluna (Systemd)
Jos haluat palvelimen käynnistyvän automaattisesti käynnistyksen yhteydessä, käytä systemd: tä.
Edellytykset
- Varmista, että käyttöjärjestelmäsi käyttää systemd:tä (
systemctl --version). - Sinun on asennettava binääri- ja config-tiedostot yllä olevassa vaiheessa 1.
Vaiheet
Tarkista tila:
sudo systemctl status ntfy
Lataa Systemd uudelleen ja käynnistä palvelu:
sudo systemctl daemon-reload
sudo systemctl enable ntfy
sudo systemctl start ntfy
Kopioi palveluyksikkötiedosto:
# 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
Kolme. Asenna järjestelmäpalveluna (OpenRC)
OpenRC:tä käyttäville järjestelmille (esim. Alpine Linux, Gentoo).
Vaiheet
Lisää Default Runlevel (aloittaa käynnistyksen yhteydessä):
sudo rc-update add ntfy default
Käynnistä palvelu:
sudo rc-service ntfy start
Kopioi palveluskripti:
# Replace <architecture> with your system's architecture
sudo mv <architecture>/server/ntfy.openrc /etc/init.d/ntfy
sudo chmod 755 /etc/init.d/ntfy
- Neljä. Asennus pakettivarastoista
Debian/Ubuntu
Huomautus: Vuoden 2025 lopusta lähtien virallinen arkisto on siirtynyt archive.ntfy.sh: een. Vanha (heckel.io) on vanhentunut.
APT:n käyttö (suositus)
# 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
Manuaalinen.deb-asennus
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
Arch Linux (englanniksi)
AUR Helperin käyttäminen (suositus)
paru -S ntfysh-bin
Manuaalinen asennus
curl https://aur.archlinux.org/cgit/aur.git/snapshot/ntfysh-bin.tar.gz | tar xzv
cd ntfysh-bin
makepkg -si
NixOS / Nix
- NixOS kokoonpano: Lisää
services.ntfy-sh.enable = true;oman/etc/nixos/configuration.nixja ajaanixos-rebuild switch. - Käyttäjäympäristö:
nix-env -iA ntfy-sh
FreeBSD
pkg install go-ntfy
Viisi. macOS:n asennus
macOS tukee CLI: tä (ntfy publish, ntfy subscribe), mutta ei tue palvelinta virallisten pakettien kautta.
Manuaalinen CLI-asennus
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
Huomautus: Jos haluat käyttää palvelinta macOS: ssä, sinun on rakennettava se manuaalisesti Go: n avulla (katso Rakennusohjeet).
Kuusi. Homebrew-asennus
brew install ntfy
Tämä asentaa vain CLI:n. Palvelimen asennus vaatii manuaalisia vaiheita.
Seitsemän. Windowsin asennusohjelma
Käyttäjäohjelmana
- Lataa ZIP-tiedosto GitHubin julkaisuista.
- Pura tiedosto
ntfy.exeja aseta se%Path%-tiedostoosi (esim.C:\Program Files\).
Suorita komentoja, kuten:
ntfy.exe -h
Windows-palveluna
- Avaa korotettu komentokehote.
Käynnistä palvelu:
sc start ntfy
Luo palvelu:
sc create ntfy binPath="C:\path\to\ntfy.exe serve" start=auto
Kahdeksan. Dockerin asennus
Peruskäyttö (ei pysyvää välimuistia)
docker run -p 80:80 -it binwiederhier/ntfy serve
Pysyvällä välimuistilla
docker run \
-v /var/cache/ntfy:/var/cache/ntfy \
-p 80:80 \
-it \
binwiederhier/ntfy \
serve \
--cache-file /var/cache/ntfy/cache.db
Mukautetun Config (Non-root käyttäjä)
docker run \
-v /etc/ntfy:/etc/ntfy \
-e TZ=UTC \
-p 80:80 \
-u UID:GID \
-it \
binwiederhier/ntfy \
serve
Docker Compose -esimerkki
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
Yhdeksän. Kubernetes (K8s) käyttöönotto
StatefulSet pysyvällä välimuistilla
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
Vianmääritys
- Palvelu ei käynnisty: Tarkista lokit
sudo journalctl -u ntfy: lla (systemd) taisudo rc-service ntfy status: llä (OpenRC). - Permission Denied: Varmista, että binääri- ja asetustiedostot ovat rootin tai tietyn käyttäjän omistuksessa, jos niitä ajetaan muuna kuin root-käyttäjänä.
- Portti jo käytössä: Vaihda portti
server.yml- tai Docker run -komennossa (-p 8080:80).
Asetustiedostot
- Asiakas Config:
/etc/ntfy/client.yml(tai~/.config/ntfy/client.ymlei-root). - Palvelimen asetukset:
/etc/ntfy/server.yml.
Muokkaamalla näitä tiedostoja voit mukauttaa asetuksia, kuten aikavyöhykettä, viestin enimmäiskokoa tai säilytyskäytäntöä.
Tietoturvaa koskevat huomautukset
- Suorita ntfy aina ei-root-käyttäjänä tuotannossa, jos mahdollista (määritetään
user-lipun kautta Dockerissa tai systemd-palvelussa). - Varmista, että verkkokäyttöliittymä on käytettävissä vain luotettujen verkkojen kautta, jos se altistuu julkisesti.
- Päivitä asennus säännöllisesti tietoturvahaavoittuvuuksien korjaamiseksi.
Lisätietoja on osoitteessa ntfy GitHub Repository.
Määritysparametrit
Kun olet ostanut tämän sovelluksen Esadax, sinua pyydetään antamaan kokoonpano parametrit alla. Esadax lisää toimitetut muuttujat käyttöönottoon, jotta sovellus voidaan käynnistää sen vaatimalla kokoonpanolla.
| Parametri | Kuvaus |
|---|---|
ADMIN_USERNAME |
ADMIN_USERNAME:n käyttöönottoon toimitettu arvo. |
ADMIN_PASSWORD |
ADMIN_PASSWORD:n käyttöönottoon toimitettu arvo. |
Kun arvot on määritetty, käynnistä sovellus valitsemalla Ota käyttöön. Ostettu sovellus käyttää toimitettuja kokoonpanoarvoja, mukaan lukien tunnistetiedot, kuten käyttäjätunnukset ja salasanat, kun nämä parametrit on annettu.

