自架 ntfy 伺服器:Docker 部署與推播通知設定教學
透過 Docker Compose 在 VPS 自架 ntfy 伺服器,並啟用 TLS 加密與 ACL 存取控制。本指南教您如何整合 cron 與 systemd OnFailure,將伺服器監控警報推送到手機,確保敏感通知的安全性與隱私。
自架 ntfy 伺服器的功能
自架 ntfy 伺服器能將 HTTP POST 請求轉換為手機上的推播通知。您可以使用 curl 進行發布,訊息隨即會送達 Android 應用程式、iOS 應用程式、瀏覽器分頁,或任何能維持 HTTP 連線的裝置。此過程無需安裝客戶端函式庫,也不需執行訊息代理程式(message broker)。
ntfy 透過「主題」(topic)來定址訊息。主題是 URL 路徑中的名稱,例如 https://ntfy.example.com/alerts,只要有人向該路徑發布訊息,主題便會立即建立。在預設安裝下,任何知道該名稱的人皆可讀取或寫入該主題,因此專案官方文件將主題名稱比喻為密碼。這種模式適用於公開的 ntfy.sh 服務,但對於處理備份失敗通知等敏感資訊的伺服器而言並不安全,因此本指南將在發送第一則訊息前,先行啟用身份驗證機制。
開始前的準備
您需要一台執行 Ubuntu 24.04 或 Debian 13 的 VPS,並安裝 Docker Engine 與 Compose plugin。此外還需要一個網域名稱,以及非常少量的 RAM。建立 DNS(domain name system)A 記錄,將 ntfy.example.com 指向伺服器的公開 IP 位址。接著確認該記錄已正確解析,再進行其他操作。
dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw statusdig 必須輸出伺服器的 IP。申請憑證時,主機名稱必須透過 A 或 AAAA 記錄公開解析至該伺服器。Port 80 必須保持開放,因為 Let's Encrypt 使用的 ACME(automatic certificate management environment)協定會透過此埠進行 HTTP challenge。ntfy 容器本身不會公開任何埠。
建立 ntfy 設定檔
Docker 映像檔不包含設定檔,因此需要自行建立。後續本指南中的每個指令都會讀取此檔案。首先,找出容器執行時使用的使用者 ID 和群組 ID。
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: false其中有 4 行是關鍵設定。base-url 必須是完全相同的公開 HTTPS 位址,因為 ntfy 會使用它產生附件連結,以及支援自架的 iOS 推播通知。listen-http: ":2586" 會繫結容器內的所有介面。這看似寬鬆,但設定正確:容器具有自己的網路命名空間,因此若在其中繫結到 127.0.0.1,主機將無法連線到該埠,Docker 發布的埠也永遠無法建立連線。auth-default-access: "deny-all" 定義了完整的安全策略,因為它會拒絕任何未明確獲得授權者的讀取與寫入要求。behind-proxy: true 會指示 ntfy 從 X-Forwarded-For 標頭取得用戶端位址,讓速率限制能以實際訪客計算,而不是把反向代理計為一個非常忙碌的用戶端。
enable-login: true 允許使用者透過 Web 應用程式或 API 登入。enable-signup 維持為 false,因為在私有伺服器上開放使用者自行建立帳戶,就像額外增加步驟的公開入口。
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.yml使用 Docker Compose 執行 ntfy
將以下內容放入 /opt/ntfy/compose.yaml,並以稍早顯示的兩個數字 id -u 和 id -g 取代 1000:1000。
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/health正常運作的伺服器會回應 {"healthy":true,"role":"active"}。該 compose 檔案中有兩項設定是刻意安排的。映像檔固定使用 v2.36.0,這是截至 November 1, 2026 的目前穩定版本,而不是 latest。因為搭配 latest 時,下一次 docker compose pull 會下載目前的映像檔,接著 docker compose up -d 會以該映像檔重新建立容器;單獨執行 pull 不會變更執行中的伺服器版本。固定版本仍需定期更新。僅 October 2026 就有 10 個版本發布:v2.29.0 於 October 7 發布、v2.30.0 於 October 12 發布、v2.31.0 和 v2.31.1 於 October 16 發布、v2.32.0 於 October 18 發布、v2.33.0 和 v2.33.1 於 October 23 發布、v2.34.0 於 October 24 發布、v2.35.0 於 October 30 發布,以及 v2.36.0 於 October 31 發布。v2.31.0 修正了用戶端在訊息進入訊息快取前重新連線時訊息遺失的問題,但其搭配 since=<message ID> 的重新連線會從資料庫讀取主題中的每則訊息,ntfy.sh 因此撤回了該版本。v2.31.1 以新的索引修正這項負載問題,v2.34.0 則修正已撤銷或刪除的使用者仍保留部分訂閱的問題。v2.35.0 修正並行請求將有效憑證視為匿名使用者的問題,以及 SQLite 上的 Matrix push gateway 授權繞過問題,因此請將較舊的固定版本更新為 v2.36.0。連接埠發布為 127.0.0.1:2586:2586,因此容器只能從主機的 loopback 位址連線。若改寫為 2586:2586,Docker 會在你的規則之前加入自己的防火牆規則。這表示即使 ufw status 顯示連接埠已關閉,該連接埠仍會從網際網路回應。這兩項做法也適用於你接下來新增的容器:自架 RustDesk relay 同樣會固定映像檔標籤,但無法隱藏在 loopback 後方,因為其 signal 和 relay 連接埠必須從網際網路回應。
如果 curl 顯示 Connection refused,請查看容器日誌。/var/lib/ntfy/user.db 的權限錯誤表示 user: 行與這些目錄的擁有者不符,因此程序無法建立自己的資料庫並結束。VPS 的 Docker Compose 基礎指南會更詳細說明 volume 擁有權與 restart policy。
使用 Caddy 放置 TLS
Caddy 會自行申請並續期憑證,這是最快讓 TLS(傳輸層安全性)正常運作的方法。
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 caddy將 /etc/caddy/Caddyfile 的內容替換為 3 行。
ntfy.example.com {
reverse_proxy 127.0.0.1:2586
}sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health相同的 {"healthy":true,"role":"active"} 透過 HTTPS 存取時,表示整條路徑都能正常運作。Caddy 回傳 502 通常表示 ntfy 沒有監聽連接埠:使用 sudo ss -lntp | grep 2586 檢查。若 ntfy 正在監聽,而 502 仍持續出現,Caddy 會記錄它遇到的上游錯誤,例如連線遭重設。憑證錯誤通常表示 DNS 記錄錯誤,或憑證驗證無法透過 80 或 443 埠連至伺服器;檢查 sudo journalctl -u caddy -n 50 以查看驗證錯誤。日後新增其他服務時,只需在相同的 Caddyfile 中再加入一個主機名稱區塊;例如 Halcyon,適用於 Jellyfin 媒體庫的 90 年代影片商店前端,即可放在同一台主機的第二個子網域上。
如果你已經使用 nginx,請複製 ntfy 文件所記載的代理設定:proxy_http_version 1.1、proxy_buffering off、proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for,並將讀取與傳送逾時設為至少 3 分鐘。訂閱者在監聽期間會持續保持一條 HTTP 連線。nginx 預設的 proxy_read_timeout 為 60 秒,但它只計算兩次讀取之間的時間;ntfy 預設每 45 秒傳送一次 keepalive 訊息(keepalive-interval),正是為了避免中介設備因閒置而關閉連線。因此,即使使用標準 nginx,沒有訊息的訂閱者仍會維持連線;較長的逾時設定是預留空間,不是維持連線的必要條件。如果調高 keepalive-interval,請保持其值低於代理的讀取逾時。
建立使用者並限制主題存取
驗證已啟用,目前尚未有人能存取任何內容,這正是預期結果。為自己建立一個管理員帳戶,並為指令碼建立一個機器帳戶。這些指令會從容器內讀取 /etc/ntfy/server.yml,因此設定檔必須以 volume mount 掛載。
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 list每個 user add 指令都會要求輸入密碼。管理員不受存取清單限制,可以讀取及寫入所有主題,因此請只讓自己和手機應用程式使用該帳戶。robot 是沒有任何權限的普通使用者,必須授予權限後才能存取內容。
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 accessACL(存取控制清單)項目包含使用者、主題和權限。主題可以是確切名稱,也可以是 pattern;其中 * 會比對任意內容。因此,alerts_* 可以涵蓋 alerts_backup 和 alerts_db,不必為每台主機各執行一次指令。權限 write 代表只能發布,因此即使 cron job 的 token 遭竊,攻擊者也無法訂閱並讀回它發布的內容。特殊使用者名稱 everyone 用來設定未驗證訪客可執行的操作。將 deny-all 設為預設值時,通常只會用它刻意開放公開內容,例如 ntfy access everyone status read;如果要明確禁止匿名訪客存取某個主題,也可以使用 deny。
指令碼應攜帶 token,不要使用你的密碼。
sudo docker compose exec ntfy ntfy token add robot該指令會輸出一組以 tk_ 開頭的 token。Token 完全繼承所屬使用者的存取權限,因此這組 token 只能發布到 alerts 主題,無法執行其他操作。ntfy token list 會顯示現有項目,ntfy token remove 則可撤銷其中一組 token,且不會變更使用者的密碼。
發送第一則訊息並驗證鎖定功能是否運作
首先檢查門是否已關閉。
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts該指令會輸出 403,而 403 是正確的答案:auth-default-access: "deny-all" 會拒絕匿名發布。現在發送一則真實訊息。
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/alerts伺服器會以 JSON 格式回傳儲存的訊息,這代表訊息已被接收而非被丟棄。Title 是粗體的第一行。Priority 的範圍從 1 到 5,或透過名稱從 min 到 urgent,它決定了手機是否會發出提示音。當名稱符合已知的 emoji 簡碼時,Tags 會在通知中顯示為 emoji,若不符合則維持純文字。
若要從終端機監控主題,請串流該主題:
curl -s -u admin https://ntfy.example.com/alerts/rawcurl 會提示輸入密碼。每則訊息會以單行顯示,偶爾出現的空白行則是連線存活訊號(keepalives)。在瀏覽器中開啟 https://ntfy.example.com 並使用相同帳號登入,即可使用該串流的網頁應用程式版本。
設定速率限制,避免單一 script 淹沒伺服器
預設情況下,每位訪客都有一個可容納 60 個請求的 bucket,每 5 秒補充 1 個請求。對私人伺服器而言,這項限制相當寬鬆,而卡在重試迴圈中的 script 會耗盡整個 bucket。請將限制加入 server.yml。
visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500sudo docker compose restart ntfy超過限制的訪客會收到 HTTP 429,而不是已傳送的訊息。限制是依訪客位址計算,這正是 behind-proxy: true 如此重要的原因:沒有它時,ntfy 只會看到 Caddy 的位址,所有用戶端都會被視為同一位訪客,而單一嘈雜的 script 就能耗盡手機與其他伺服器共用的 bucket。自 v2.36.0 起,每日計數會保存在使用者資料庫中,即使重新啟動也不會遺失;每位訪客的額度會依自己的 24 小時週期重設,而不是在 UTC 午夜重設。
來自失敗 cron job 的警報
請勿將 token 放在命令列中。ps aux 會向系統上的所有使用者顯示每個執行中處理程序的完整命令列,因此透過 -H 傳遞的 token 在 curl 執行期間,任何本機帳號皆可讀取。使用 curl 設定檔可避免此問題。
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/curlrc現在封裝該工作。將其儲存為 /usr/local/bin/backup-with-alert.sh 並執行 chmod 750。
#!/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$? 會在命令執行後的下一行立即擷取,因為後續執行的命令會覆蓋它。輸出會透過 tail -c 1000 處理,因為 ntfy 強制執行訊息大小上限,且通知並非日誌檢視器。結尾的 exit "$code" 會保留原始狀態,確保監控此工作的其他程序仍能偵測到失敗。將指令碼指向 /bin/false 進行一次執行測試,以驗證整體流程。
從未執行的失敗分支比沒有警報更糟,因為這會讓人誤以為靜默代表成功。Cron 提供給工作的環境幾乎是空的,且 PATH 比您的登入 shell 短得多,因此手動執行時正常的指令碼,可能在執行到 curl 行之前就已終止。關於 cron job 為何無法執行的指南 涵蓋了這些環境陷阱。請務必在所有地方使用絕對路徑,並在第一次排程執行後讀取日誌檔案,而非憑空假設。
當 systemd unit 失敗時發出警示
Cron 適合處理排程工作。長時間執行的服務需要 OnFailure=;systemd 會在 unit 進入 failed 狀態時執行它。建立一個範本 unit,讓主機上的所有服務共用。將以下內容儲存為 /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 %i接著執行 /usr/local/bin/ntfy-unit-failed,並設定模式為 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/alerts使用 drop-in 將它附加至服務,避免套件升級覆寫你的修改。
sudo systemctl edit myapp.service[Unit]
OnFailure=ntfy-unit-failed@%n.service%n 會展開為完整的 unit 名稱,因此實例化後的 unit 會成為 ntfy-unit-failed@myapp.service.service;範本中的 %i 則會將 myapp.service 傳給指令碼作為第一個引數。如此一來,同一個範本就能服務所有 unit。建立一個刻意失敗的 unit 來驗證設定,並將它儲存為 /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.service啟動指令會以非零狀態結束並輸出 Job for ntfy-selftest.service failed because the control process exited with error code,手機應在約 1 秒後發出提示。完成後刪除測試 unit。
有一個陷阱需要注意。OnFailure= 只會在 unit 進入 failed 狀態時執行,而 RestartMode=direct 會在自動重新啟動期間略過該狀態,因此也會略過失敗處理常式。使用預設的 RestartMode=normal 時,自動重新啟動會經過 failed 狀態。StartLimitBurst 和 StartLimitIntervalSec 控制何時拒絕重複啟動;請設定這些值,讓反覆崩潰的服務最終停止。Timer 是上述 Cron 模式較合適的替代方案,因為 Timer 的 service unit 支援相同的 OnFailure= drop-in,而 VPS 上的 systemd 服務與 Timer 指南 會說明如何將現有設定轉換為 Timer。
將正常運作時間監控串接至相同主題
自架狀態監控工具 Uptime Kuma 提供 ntfy 通知類型。開啟 Settings,再依序選取 Notifications 和 Setup Notification,選擇 Ntfy,將伺服器 URL 設為 https://ntfy.example.com,將主題設為 alerts,選取優先順序,並貼上 robot 存取權杖。儲存前先傳送測試通知,因為主題名稱錯誤時,若 write 授權未涵蓋該主題,會傳回錯誤。
這種配置有明確限制:在同一台 VPS 上執行的監控工具,無法告知你 VPS 已停止運作;而 ntfy 無法在自身停止運作時傳送 ntfy 已停止運作的通知。請將監控工具執行在不同的機器上,並為其設定第二個通知管道,例如電子郵件,用來監控 ntfy 本身。Uptime Kuma 的 Push 監控類型可處理另一個監控盲點:cron 工作成功執行後呼叫 push URL,當 Kuma 停止收到這些呼叫時發出警示。失敗分支只有在工作已執行時才會觸發,因此無法反映工作根本未啟動的情況。
自架 ntfy 能在 Android 和 iPhone 上運作嗎?
在 Android 上可以,沒有額外限制。從 Google Play 或 F-Droid 安裝應用程式,開啟 Settings,將預設伺服器設為 https://ntfy.example.com,在使用者管理畫面中加入帳戶,然後訂閱 alerts。Instant delivery 會讓前景服務持續執行,因此即使手機處於 doze mode,訊息仍會送達;隨之出現的永久通知是 Android 對前景服務的要求,不是錯誤。F-Droid 版本完全不含 Firebase 程式碼,因此所有訂閱都會使用 instant delivery。ntfy 也能作為 UnifiedPush distributor,提供 Google 推播服務的開放替代方案,因此其他支援 UnifiedPush 的應用程式也能透過你的伺服器傳送通知。
在官方 iOS 應用程式中可以運作,但有一項無法移除的相依性。iOS 會暫停在背景執行的應用程式,而 Apple 允許的背景模式(播放音訊、接收位置更新、處理排程工作)不允許應用程式持續等待伺服器訊息,因此必須透過 APNs(Apple push notification service)才能即時喚醒應用程式。只有具備該應用程式授權憑證的服務供應者才能向它傳送通知,因此你的伺服器無法直接聯絡官方應用程式。ntfy 透過 relay 解決這個問題:你的伺服器會將包含訊息 ID 的 poll_request 傳送至 ntfy.sh,再由 ntfy.sh 透過 Firebase 和 APNs 轉送通知以喚醒應用程式,接著應用程式會從你的伺服器擷取訊息內容。
upstream-base-url: "https://ntfy.sh"請明確了解這項設計的代價。訊息內容會留在你的伺服器上,但訊息已抵達的事實及其 ID 會經過你未管理的基礎架構。若未啟用這項設定,自架伺服器傳送至 iPhone 的通知仍會最終抵達,但 ntfy 文件警告延遲可能長達數小時,因為沒有任何機制能及時喚醒應用程式。若要在不使用 ntfy.sh relay 的情況下使用原生 iOS 應用程式,必須使用自己的 Apple developer account 和 APNs keys 自行建置並發布應用程式,這表示需要支付年費,而且每次更新都必須重新建置。另一個選項是在 iOS 16.4 或更新版本使用 ntfy 的 PWA:將它加入主畫面,並在伺服器上設定 Web Push。這可避開 ntfy.sh relay,但仍會使用瀏覽器的推播基礎架構。若你的使用情境無法接受 relay,請將警示通知留在 Android 或桌面版 web app 上。
備份、升級與固定映像檔版本
有兩個路徑無法重新產生:/etc/ntfy/server.yml 和 /var/lib/ntfy/user.db。第二個路徑包含所有使用者、密碼雜湊、ACL 項目與 token,因此應像處理 private key 一樣保護它。
sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgz請將該檔案複製到伺服器外部。cache.db 儲存最近的訊息;搭配上述 cache-duration 時會保留 12 小時,此外也會儲存排程稍後傳送的訊息,直到訊息傳送後 12 小時才刪除。除非你會預先排程訊息,否則遺失這些資料不會造成值得保護的損失。升級的方法是編輯 compose 檔案中的標籤、pull 映像檔,然後重新建立容器。
sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/health請先閱讀 release notes。SQLite 資料庫會在啟動時執行 migration,因此 schema 變更後回復到較舊的標籤並不安全。例如,v2.31.1 將訊息快取移至 schema version 17,其升級說明指出,若要降級至 v2.31.0 或更早版本,必須手動將該版本改回 16。升級至 v2.36.0 會將所有人現有的每日計數重設一次。請保留剛才建立的備份,直到新版本執行滿一天。說明中也會標示行為變更。自 v2.31.0 起,使用 since=<message ID> 重新連線的用戶端也會收到同一秒發布的訊息,因此可能看到重複內容。ntfy apps 和 web app 會依 message ID 捨棄重複訊息,但自行重播主題的 script 也必須採用相同處理方式。主機上的每項服務都有一份無法重新產生的路徑清單,而PhotoPrism 與 Immich 的比較會整理同類 VPS 上相片庫所需的清單及相應的備份指令。
Gotify 與 Apprise
Gotify 是較精簡的選項:提供單一 binary、Web UI 與 Android app,並依 application 整理訊息,適合 Android 是唯一接收端的私人主機。Apprise 是 Python library 與 command line tool,也提供獨立的 Apprise API server,能將單則訊息同時轉送至包括 ntfy 在內的 100 多項服務,適合必須一次通知多個位置的 script。ntfy 則同時提供 server、HTTP API,以及支援兩大行動平台的 app,因此通常是從租用伺服器發送警示時的選擇。
FAQ
為什麼發布到我的 ntfy 伺服器會回傳 403?
在 server.yml 中啟用 auth-default-access: "deny-all" 時,匿名發布會遭到拒絕,這是預期行為。請透過 -u user:pass 或 -H "Authorization: Bearer tk_..." 傳送認證資訊。如果你已經傳送 token,仍收到 403,請確認該使用者是否有允許寫入該 topic 的 ACL 項目:沒有相符項目時,read-only 或 deny 會拒絕發布。在 v2.34.0 中,來自相同 IP 的並行請求也可能導致有效認證被視為匿名;v2.35.0 已修正此錯誤,因此請先升級,再將間歇性出現的 403 視為 ACL 問題的證據。執行 ntfy access 以列出完整清單。請注意,write 授權不允許訂閱,因此能正常發布的帳戶,在嘗試讀取相同 topic 時仍會遭到拒絕。
在自架 ntfy 伺服器上,iPhone 能正常接收通知嗎?
使用官方 iOS app 時,通知會透過 relay 傳送。處於暫停狀態的 iPhone app 必須透過 APNs (Apple push notification service) 喚醒,而傳送至官方 app 需要其發布者的 push 認證,因此 ntfy 會將包含訊息 ID 的 poll_request 轉送至 ntfy.sh,再由 ntfy.sh relay 至裝置。在 server.yml 中設定 upstream-base-url: "https://ntfy.sh",然後重新啟動 container。訊息本文仍會從你的伺服器擷取。未設定此項目時,iOS 通知仍會最終送達,但 ntfy 文件警告延遲可能長達數小時。當你的伺服器已設定 Web Push 時,PWA 也能在 iOS 16.4 或更新版本上提供另一種方式。
為什麼我的 cron 工作沒有收到 ntfy 警示?
先單獨執行 curl 那一行,確認 token 和 topic 正確。如果手動執行成功,但從 cron 執行失敗,問題發生在警示之前:cron 會以精簡環境和較短的 PATH 執行工作,因此使用裸名稱呼叫命令的 script 可能在執行到 curl 那一行前就結束。請使用絕對路徑,將工作輸出重新導向至 log 檔案,並在下一次執行後讀取該檔案。收到 429 回應而不是通知,表示請求遭到限制拒絕。通常是 script 重試過於頻繁,但已用完每日配額的訪客,例如達到上述設定的訊息限制,即使只提出單一請求,也會以相同方式遭到拒絕。
我應該將 ntfy 暴露在公用網際網路上嗎?
手機 app 必須能從行動網路連線至伺服器,因此具備 auth-default-access: "deny-all" 和每個 topic ACL 的公開 HTTPS endpoint 是一般設定。只要沒有 topic 可由 everyone 讀取,這種設定就是安全的。當每個訂閱者都是你控制的機器時,僅限 VPN 的 instance 是合理選擇。但這不適合手機,因為 app 只有在 tunnel 建立時才能接收通知;手機重新連線前,警示會持續排隊。