At hoste ntfy på en Managed VPS betyder, at du sender pushnotifikationer med en almindelig HTTP-anmodning, PUT eller POST, fra en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. ntfy er fri software med dobbelt licens, Apache 2.0 og GPLv2. Denne guide følger den officielle dokumentation i version 2.38.1: installation med Docker Compose, filen server.yml, brugere og adgangskontrol, adgangstokens, HTTPS, mobilapps, e-mail, backup og opdateringer.
Af Simon Vasconcelos Lee
Udgivet den 21. november 2026Læsetid: 15 minutter
binwiederhier/ntfy, en server.yml med base-url, cache-file og auth-file og porten publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.auth-default-access: deny-all, opret en administrator med ntfy user add, og giv derefter hvert script sit eget token og begrænsede rettigheder.server.yml og user.db, som rummer konfigurationen, brugerne, rettighederne og tokens; opdatér ved at ændre imagets tag, efter at du har læst release notes.ntfy, der udtales «notify», er en HTTP-baseret notifikationstjeneste efter publish-subscribe-princippet. Dens README præsenterer den som en måde at sende notifikationer til din telefon eller din computer fra scripts, fra en hvilken som helst computer. Projektet driver en offentlig instans, ntfy.sh, og serveren kan hostes selv: det er emnet for denne guide.
curl, et script, et planlagt job eller en anden applikation. En besked kan have en titel, en prioritet fra 1 til 5, tags og emojis, en vedhæftet fil, handlingsknapper eller et forsinket leveringstidspunkt.ntfy eller API'et, via WebSocket eller en HTTP-stream, der forbliver åben.curl -d "Backup finished" https://ntfy.example.com/backups
ntfys README oplyser, at projektet har dobbelt licens: Apache License 2.0, i filen LICENSE, og GNU GPL version 2, i LICENSE.GPLv2. Docker-imaget angiver begge, Apache-2.0, GPL-2.0.
At køre ntfy på din server, for din virksomhed, dit team eller dine kunder, kræver altså ingen licens at købe. Begge tekster leverer softwaren uden garanti.
Licensen dækker koden. Navnet er en anden sag: Apache License 2.0 giver ingen rettigheder til licensgiverens varemærker, og servicevilkårene for ntfy.sh oplyser, at navnet, logoet og den visuelle identitet for ntfy er varemærker tilhørende ntfy LLC, og at brug af dem i forbindelse med et produkt eller en tjeneste kræver deres forudgående skriftlige samtykke. Denne guide nævner ntfy for at beskrive softwaren.
Denne publikation er uafhængig af ntfy-projektet og ntfy LLC og er hverken tilknyttet, sponsoreret eller godkendt af dem.
Serveren er en enkelt, statisk linket binærfil til amd64, armv7 og arm64; Docker-imaget findes også til armv6. Dokumentationen opgiver ingen tal for hukommelse eller CPU: for en server derhjemme, siger den, er skalering ikke noget at bekymre sig om. I stedet peger den på det, der sætter grænsen for en instans:
nofile, tillader. Pakkens systemd-tjeneste sætter den til 10.000.På en Managed VPS fortæller du os om dit brug, antallet af abonnerende enheder, mængden af beskeder og de vedhæftede filer, og vi anbefaler den størrelse, der passer.
Dokumentationen tilbyder imaget binwiederhier/ntfy fra Docker Hub. Det leverer webappen og API'et på containerens port 80 og indeholder ingen fil server.yml: konfigurationen lægges i en mappe, der er monteret på /etc/ntfy. Opret en mappe på en server med Docker installeret, og læg denne compose.yaml i den, baseret på dokumentationens eksempel:
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
Derefter konfigurationsfilen, i etc/server.yml, med din servers offentlige adresse:
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
docker compose up -d
curl http://127.0.0.1:2586/v1/health
Serveren svarer {"healthy":true,"role":"active"}. Hvad hver indstilling gør:
127.0.0.1:2586: dokumentationens Docker-eksempler publicerer port 80 på alle adresser, og dens eksempler med reverse proxy videresender til 127.0.0.1:2586. Publiceret på denne måde kan porten kun nås fra selve serveren, og API'et nås udelukkende via reverse proxyen, over HTTPS.base-url: tjenestens offentlige adresse. Eksempelfilen server.yml kræver den til vedhæftede filer, afsendelse af e-mail og iOS-notifikationer fra en selvhostet server.cache-file: uden den bliver beskederne 12 timer i hukommelsen og går tabt ved genstart. Denne cache lader telefoner med en ustabil forbindelse hente de beskeder, de er gået glip af.attachment-cache-dir: aktiverer vedhæftede filer. ntfy overtager den fulde kontrol over denne mappe, så reservér den til dette formål.auth-file og auth-default-access: deny-all: databasen med brugere og rettigheder, der oprettes ved første start, og anonym adgang, der som standard afvises. Det er den indstilling, dokumentationen anbefaler til en privat instans.behind-proxy: uden den deler alle besøgende bag en proxy proxyens IP-adresse og de samme hastighedsgrænser.enable-login: gør det muligt at logge ind i webappen. Fri tilmelding forbliver lukket, da enable-signup som standard er false.v2.38.1 fastlåser versionen; latest følger den nyeste udgivelse. Dokumentationen tilbyder også user: UID:GID til en konto uden root-rettigheder: filerne i etc og lib tilhører så den konto.Projektet udgiver også et pakkerepositorium, signeret med nøglen med fingeraftrykket 55BA 774A 6F5E E674 31E4 B6B7 CFDB 962D 4F1E C4AF. På en amd64-server:
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
Pakken læser /etc/ntfy/server.yml. Eksempelfilen anbefaler /var/cache/ntfy/cache.db til cachen og /var/lib/ntfy/user.db til brugerne, to mapper, som pakken opretter. Bag en proxy tilføjer du listen-http: "127.0.0.1:2586".
Fra start er en ntfy-server åben: alle kan læse og skrive i alle topics, og topicets navn fungerer som adgangskode. Med auth-file og deny-all slipper intet igennem uden loginoplysninger. ntfy har to roller: admin, der læser og skriver i alle topics, og user, der kun har de rettigheder, du giver den.
docker compose exec ntfy ntfy user add --role=admin alice
Kommandoen beder om adgangskoden og derefter om at bekræfte den. Kommandoerne ntfy user, ntfy access og ntfy token skriver direkte i brugerdatabasen: de kører på serveren, her inde i containeren, som læser stien til databasen fra server.yml.
Et adgangstoken giver i dag fuld adgang til brugerens konto, bortset fra at ændre adgangskoden og slette kontoen. Til et script opretter du en dedikeret bruger, begrænset til sine topics, og derefter et token til den:
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
read-write, read-only, write-only eller deny, på et bestemt topic eller på et mønster som alerts-*, det eneste understøttede jokertegn.everyone, eller *. Til UnifiedPush på en privat instans åbner dokumentationen de topics, der begynder med up, alene for skrivning: ntfy access '*' 'up*' write-only.tk_, kan udløbe med --expires=30d, og hver bruger kan have op til 60 af dem. ntfy token list viser dem, ntfy token remove sletter et.auth-users, auth-access og auth-tokens de samme objekter fra server.yml, ved hver start. En bruger, der fjernes fra den liste, slettes fra databasen ved næste genstart.Scriptet publicerer derefter med sit token, over HTTPS:
curl \
-H "Authorization: Bearer tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2" \
-H "Title: Backup finished" \
-H "Priority: high" \
-d "The nightly backup went fine." \
https://ntfy.example.com/backups
En adgangskode i Basic auth er kun base64-kodet, ikke krypteret: dokumentationen kræver HTTPS på enhver selvhostet server. Det er emnet for næste afsnit.
ntfy kan selv levere HTTPS, men bag en proxy anbefaler dokumentationen at overlade TLS-termineringen til proxyen. To punkter betyder mere end alt andet:
Upgrade og Connection og lader disse lange forbindelser leve. ntfy sender som standard en keepalive-besked hvert 45. sekund, keepalive-interval, så ingen mellemled lukker dem på grund af inaktivitet.behind-proxy: true læser ntfy headeren X-Forwarded-For og beholder adressen længst til højre, den, som din proxy tilføjer. Hastighedsgrænserne gælder for den adresse.Dokumentationen bemærker, at Caddy håndterer både HTTP og WebSockets med reverse_proxy, uden ekstra indstillinger. Den henter selv certifikatet fra Let’s Encrypt:
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}
Denne blok følger dokumentationens konfiguration, tæt på den, ntfy.sh kører: buffering slået fra for streams, timeouts på 3 minutter og ingen størrelsesgrænse for anmodningers indhold, som ntfy selv begrænser. Den lytter på port 80, så Certbot kan sætte HTTPS op:
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;
}
}
sudo ln -s /etc/nginx/sites-available/ntfy /etc/nginx/sites-enabled/
sudo nginx -t
sudo certbot --nginx -d ntfy.example.com
Når HTTP viderestiller til HTTPS, publicerer du til https://-adresser i dine scripts. Til tusindvis af abonnenter hæver dokumentationen worker_connections i nginx.conf og Nginx-tjenestens LimitNOFILE til det dobbelte af det antal forbindelser, du sigter efter.
ntfy-apps tilføjer topics fra din server på samme måde som fra ntfy.sh: indtast serverens adresse, når du tilføjer topicet, og for et beskyttet topic brugernavn og adgangskode for en bruger, der har adgang til det. Webappen leveres på serverens egen adresse.
ntfy webpush keys og et gyldigt HTTPS-certifikat.Tilføj én linje til server.yml, og genstart derefter containeren:
upstream-base-url: "https://ntfy.sh"
For hver besked publicerer din server så en poll-anmodning til ntfy.sh, som kun indeholder beskedens ID og SHA-256-hashen af topicets URL. ntfy.sh sender den videre til enheden via Apples notifikationstjeneste, hvorefter appen henter beskeden fra din server. Den tekst, der går via ntfy.sh, er altid den samme, «New message», uanset hvad din besked siger. Uden denne indstilling når notifikationerne stadig frem, med en forsinkelse, der kan nå op på flere timer afhængigt af telefonens tilstand. upstream-access-token tilføjer et token, hvis du overskrider hastighedsgrænserne hos ntfy.sh.
ntfy begrænser hver besøgende, identificeret ved sin IP-adresse og for IPv6 ved sit /64-subnet. Disse grænser beskytter serveren mod misbrug; ved normal brug bør du ifølge dokumentationen ikke støde på dem. Ud over dem svarer serveren 429 Too Many Requests. Standardværdierne:
| Indstilling | Standard | Hvad den begrænser |
|---|---|---|
visitor-request-limit-burst | 60 | En besøgendes anmodninger i ét ryk |
visitor-request-limit-replenish | 5s | Genopfyldningstakten: én anmodning hvert 5. sekund |
visitor-subscription-limit | 30 | Åbne forbindelser pr. besøgende |
visitor-message-daily-limit | Ingen | Beskeder pr. dag, ellers styret af grænsen for anmodninger |
visitor-email-limit-burst | 16 | E-mails i ét ryk, derefter én pr. time |
visitor-attachment-total-size-limit | 100M | Lagerplads til vedhæftede filer pr. besøgende |
visitor-attachment-daily-bandwidth-limit | 500M | Trafik med vedhæftede filer pr. besøgende pr. dag |
global-topic-limit | 15.000 | Serverens samlede antal topics |
message-size-limit | 4K | En beskeds størrelse; ud over den bliver den til en vedhæftet fil |
visitor-request-limit-exempt-hosts, en liste over IP-adresser eller værtsnavne.ntfy tier, giver visse konti højere grænser.attachment-file-size-limit, som standard 15M, begrænser hver fil, attachment-total-size-limit, 5G, hele lageret, og attachment-expiry-duration, 3h, deres levetid. En vedhæftet fil lever højst lige så længe som sin besked: for at beholde vedhæftede filer længere hæver du også cache-duration.ntfy kan videresende en besked via e-mail, når publiceringsanmodningen har headeren Email, eller X-Email, med en adresse. Til det går den gennem en udgående SMTP-server, med STARTTLS og godkendelse via PLAIN eller LOGIN: det er port 587. Fra en Simafri VPS går afsendelsen gennem et autentificeret SMTP-relay på samme port 587: angiv her adressen på en e-mailkonto, du allerede har, eller på din afsendertjeneste.
smtp-sender-addr: "smtp.example.com:587"
smtp-sender-user: "ntfy@example.com"
smtp-sender-pass: "smtp-password"
smtp-sender-from: "ntfy@example.com"
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
base-url og smtp-sender-from er påkrævet, så snart smtp-sender-addr er sat: uden dem nægter serveren at starte.smtp-sender-verify: true begrænser afsendelsen til de adresser, hver bruger har bekræftet på sin konto, og lukker den for anonyme brugere.server.yml: gør filen læsbar alene for dens ejer, med chmod 600.Med SQLite holder ntfy hver type data i sin egen fil. I denne guides installation ligger alt i mapperne etc og lib, ved siden af compose.yaml:
| Element | Hvad det rummer | Tag backup |
|---|---|---|
etc/server.yml | Konfigurationen, herunder SMTP-hemmeligheder og Web Push-nøgler | Ja |
lib/user.db | Brugere, regler for adgangskontrol, tokens og daglige tællere | Ja |
lib/cache.db | Beskeder fra de seneste 12 timer, som standard | Nyttigt, levetiden er kort |
lib/attachments/ | Vedhæftede filer fra de seneste 3 timer, som standard | Nyttigt, levetiden er kort |
Filen web-push-file | Browsernes Web Push-abonnementer, hvis du har aktiveret det | Ja |
For at få en konsistent kopi af SQLite-filerne stopper du tjenesten, mens arkivet laves:
docker compose stop
tar -czf ntfy-$(date +%F).tar.gz compose.yaml etc lib
docker compose start
Planlæg denne kopi på et roligt tidspunkt, og send den væk fra serveren. Lagt på dens disk indgår disse arkiver også i dens natlige backup. For at gendanne lægger du mapperne tilbage på plads og kører derefter docker compose up -d.
Mister du user.db uden kopi, genskabes de brugere og tokens, der er erklæret i server.yml via auth-users og auth-tokens, ved start; dem, der er oprettet på kommandolinjen, opretter du igen.
Med Docker ændrer du imagets tag i compose.yaml, for eksempel fra v2.38.1 til den næste version, og derefter:
docker compose pull
docker compose up -d
Mapperne etc og lib bliver, hvor de er, og ntfy migrerer selv sine databaser ved start. Med Debian-pakken gør sudo apt update og derefter sudo apt upgrade det samme.
Noterne til hver version, på dokumentationens side «Releases», samler under «Upgrade notes» det, der ændrer sig for en eksisterende instans, som i 2.36.0 en konfiguration, der nu kontrolleres fuldt ud ved start, eller daglige tællere, der nulstilles. Læs dem før opdateringen, og kopiér begge mapper lige før. Version 2.38.1 er en sikkerhedsudgivelse, som projektet kraftigt anbefaler: den styrker beskedskabelonerne mod denial of service-angreb og forhindrer, at langsomme upload af vedhæftede filer til S3 og web push-endepunkter, der ikke svarer, binder hukommelse og forbindelser. Den følger efter 2.38.0, som deler hastighedsgrænserne mellem et clusters noder og er bygget med Go 1.27.4.
Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; ntfy forbliver din software, med dens indstillinger og data.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Gennemlæsning af din instans' logfiler |
| ntfy | Proaktiv opfølgning: fejl, langsomme svartider, åbne forbindelser og diskplads opdages, og en rettelse anbefales | Installation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Adgangen | Den server, der bærer den, overvåget og sikkerhedskopieret | Brugerne, rettighederne til topics og dine scripts' tokens |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | De kopier, der er specifikke for ntfy, og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet for omlægningen |
Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.
Med en Managed VPS fra Simafri holder vores teams serveren bag din ntfy-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.
Ja. ntfy har dobbelt licens, Apache 2.0 og GPLv2: du kan køre den i din virksomhed uden at skulle købe en licens. Deres betingelser gælder for videredistribution af softwaren. Tilbage er udgiften til den server, der kører den.
Opret en compose.yaml med imaget binwiederhier/ntfy, kommandoen serve, en mappe monteret på /etc/ntfy til server.yml, en anden på /var/lib/ntfy til databaserne og containerens port 80 publiceret på 127.0.0.1:2586. Kør docker compose up -d, og sæt derefter en reverse proxy med HTTPS foran den port.
I server.yml sætter du auth-file og auth-default-access: deny-all. Opret derefter en administrator med ntfy user add --role=admin, begrænsede brugere med ntfy user add og deres rettigheder til topics med ntfy access.
Opret et token med ntfy token add til en bruger, der er dedikeret til scriptet og begrænset til dets topics, og publicér derefter med curl og headeren Authorization: Bearer efterfulgt af tokenet, over HTTPS. Et token giver adgang til hele brugerens konto.
Bag en reverse proxy kommer hver anmodning fra proxyens adresse. Med behind-proxy: true læser ntfy headeren X-Forwarded-For for at identificere hver besøgende; uden den deler de alle de samme hastighedsgrænser.
Ja, med upstream-base-url: "https://ntfy.sh" i server.yml. Din server lader så et signal gå via ntfy.sh, som kun indeholder beskedens ID, og appen henter beskeden fra din server. Uden denne indstilling kan leveringen tage flere timer.
Tag backup af server.yml og user.db, som rummer konfigurationen, brugerne, rettighederne og tokens, plus Web Push-filen, hvis den er aktiveret. Beskedcachen og de vedhæftede filer har en kort levetid. Stop tjenesten, mens du kopierer, for at få konsistente SQLite-filer.
En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.