ntfyをDockerで自己ホストする方法と認証設定
Docker Composeでntfyサーバーを構築し、TLS環境でプッシュ通知を運用する手順を解説します。認証機能とACLを有効化し、cronやsystemdのOnFailureから安全に通知を送信するための設定方法を網羅しました。
自己ホスト ntfy サーバーの役割
自己ホスト ntfy サーバーは、HTTP POST をスマートフォンへのプッシュ通知に変換します。curl で公開すると、メッセージは Android アプリ、iOS アプリ、ブラウザーのタブ、または HTTP 接続を開いたままにできるその他のクライアントに届きます。インストールするクライアントライブラリも、実行するメッセージブローカーも必要ありません。
ntfy は topic でメッセージを識別します。topic は https://ntfy.example.com/alerts のように URL パスに含める名前で、誰かがそこへ公開した時点で作成されます。デフォルトのインストールでは、その名前を知っている人なら誰でも topic を読み取り、書き込めます。そのため、プロジェクトの公式ドキュメントでは topic 名をパスワードにたとえています。このモデルは公開 ntfy.sh サービスには適しています。しかし、バックアップ失敗通知を扱うサーバーには適していません。そこで、このガイドでは最初のメッセージを送信する前に認証を有効にします。
開始前に必要なもの
Docker Engine と Compose plugin をインストールした Ubuntu 24.04 または Debian 13 の VPS、ドメイン名、少量の 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 レコードを通じて、ホスト名がインターネット上でサーバーを指している必要があります。Let's Encrypt が使用するプロトコルである ACME(automatic certificate management environment)は、HTTP チャレンジにポート 80 を使用するため、このポートは開けたままにします。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 は、X-Forwarded-For ヘッダーからクライアントアドレスを取得するよう ntfy に指示します。これにより、レート制限はリバースプロキシを 1 つの非常に活発なクライアントとして数えるのではなく、実際の訪問者ごとに適用されます。
enable-login: true により、ユーザーは Web アプリまたは API からサインインできます。enable-signup は false のままにします。プライベートサーバーでのセルフサービスによるアカウント作成は、手順が増えただけの無防備な入口になるためです。
sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.ymlDocker Compose で ntfy を実行する
これを /opt/ntfy/compose.yaml に記述し、1000:1000 を上に表示された 2 つの番号 id -u と id -g に置き換えます。
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 ファイルには意図的な点が 2 つあります。イメージは、latest ではなく、2026 年 11 月 1 日時点の最新安定リリースである v2.36.0 に固定しています。latest を実行すると次の docker compose pull で最新イメージがダウンロードされ、その後の docker compose up -d でコンテナがそのイメージを使って再作成されるためです。pull するだけでは、実行中のサーバーのバージョンは変わりません。固定したタグも更新が必要です。2026 年 10 月だけで 10 個のリリースがありました。10 月 7 日に v2.29.0、10 月 12 日に v2.30.0、10 月 16 日に v2.31.0 と v2.31.1、10 月 18 日に v2.32.0、10 月 23 日に v2.33.0 と v2.33.1、10 月 24 日に v2.34.0、10 月 30 日に v2.35.0、10 月 31 日に v2.36.0 がリリースされています。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 は独自の firewall ルールをユーザーのルールより先に挿入します。その結果、ufw status でポートを閉じていても、インターネットからそのポートに応答します。どちらの習慣も、次に追加するコンテナへ引き継げます。self-hosted RustDesk relay も同じ方法でイメージタグを固定します。ただし、signal ポートと relay ポートはインターネットから応答する必要があるため、loopback の背後に隠すことはできません。
curl が Connection refused を出力した場合は、コンテナログを確認します。/var/lib/ntfy/user.db の権限エラーは、user: の行がこれらのディレクトリの所有者と一致していないことを示します。そのため、プロセスは自身のデータベースを作成できず終了します。VPS 向け Docker Compose 基礎ガイドでは、volume の所有権と restart policy について詳しく説明しています。
Caddy で TLS を前段に置く
Caddy は証明書の取得と更新を自動で行うため、動作する TLS(transport layer security)環境を最短で構築できます。
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 のログに、接続のリセットなど、検出した upstream エラーが記録されます。証明書エラーは通常、DNS レコードが誤っているか、証明書の検証から port 80 または 443 のサーバーへ到達できないことを意味します。sudo journalctl -u caddy -n 50 で検証エラーを確認してください。後から別のサービスを追加する場合は、同じ Caddyfile に hostname block を 1 つ追加します。これにより、Jellyfin ライブラリ用の 90 年代風ビデオストアフロントエンドである Halcyon などを、同じホストの 2 つ目のサブドメインで公開できます。
すでに nginx を運用している場合は、ntfy のドキュメントにある proxy 設定を使用します。proxy_http_version 1.1、proxy_buffering off、proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for を設定し、read timeout と send timeout を少なくとも 3 分にしてください。subscriber は、待ち受けている間、1 つの HTTP 接続を開いたままにします。nginx のデフォルトの proxy_read_timeout は 60 秒ですが、これは 2 回の read の間の時間だけを計測します。ntfy は、非アクティブ状態によって中継機器が接続を閉じないように、デフォルトで 45 秒ごとに keepalive メッセージを送信します(keepalive-interval)。そのため、通信のない subscriber も標準の nginx の背後で接続を維持できます。長めの timeout は余裕を確保するためのものであり、接続を維持する仕組みそのものではありません。keepalive-interval を延長する場合は、proxy の read timeout より短くしてください。
ユーザーを作成し、トピックへのアクセスを制限する
認証は有効ですが、まだ誰も何にもアクセスできません。これが意図した状態です。自分用の管理者アカウントを1つ、スクリプト用のマシンアカウントを1つ作成します。これらのコマンドはコンテナ内の /etc/ntfy/server.yml を読み取ります。そのため、設定ファイルをボリュームマウントしています。
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(アクセス制御リスト)のエントリは、ユーザー、トピック、権限で構成されます。トピックには固定名かパターンを指定できます。パターンでは * が任意の文字列に一致するため、ホストごとにコマンドを実行しなくても、alerts_* で alerts_backup と alerts_db を対象にできます。権限 write はパブリッシュのみを意味します。そのため、cron ジョブからトークンが盗まれても、送信した内容をサブスクライブして読み返すことはできません。特殊なユーザー名 everyone では、未認証のアクセス元に許可する操作を指定します。デフォルトが deny-all の場合、主に ntfy access everyone status read のような対象を意図的に公開するときに使用します。また、匿名のアクセス元をトピックから明示的に締め出すルールが必要な場合は deny も使用できます。
スクリプトにはパスワードではなくトークンを持たせてください。
sudo docker compose exec ntfy ntfy token add robotこのコマンドは tk_ で始まるトークンを出力します。トークンは、それが属するユーザーのアクセス権をそのまま引き継ぎます。そのため、このトークンでできるのは alerts トピックへのパブリッシュだけです。ntfy token list では存在する項目を確認でき、ntfy token remove ではユーザーのパスワードに影響を与えずに1つを無効化できます。
最初のメッセージを送信し、ロックが機能することを確認する
まず、ドアが閉まっていることを確認します。
curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts403 と表示されます。403 が正しい答えです。auth-default-access: "deny-all" は匿名ユーザーによる publish を拒否します。次に、実際のメッセージを送信します。
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 までの名前で指定し、スマートフォンで通知音を鳴らすかどうかを決めます。名前が既知の絵文字の短縮コードと一致すると、Tags は通知上で絵文字に変換されます。一致しない場合はプレーンテキストのまま表示されます。
端末からトピックを監視するには、ストリームとして取得します。
curl -s -u admin https://ntfy.example.com/alerts/rawcurl はパスワードの入力を求めます。各メッセージは 1 行で届き、ときどき現れる空行はキープアライブです。ブラウザーで https://ntfy.example.com を開き、同じアカウントでサインインすると、同じストリームを Web アプリ版で確認できます。
1 つのスクリプトがサーバーに大量のリクエストを送れないよう rate limit を設定する
デフォルトでは、各訪問元に 60 リクエスト分のバケットが割り当てられ、5 秒に 1 リクエストの割合で補充されます。これはプライベートサーバーには余裕のある設定です。しかし、再試行ループで停止したスクリプトはこの枠をすべて使い切ります。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 のアドレスしか見えず、すべてのクライアントが同じ訪問元として扱われます。その結果、1 つの負荷の高いスクリプトが、スマートフォンや他のサーバーと共有しているバケットを使い切ります。v2.36.0 以降は、日次カウントが user database に再起動後も保持されます。また、各訪問元の上限は UTC の午前 0 時ではなく、それぞれの 24 時間周期でリセットされます。
cron ジョブが失敗した場合のアラート
トークンをコマンドラインに含めないでください。ps aux は実行中のすべてのプロセスの完全なコマンドラインを同じサーバー上のすべてのユーザーに表示するため、-H で渡したトークンは、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 に指定して1回実行し、全体をテストしてください。
実行されない失敗分岐は、アラートがない場合より悪い状態です。無音が成功を意味するように見えるためです。Cron はジョブにほぼ空の環境と、ログインシェルより大幅に短い PATH を与えます。そのため、手動実行では動くスクリプトでも、curl の行に到達する前に終了することがあります。cron ジョブが実行されない理由を説明したガイドでは、このような環境による問題を説明しています。すべての場所で絶対パスを使用し、最初のスケジュール実行後にログファイルを確認してください。実行されるはずだと決めつけないでください。
systemd unit の失敗時に通知する
Cron はスケジュールされた処理を担当します。長時間実行するサービスには OnFailure= が必要です。systemd は unit が failed 状態に移行するたびにこれを実行します。テンプレート unit を1つ作成し、サーバー上のすべてのサービスで再利用します。次の内容を /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/alertsdrop-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 をスクリプトの第1引数として渡します。これにより、1つのテンプレートをすべての 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.servicestart コマンドはゼロ以外の終了ステータスで終了し、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 は、繰り返しの起動を拒否するタイミングを制御します。クラッシュループが最終的に停止するように設定してください。タイマーは、上記の cron パターンを置き換えるより適切です。タイマーの service unit では同じ OnFailure= drop-in を使用でき、VPS で systemd のサービスとタイマーを使用するガイドでは、その移行手順を説明しています。
同じトピックに稼働監視を接続する
セルフホスト型ステータス監視ツール Uptime Kuma には、ntfy 通知タイプが組み込まれています。Settings、Notifications、Setup Notification の順に開き、Ntfy を選択します。Server URL に https://ntfy.example.com、Topic に alerts を指定し、優先度を選択して、robot access token を貼り付けます。保存する前にテスト通知を送信してください。トピック名が誤っていると、そのトピックを対象に含まない write grant ではエラーになるためです。
この構成には明確な限界があります。同じ VPS 上で動作する監視ツールでは、その VPS 自体が停止したことを検知できません。また、ntfy が停止していることを ntfy で通知することもできません。監視ツールは別のマシンで実行し、ntfy 自体を監視する監視ツール用に、メールなどの 2 番目の通知チャネルを用意してください。Uptime Kuma の Push monitor type を使うと、もう 1 つの死角にも対応できます。cron job は正常終了後に push URL を呼び出し、その呼び出しが届かなくなると Kuma が警告します。failure branch は job が実行された場合にだけ動作するため、job 自体が開始されなかったことは検知できません。
セルフホストした ntfy は Android と iPhone で動作しますか?
Android では、制限なく動作します。Google Play または F-Droid からアプリをインストールし、Settings を開いて、デフォルトサーバーを https://ntfy.example.com に設定します。ユーザー管理画面でアカウントを追加し、alerts を購読します。Instant delivery ではフォアグラウンドサービスが実行されるため、スマートフォンが doze モード中でもメッセージが届きます。表示される常設通知は不具合ではなく、フォアグラウンドサービスに必要な Android の仕様です。F-Droid 版には Firebase のコードが一切含まれないため、すべての購読で instant delivery が使われます。ntfy は UnifiedPush のディストリビューターとしても動作します。これは Google のプッシュサービスに代わるオープンな仕組みです。そのため、UnifiedPush に対応する他のアプリもサーバー経由で通知を配信できます。
公式 iOS アプリでは動作しますが、取り除けない依存関係が 1 つあります。iOS はバックグラウンドのアプリを停止します。また、Apple が許可しているバックグラウンドモード(音声の再生、位置情報の更新、スケジュールされたタスクの処理)では、アプリがサーバーからのメッセージを待ち続けることはできません。そのため、アプリをすぐに起動するには APNs(Apple push notification service)経由で通知する必要があります。アプリ用に認証された資格情報を持つプロバイダーだけが、そのアプリへ通知を送信できます。したがって、サーバーから公式アプリへ直接通知を送ることはできません。ntfy はリレーでこの問題を解決します。サーバーはメッセージ ID を含む poll_request を ntfy.sh に送信します。ntfy.sh は Firebase と APNs を経由して通知を転送し、アプリを起動します。その後、アプリがサーバーからメッセージ本文を取得します。
upstream-base-url: "https://ntfy.sh"この仕組みのコストを明確に理解してください。メッセージの内容は自分のサーバーに残ります。しかし、メッセージが届いた事実とその ID は、自分で運用していないインフラを通過します。この設定を使わなくても、セルフホストしたサーバーから iPhone へ通知は最終的に届きます。ただし、ntfy のドキュメントでは、アプリをすぐに起動する仕組みがないため、遅延が数時間に及ぶ場合があると説明されています。ntfy.sh のリレーを使わずにネイティブ iOS アプリを使用するには、自分の Apple developer account と自分の APNs keys を使って、アプリを自分でビルドして配布します。この方法では年間料金がかかり、更新のたびに再ビルドが必要です。別の方法として、iOS 16.4 以降の ntfy の PWA を使えます。ホーム画面に追加し、サーバーで Web Push を設定します。これにより ntfy.sh のリレーは回避できますが、ブラウザーのプッシュ通知インフラは引き続き使用します。リレーを受け入れられない場合は、通知を Android またはデスクトップの Web アプリで運用してください。
バックアップ、アップグレード、イメージの固定
再生成できないパスは 2 つあります。/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最初にリリースノートを確認します。SQLite database は起動時に migrate されるため、schema の変更後に古いタグへロールバックするのは安全ではありません。たとえば v2.31.1 は message cache を schema version 17 に移行します。upgrade notes には、v2.31.0 以前へ downgrade する場合は、その version を手動で 16 に戻す必要があると記載されています。v2.36.0 へアップグレードすると、既存の全ユーザーの日次カウントが 1 回リセットされます。新しいバージョンを 1 日運用するまで、今取得したバックアップを保管してください。リリースノートには動作の変更も記載されています。v2.31.0 以降、クライアントが since=<message ID> を使って再接続すると、同じ秒に公開されたメッセージも受信します。そのため、重複が発生する可能性があります。ntfy アプリと web app は message ID で重複を除外しますが、独自のスクリプトでトピックを再生する場合も同じ処理が必要です。このサーバー上の各サービスには、再生成できないパスの短い一覧があります。PhotoPrism と Immich の比較では、同じ種類の VPS 上で photo library を運用する場合について、その一覧と対応するバックアップコマンドを整理しています。
Gotify と Apprise
Gotify は、より小規模な選択肢です。1 つのバイナリに Web UI と Android アプリが含まれ、メッセージはアプリケーションごとに整理されます。Android だけを通知先にするプライベートサーバーに適しています。Apprise は Python ライブラリ兼コマンドラインツールです。別途 Apprise API サーバーも利用できます。1 件のメッセージを ntfy を含む100以上のサービスへ同時に送信できます。そのため、複数の宛先へ一度に通知する必要があるスクリプトに適しています。ntfy はサーバー、HTTP API、モバイル両プラットフォーム向けアプリを提供します。このため、レンタルサーバーからのアラート通知では通常 ntfy が選ばれます。
FAQ
ntfy サーバーへの公開で 403 が返るのはなぜですか?
server.yml で auth-default-access: "deny-all" を使用している場合、匿名での公開は拒否されます。これは意図した動作です。-u user:pass または -H "Authorization: Bearer tk_..." で認証情報を送信してください。すでにトークンを送信しているにもかかわらず 403 が返る場合は、そのユーザーにトピックへの書き込みを許可する ACL エントリがあるか確認してください。一致するエントリがない場合、read-only または deny によって公開が拒否されます。v2.34.0 では、同じ IP からの同時リクエストによって、有効な認証情報が匿名として扱われることもありました。v2.35.0 でこのバグが修正されているため、断続的な 403 を ACL の問題の証拠と判断する前にアップグレードしてください。完全な一覧を表示するには ntfy access を実行します。write の許可では購読できない点にも注意してください。そのため、公開は正常に行えるアカウントでも、同じトピックを読み取ろうとすると拒否されます。
自己ホストした ntfy サーバーで、iPhone に通知できますか?
公式 iOS アプリを使用する場合は、リレー経由で通知できます。サスペンド中の iPhone アプリをすぐに起こすには、APNs (Apple push notification service) 経由で通知する必要があります。また、公式アプリに送信するには、その提供元のプッシュ認証情報が必要です。そのため ntfy はメッセージ ID を含む poll_request を ntfy.sh に転送し、ntfy.sh がデバイスへ中継します。server.yml に upstream-base-url: "https://ntfy.sh" を設定して、コンテナを再起動してください。メッセージ本文自体は、引き続きサーバーから取得されます。この設定がない場合でも iOS 通知は最終的に届きますが、ntfy のドキュメントでは遅延が数時間に及ぶ場合があると説明されています。サーバーで Web Push を設定すれば、iOS 16.4 以降では PWA も別の方法として利用できます。
cron ジョブの ntfy アラートが届かなかったのはなぜですか?
まず curl の行を単独で実行し、トークンとトピックが正しいことを確認してください。手動では動作するのに cron から動作しない場合、失敗箇所はアラート処理より前です。cron は最小限の環境と短い PATH でジョブを実行するため、コマンドを名前だけで呼び出すスクリプトは curl の行に到達する前に終了することがあります。絶対パスを使用し、ジョブの出力をログファイルへリダイレクトして、次回実行後にそのファイルを確認してください。配信ではなく 429 のレスポンスが返る場合は、制限によってリクエストが拒否されています。通常はスクリプトが短い間隔で再試行しています。ただし、上で設定したメッセージ制限など、1 日あたりのクォータを使い切った利用者も、1 回だけのリクエストで同じように拒否されます。
ntfy をインターネットに公開すべきですか?
スマートフォンのアプリはモバイルネットワークから ntfy に接続する必要があります。そのため、auth-default-access: "deny-all" とトピックごとの ACL を設定した公開 HTTPS エンドポイントが一般的です。everyone から読み取れるトピックがなければ、安全に運用できます。購読者がすべて自分で管理するマシンであれば、VPN 専用のインスタンスも適しています。スマートフォンには向きません。アプリが通知を受信できるのはトンネル接続中だけなので、スマートフォンが再接続するまでアラートがキューに残るためです。