Tự host ntfy trên VPS để gửi cảnh báo server
Tự host ntfy trên VPS với Docker Compose và TLS. Khóa topic bằng user, ACL, rồi gửi cảnh báo từ cron hoặc systemd OnFailure khi service lỗi.
Máy chủ ntfy tự host làm gì
Máy chủ ntfy tự host chuyển một HTTP POST thành push notification trên điện thoại của bạn. Bạn publish bằng curl, rồi message sẽ đến ứng dụng Android, ứng dụng iOS, tab trình duyệt hoặc bất kỳ client nào khác có thể duy trì kết nối HTTP mở. Bạn không cần cài client library và cũng không cần chạy message broker.
ntfy định địa chỉ message bằng topic. Topic là một tên trong URL path, như https://ntfy.example.com/alerts, và tồn tại ngay khi có người publish vào đó. Với cấu hình cài đặt mặc định, bất kỳ ai biết tên topic đều có thể đọc và ghi vào topic đó. Vì vậy, tài liệu chính thức của dự án so sánh tên topic với password. Mô hình này phù hợp với dịch vụ ntfy.sh công khai. Nó không phù hợp với server nhận các cảnh báo backup failed của bạn. Vì thế, hướng dẫn này bật authentication trước khi message đầu tiên được gửi.
Những gì cần chuẩn bị trước khi bắt đầu
Bạn cần một VPS chạy Ubuntu 24.04 hoặc Debian 13, có Docker Engine và plugin Compose, một tên miền và rất ít RAM. Tạo bản ghi DNS A (domain name system) trỏ ntfy.example.com đến địa chỉ IP public của server, rồi xác nhận tên miền phân giải đúng trước khi làm bất kỳ việc gì khác.
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusdig phải in ra IP của server. Việc cấp chứng chỉ yêu cầu hostname phân giải công khai đến server thông qua bản ghi A hoặc AAAA. Cổng 80 phải được mở vì ACME (automatic certificate management environment), giao thức đứng sau Let's Encrypt, sử dụng cổng này cho HTTP challenge. Container ntfy không mở bất kỳ cổng public nào.
Tạo file cấu hình ntfy
Docker image không chứa file cấu hình, nên bạn phải tự tạo file này. Mọi command ở phần sau của guide đều đọc cấu hình từ file đó. Trước tiên, hãy tìm user ID và group ID mà container sẽ chạy dưới đó.
id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.ymlbase-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: falseCó 4 dòng trong số đó đóng vai trò chính. base-url phải là địa chỉ HTTPS public chính xác, vì ntfy dùng địa chỉ này để tạo link attachment và gửi push notification self-hosted trên iOS. listen-http: ":2586" bind vào tất cả interface bên trong container. Cách này có vẻ bất cẩn nhưng lại đúng: container có network namespace riêng, nên nếu bind vào 127.0.0.1 ở đó thì port sẽ không thể truy cập từ host và published port của Docker sẽ không bao giờ kết nối được. auth-default-access: "deny-all" quyết định toàn bộ security posture, vì nó từ chối quyền đọc và ghi đối với mọi người nếu không có grant rõ ràng. behind-proxy: true bảo ntfy lấy địa chỉ client từ header X-Forwarded-For, để rate limit đếm đúng visitor thực thay vì xem reverse proxy là một client duy nhất nhưng có lưu lượng quá lớn.
enable-login: true cho phép người dùng đăng nhập qua web app hoặc API. enable-signup vẫn để false, vì cho phép tự tạo account trên một server private chẳng khác nào mở thêm một cửa vào hệ thống.
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.ymlChạy ntfy bằng Docker Compose
Đặt nội dung này vào /opt/ntfy/compose.yaml, thay 1000:1000 bằng hai số id -u và id -g được in ở trên.
services:
ntfy:
image: binwiederhier/ntfy:v2.36.0
container_name: ntfy
command: serve
user: "1000:1000"
environment:
- TZ=UTC
volumes:
- /etc/ntfy:/etc/ntfy
- /var/cache/ntfy:/var/cache/ntfy
- /var/lib/ntfy:/var/lib/ntfy
ports:
- "127.0.0.1:2586:2586"
restart: unless-stoppedcd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/healthMột server hoạt động bình thường sẽ trả lời {"healthy":true,"role":"active"}. Hai chi tiết trong file compose đó là có chủ ý. Image được pin vào v2.36.0, bản stable hiện tại tính đến ngày 1 tháng 11 năm 2026, thay vì latest. Với latest, lần docker compose pull tiếp theo sẽ tải image hiện tại, rồi một lần docker compose up -d sau đó sẽ tạo lại container bằng image này. Chỉ pull image không thay đổi version của server đang chạy.
Pin vẫn cần được cập nhật. Riêng tháng 10 năm 2026 đã có 10 release: v2.29.0 ngày 7 tháng 10, v2.30.0 ngày 12 tháng 10, v2.31.0 và v2.31.1 ngày 16 tháng 10, v2.32.0 ngày 18 tháng 10, v2.33.0 và v2.33.1 ngày 23 tháng 10, v2.34.0 ngày 24 tháng 10, v2.35.0 ngày 30 tháng 10 và v2.36.0 ngày 31 tháng 10. v2.31.0 sửa lỗi message bị mất khi client reconnect trước khi message được đưa vào message cache. Tuy nhiên, khi reconnect với since=<message ID>, phiên bản này đọc mọi message trong topic từ database, nên ntfy.sh đã rollback khỏi phiên bản đó. v2.31.1 sửa vấn đề tải này bằng một index mới. v2.34.0 sửa lỗi user đã revoke hoặc xóa vẫn giữ một số subscription. v2.35.0 sửa lỗi các request đồng thời coi credential hợp lệ là anonymous và lỗi bypass authorization trong Matrix push gateway trên SQLite. Vì vậy, hãy chuyển các pin cũ sang v2.36.0.
Port được publish dưới dạng 127.0.0.1:2586:2586, nên container chỉ có thể truy cập từ địa chỉ loopback của host. Nếu viết 2586:2586, Docker sẽ chèn rule firewall của chính nó trước rule của bạn. Vì vậy, port vẫn trả lời từ Internet dù ufw status cho biết port đã đóng. Cả hai thói quen này cũng áp dụng cho container tiếp theo bạn thêm: relay RustDesk tự host pin image tag theo cách tương tự, nhưng không thể ẩn sau loopback vì các port signal và relay phải trả lời từ Internet.
Nếu curl in ra Connection refused, hãy đọc log của container. Lỗi permission trên /var/lib/ntfy/user.db có nghĩa là dòng user: không khớp với owner của các thư mục đó. Vì vậy, process không thể tạo database của chính nó và thoát. Guide về các khái niệm cơ bản của Docker Compose cho VPS trình bày chi tiết hơn về quyền sở hữu volume và restart policy.
Đặt TLS phía trước bằng Caddy
Caddy tự yêu cầu và gia hạn certificate. Đây là cách ngắn nhất để có TLS hoạt động (bảo mật tầng truyền tải).
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddyThay toàn bộ nội dung của /etc/caddy/Caddyfile bằng 3 dòng.
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/healthCùng {"healthy":true,"role":"active"} qua HTTPS cho biết toàn bộ đường đi đã hoạt động. 502 từ Caddy thường có nghĩa là ntfy không listening: kiểm tra bằng sudo ss -lntp | grep 2586. Nếu ntfy đang listening mà 502 vẫn tiếp diễn, Caddy sẽ ghi log lỗi upstream mà nó gặp, chẳng hạn như connection bị reset. Lỗi certificate thường có nghĩa là DNS record không đúng hoặc quá trình xác thực certificate không thể truy cập server trên port 80 hoặc 443; kiểm tra sudo journalctl -u caddy -n 50 để xem lỗi xác thực. Sau này, khi thêm service khác, bạn chỉ cần thêm một hostname block vào cùng Caddyfile. Đây là cách một ứng dụng như Halcyon, giao diện cửa hàng video thập niên 90 cho thư viện Jellyfin của bạn có thể chạy trên subdomain thứ hai của cùng server.
Nếu bạn đã chạy nginx, hãy sao chép các proxy setting được ntfy ghi lại: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for, cùng read timeout và send timeout ít nhất 3 phút. Subscriber giữ một HTTP connection mở trong suốt thời gian nó listening. proxy_read_timeout mặc định của nginx là 60 giây và chỉ tính khoảng thời gian giữa hai lần đọc. ntfy mặc định gửi keepalive message mỗi 45 giây (keepalive-interval) chính xác để intermediary không đóng connection vì không có hoạt động. Vì vậy, subscriber không có dữ liệu vẫn duy trì connection ngay cả khi chạy sau nginx mặc định; timeout dài hơn chỉ là khoảng đệm, không phải yếu tố giữ connection hoạt động. Nếu tăng keepalive-interval, hãy giữ giá trị này thấp hơn read timeout của proxy.
Tạo user và khóa chặt các topic
Authentication đã được bật và hiện chưa ai có quyền truy cập gì. Đây chính là mục đích của bước này. Tạo một tài khoản admin cho bạn và một tài khoản máy cho các script. Các lệnh này đọc /etc/ntfy/server.yml bên trong container, nên file cấu hình được mount dưới dạng volume.
sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user listMỗi lệnh user add đều yêu cầu nhập password. Admin bỏ qua access list và có thể đọc, ghi mọi topic, vì vậy chỉ dùng tài khoản này cho bạn và ứng dụng trên điện thoại. robot là user thông thường, mặc định không có quyền truy cập cho đến khi bạn cấp quyền.
sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy accessMột mục ACL (access control list) gồm một user, một topic và một permission. Topic có thể là tên cụ thể hoặc pattern, trong đó * khớp với mọi giá trị. Vì vậy, alerts_* có thể bao phủ alerts_backup và alerts_db mà không cần chạy một lệnh riêng cho từng host. Permission write chỉ cho phép publish, nên nếu token bị lấy cắp từ một cron job, kẻ tấn công không thể subscribe và đọc lại dữ liệu mà token đã gửi. Username đặc biệt everyone quy định những gì visitor chưa authentication được phép làm. Với deny-all làm giá trị mặc định, bạn thường chỉ dùng nó để công khai có chủ đích một thứ gì đó, chẳng hạn ntfy access everyone status read. Giá trị này cũng chấp nhận deny khi bạn muốn có một rule rõ ràng để chặn visitor anonymous truy cập một topic.
Các script nên dùng token, không dùng password của bạn.
sudo docker compose exec ntfy ntfy token add robotLệnh này in ra một token bắt đầu bằng tk_. Token kế thừa chính xác các quyền của user mà nó thuộc về, nên token này chỉ có thể publish vào các topic alerts và không làm được gì khác. ntfy token list hiển thị các token hiện có, còn ntfy token remove thu hồi một token mà không thay đổi password của user.
Gửi message đầu tiên và xác nhận cơ chế khóa hoạt động
Trước tiên, kiểm tra xem cửa đã được đóng chưa.
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alertsLệnh này in ra 403, và 403 là kết quả đúng: auth-default-access: "deny-all" từ chối publish ẩn danh. Bây giờ, hãy gửi một message thật.
curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
-H "Title: Nightly backup finished" \
-H "Priority: default" \
-H "Tags: white_check_mark" \
-d "42 GB copied in 11 minutes" \
https://ntfy.example.com/alertsServer trả về message đã lưu dưới dạng JSON. Đây là cách xác nhận message đã được chấp nhận thay vì bị bỏ qua. Title là dòng đầu tiên được in đậm. Priority nhận giá trị từ 1 đến 5, hoặc theo tên từ min đến urgent, và quyết định điện thoại có phát âm thanh hay không. Tags được chuyển thành emoji trong notification khi tên khớp với một emoji short code đã biết, và giữ nguyên dạng plain text khi không khớp.
Để theo dõi một topic từ terminal, hãy stream topic đó:
curl -s -u admin https://ntfy.example.com/alerts/rawcurl sẽ hỏi password. Mỗi message xuất hiện trên một dòng. Các dòng trống thỉnh thoảng xuất hiện là keepalive. Mở https://ntfy.example.com trong browser và đăng nhập bằng cùng account sẽ cho bạn phiên bản web app của cùng stream đó.
Đặt rate limit để một script không thể làm ngập server
Theo mặc định, mỗi visitor được cấp một bucket gồm 60 request, refill với tốc độ 1 request mỗi 5 giây. Mức này khá rộng rãi đối với server riêng, và một script bị kẹt trong vòng lặp retry sẽ dùng hết bucket. Thêm limit vào server.yml.
visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500sudo docker compose restart ntfyVisitor vượt quá limit sẽ nhận HTTP 429 thay vì message được gửi đi. Limit được tính theo địa chỉ của visitor. Vì vậy behind-proxy: true rất quan trọng: nếu không có nó, ntfy chỉ thấy địa chỉ của Caddy, mọi client sẽ bị tính là cùng một visitor, và một script gây nhiều lưu lượng sẽ làm cạn bucket mà điện thoại và các server khác của bạn cùng sử dụng. Từ v2.36.0, số lượng trong ngày được giữ lại trong user database sau khi restart. Allowance của mỗi visitor cũng được reset theo chu kỳ 24 giờ riêng, thay vì reset vào 00:00 UTC.
Cảnh báo từ cron job bị lỗi
Không đặt token trên command line. ps aux hiển thị toàn bộ command line của mọi process đang chạy cho mọi user trên máy, vì vậy token truyền bằng -H có thể bị bất kỳ local account nào đọc trong suốt thời gian curl chạy. Dùng curl config file sẽ tránh được việc này.
sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrcBây giờ hãy bọc job này. Lưu nội dung dưới đây thành /usr/local/bin/backup-with-alert.sh rồi chạy chmod 750 để cấp quyền thực thi.
#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: backup.sh failed with exit $code" \
-H "Priority: high" \
-H "Tags: warning" \
--data-binary @- \
https://ntfy.example.com/alerts
fi
exit "$code"17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1$? được lấy ngay trên dòng sau command, vì command tiếp theo sẽ ghi đè giá trị này. Output được truyền qua tail -c 1000 vì ntfy giới hạn kích thước message tối đa và notification không phải là log viewer. exit "$code" ở cuối giữ nguyên status ban đầu, để mọi thành phần khác đang theo dõi job này vẫn nhận biết job đã fail. Kiểm tra toàn bộ quy trình bằng cách trỏ script đến /bin/false trong một lần chạy.
Một failure branch không bao giờ được thực thi còn tệ hơn việc không có alerting, vì nó khiến bạn hiểu nhầm rằng không có thông báo nghĩa là thành công. Cron cung cấp cho job một environment gần như rỗng và PATH ngắn hơn nhiều so với login shell. Vì vậy, script chạy được khi bạn chạy thủ công có thể die trước khi đến dòng curl. Hướng dẫn giải thích vì sao cron job không chạy trình bày các lỗi environment này. Luôn dùng absolute path, rồi đọc log file sau lần chạy theo lịch đầu tiên thay vì tự giả định.
Cảnh báo khi một systemd unit bị lỗi
Cron phù hợp với các tác vụ theo lịch. Các service chạy lâu dài cần OnFailure=; systemd sẽ chạy thành phần này khi một unit chuyển sang trạng thái failed. Tạo một template unit và dùng lại cho mọi service trên máy. Lưu nội dung sau vào /etc/systemd/system/ntfy-unit-failed@.service.
[Unit]
Description=Send an ntfy alert because %i failed
[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %iSau đó chạy /usr/local/bin/ntfy-unit-failed và đặt mode 750:
#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
-H "Title: $unit failed on $(hostname -s)" \
-H "Priority: urgent" \
-H "Tags: rotating_light" \
--data-binary @- \
https://ntfy.example.com/alertsGắn nó vào một service bằng drop-in để package upgrade không ghi đè chỉnh sửa của bạn.
sudo systemctl edit myapp.service[Unit]
OnFailure=ntfy-unit-failed@%n.service%n được thay bằng tên unit đầy đủ, nên instantiated unit sẽ trở thành ntfy-unit-failed@myapp.service.service. Còn %i trong template truyền myapp.service cho script dưới dạng đối số đầu tiên. Nhờ đó, một template có thể dùng cho mọi unit. Kiểm tra bằng một unit cố tình bị lỗi, lưu vào /etc/systemd/system/ntfy-selftest.service.
[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service
[Service]
Type=oneshot
ExecStart=/bin/falsesudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.serviceLệnh start thoát với mã khác 0 và in ra Job for ntfy-selftest.service failed because the control process exited with error code; điện thoại sẽ báo khoảng một giây sau. Xóa test unit sau khi kiểm tra xong.
Có một điểm dễ nhầm cần lưu ý. OnFailure= chỉ chạy khi unit chuyển sang trạng thái failed. RestartMode=direct bỏ qua trạng thái đó trong quá trình tự động restart, nên cũng bỏ qua failure handler. Với RestartMode=normal mặc định, automatic restart sẽ đi qua trạng thái failed. StartLimitBurst và StartLimitIntervalSec kiểm soát thời điểm từ chối các lần start lặp lại; hãy đặt chúng để crash loop cuối cùng dừng lại. Timers là cách thay thế gọn hơn cho pattern dùng cron ở trên, vì service unit của timer cũng hỗ trợ cùng OnFailure= drop-in. Hướng dẫn về systemd service và timer trên VPS trình bày cách chuyển đổi một trường hợp.
Kết nối trình giám sát uptime vào cùng topic
Uptime Kuma, trình giám sát trạng thái tự host, có sẵn loại thông báo ntfy. Mở Settings, chọn Notifications, rồi chọn Setup Notification. Chọn Ntfy, đặt server URL thành https://ntfy.example.com và topic thành alerts, chọn priority, rồi dán access token robot. Gửi thông báo kiểm tra trước khi lưu, vì tên topic sai sẽ trả về lỗi khi cấp quyền write không bao phủ topic đó.
Giới hạn thực tế của cách này là: một monitor chạy trên cùng VPS không thể cho bạn biết VPS đã down, và ntfy không thể gửi thông báo rằng chính ntfy đã down. Hãy chạy monitor trên một máy khác và cấp cho nó thêm một notification channel, chẳng hạn email, để monitor này theo dõi chính ntfy. Loại monitor Push của Uptime Kuma xử lý điểm mù còn lại: cron job của bạn gọi một push URL sau khi chạy thành công, còn Kuma sẽ cảnh báo khi không còn nhận được các lần gọi đó. Nhánh xử lý lỗi chỉ chạy khi job được khởi chạy, nên không thể cho biết một job chưa bao giờ bắt đầu.
ntfy tự host có hoạt động trên Android và iPhone không?
Trên Android thì có, không kèm điều kiện nào. Cài app từ Google Play hoặc F-Droid, mở Settings, đặt server mặc định thành https://ntfy.example.com, thêm tài khoản trong màn hình quản lý người dùng, rồi subscribe alerts. Instant delivery duy trì một foreground service để message vẫn đến ngay cả khi điện thoại đang ở chế độ doze. Notification cố định đi kèm là yêu cầu của Android đối với foreground service, không phải bug. Bản build F-Droid hoàn toàn không chứa code Firebase, nên mọi subscription đều dùng instant delivery. ntfy cũng có thể hoạt động như một UnifiedPush distributor, tức một giải pháp mở thay thế cho push service của Google, nên các app khác hỗ trợ UnifiedPush cũng có thể gửi notification qua server của bạn.
Trong official iOS app, tính năng này hoạt động nhưng có một dependency không thể loại bỏ. iOS sẽ suspend app khi app chạy nền. Các background mode mà Apple cho phép, như phát audio, nhận cập nhật vị trí và xử lý task theo lịch, không cho phép app ngồi chờ message từ server của bạn. Vì vậy, việc đánh thức app kịp thời phải đi qua APNs (Apple push notification service). Chỉ provider có credential được cấp quyền cho app mới có thể gửi notification đến app đó. Vì vậy, server của bạn không thể liên lạc trực tiếp với official app. ntfy giải quyết việc này bằng một relay: server của bạn gửi một poll_request chứa message ID đến ntfy.sh. ntfy.sh chuyển message đó qua Firebase và APNs để đánh thức app. Sau đó app fetch message body từ server của bạn.
upstream-base-url: "https://ntfy.sh"Cần hiểu rõ cái giá phải trả. Nội dung message vẫn nằm trên máy chủ của bạn, nhưng việc một message đã đến và ID của message đó sẽ đi qua hạ tầng mà bạn không quản lý. Nếu không bật thiết lập này, notification trên iPhone từ server tự host vẫn sẽ đến, nhưng tài liệu ntfy cảnh báo thời gian trễ có thể lên đến vài giờ, vì không có cơ chế đánh thức app kịp thời. Để dùng native iOS app mà không qua relay ntfy.sh, bạn phải tự build và phát hành app bằng Apple developer account của mình cùng các APNs key của riêng bạn. Việc này cần trả phí hằng năm và phải build lại sau mỗi lần cập nhật. Một lựa chọn khác là dùng PWA của ntfy trên iOS 16.4 trở lên: thêm PWA vào home screen và cấu hình Web Push trên server. Cách này tránh relay ntfy.sh nhưng vẫn dùng hạ tầng push của browser. Nếu relay không phù hợp với nhu cầu của bạn, hãy dùng Android hoặc desktop web app để nhận cảnh báo.
Backup, nâng cấp và pin image
Có hai path không thể tạo lại: /etc/ntfy/server.yml và /var/lib/ntfy/user.db. Path thứ hai chứa mọi user, password hash, ACL entry và token, nên hãy xử lý nó như một private key.
sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgzCopy file đó ra ngoài server. cache.db chứa các message gần đây, gồm message trong 12 giờ với cache-duration ở trên, cùng mọi message được lên lịch gửi sau. Những message này được giữ lại đến 12 giờ sau khi được gửi. Nếu bạn không lên lịch message trước, việc mất file này không gây mất dữ liệu đáng kể cần bảo vệ. Nâng cấp nghĩa là sửa tag trong file compose, pull image và tạo lại container.
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/healthĐọc release note trước. Các database SQLite được migrate khi start, nên rollback về tag cũ sau khi schema thay đổi là không an toàn. Ví dụ, v2.31.1 chuyển message cache sang schema version 17. Note nâng cấp của phiên bản này cho biết nếu downgrade về v2.31.0 hoặc cũ hơn, phải tự đổi version đó về 16. Nâng cấp lên v2.36.0 sẽ reset một lần toàn bộ daily count hiện có của mọi người. Giữ lại backup vừa tạo cho đến khi version mới đã chạy được 1 ngày.
Note cũng đánh dấu các thay đổi về hành vi. Từ v2.31.0 trở đi, client reconnect với since=<message ID> cũng nhận các message được publish trong cùng giây đó, nên có thể thấy message trùng lặp. ntfy app và web app loại bỏ message trùng bằng message ID, nhưng script tự viết để replay một topic cũng phải làm như vậy. Mỗi service trên máy đều có một danh sách ngắn các path không thể tạo lại. Bài so sánh PhotoPrism và Immich lập danh sách đó cùng các lệnh backup tương ứng cho một thư viện ảnh trên loại VPS tương tự.
Gotify và Apprise
Gotify là lựa chọn gọn hơn: một binary kèm web UI và Android app, với message được tổ chức theo từng application. Nó phù hợp với một máy riêng chỉ cần gửi thông báo đến Android. Apprise là Python library và command line tool, đồng thời có Apprise API server riêng. Nó có thể gửi một message đến hơn một trăm service cùng lúc, bao gồm ntfy, nên phù hợp với script cần gửi thông báo đến nhiều nơi. ntfy cung cấp server, HTTP API và app trên cả hai nền tảng mobile. Vì vậy, đây thường là lựa chọn cho việc gửi alert từ server thuê.
FAQ
Tại sao publish lên server ntfy của tôi lại trả về 403?
Khi auth-default-access: "deny-all" trong server.yml, yêu cầu publish ẩn danh sẽ bị từ chối. Đây là hành vi được thiết kế. Gửi credential bằng -u user:pass hoặc -H "Authorization: Bearer tk_...". Nếu bạn đã gửi token nhưng vẫn nhận 403, hãy kiểm tra user đó có ACL entry cho phép ghi vào topic hay không: không có entry phù hợp, read-only hoặc deny sẽ từ chối yêu cầu publish. Trên v2.34.0, các request đồng thời từ cùng một IP cũng có thể khiến credential hợp lệ bị xử lý như request ẩn danh. v2.35.0 đã sửa lỗi này, nên hãy upgrade trước khi coi 403 xảy ra không ổn định là bằng chứng của lỗi ACL. Chạy ntfy access để in toàn bộ danh sách. Lưu ý rằng quyền write không cho phép subscribe, nên một account publish bình thường vẫn bị từ chối khi cố đọc cùng topic.
Notification có hoạt động trên iPhone với server ntfy tự host không?
Có. Khi dùng app iOS chính thức, notification hoạt động thông qua relay. Việc đánh thức đúng lúc một app iPhone đang bị suspend phải đi qua APNs (dịch vụ push notification của Apple). Để gửi đến app chính thức, ntfy cần push credential của nhà phát hành app, nên ntfy chuyển tiếp một poll_request chứa message ID đến ntfy.sh, rồi ntfy.sh chuyển tiếp message đó đến thiết bị. Đặt upstream-base-url: "https://ntfy.sh" trong server.yml rồi restart container. Nội dung message vẫn được lấy từ server của bạn. Nếu không đặt tùy chọn này, notification trên iOS vẫn có thể đến sau đó, nhưng tài liệu ntfy cảnh báo độ trễ có thể lên đến vài giờ. PWA là một lựa chọn khác trên iOS 16.4 trở lên khi Web Push được cấu hình trên server của bạn.
Tại sao alert ntfy từ cron job của tôi không bao giờ đến?
Trước tiên, hãy tự chạy dòng curl để xác nhận token và topic chính xác. Nếu chạy thủ công thành công nhưng chạy từ cron thất bại, lỗi nằm trước bước gửi alert: cron chạy job với environment tối thiểu và PATH ngắn, nên script gọi command bằng tên trần có thể dừng trước khi chạy đến dòng curl. Dùng đường dẫn tuyệt đối, redirect output của job vào một file log, rồi đọc file đó sau lần chạy tiếp theo. Nếu nhận response 429 thay vì delivery, nghĩa là request bị từ chối do giới hạn. Thông thường script retry quá nhanh. Tuy nhiên, một visitor đã dùng hết quota hằng ngày, chẳng hạn message limit được đặt ở trên, cũng sẽ bị từ chối tương tự ngay cả với một request duy nhất.
Có nên expose ntfy trên Internet công cộng không?
Các app điện thoại cần truy cập server từ mạng di động, nên endpoint HTTPS public với auth-default-access: "deny-all" và ACL cho từng topic là cấu hình thông thường. Cấu hình này an toàn miễn là không có topic nào cho phép everyone đọc. Instance chỉ dùng qua VPN là lựa chọn hợp lý khi mọi subscriber đều là máy do bạn kiểm soát. Cách này không phù hợp với điện thoại, vì app chỉ nhận notification khi tunnel đang hoạt động; do đó alert sẽ được queue cho đến khi điện thoại kết nối lại.