Etusivu/Artikkeli
Esadax JournalApps

ntfy

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-

ntfy logo

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_64 tai amd64
  • armv7 tai armhf
  • arm64 (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.nix ja ajaa nixos-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

  1. Lataa ZIP-tiedosto GitHubin julkaisuista.
  2. Pura tiedosto ntfy.exe ja aseta se %Path%-tiedostoosi (esim. C:\Program Files\).

Suorita komentoja, kuten:

ntfy.exe -h

Windows-palveluna

  1. 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) tai sudo 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.yml ei-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.

Tilaa