ntfyを使ったスマホ通知の実用例

元メモ ntfyを使ったスマホへの通知の実用例を探す
今は cli の実行完了に使っている

概要

ntfyはHTTPベースの軽量プッシュ通知サービス（OSS、無料ホスト版 ntfy.sh あり）。curl -d "本文" ntfy.sh/トピック名 だけで通知が飛ぶ手軽さが特徴。
実用例は大きく「システム/サーバー監視」「CI/CD連携」「ホームオートメーション・IoT」「定期実行の死活監視（デッドマンズスイッチ）」の4系統が多い。
このリポジトリ（line-obsidian）でも既に watch.sh 内で NTFY_URL="https://ntfy.sh/m1104m-cli-notify" を使い、LINEメモのレポート生成・Cloudflare Pagesデプロイ完了時の通知に利用している。今回の「CLI実行完了通知」はこの用途を指していると推測。
単純なテキスト送信以外に、優先度・アクションボタン・添付ファイル・クリック時URL・スケジュール送信・Markdown整形などの機能があり、組み合わせるとCLI通知の枠を超えた活用ができる。
注意点として ntfy.sh の公開トピックは「トピック名がパスワード代わり」であり、知られると誰でも購読・投稿できる。

深掘り内容

現在の自分の使い方（このリポジトリでの実例）

watch.sh:23 で NTFY_URL="https://ntfy.sh/m1104m-cli-notify" を定義し、LINEメモを検知→Claude Codeでレポート生成→Cloudflare Pagesへデプロイ、という一連のバッチ処理が完了した際に通知を送っている（コミット 88e1c23 Deploy reports to Cloudflare Pages and notify via ntfy）。これがメモにある「今は cli の実行完了に使っている」の実体と考えられる。

1. システム・サーバー監視

ディスク容量アラート：cronで定期チェックし、閾値を下回ったら Priority: high で通知

curl -d "Only $avail GB available" -H "Priority: high" ntfy.sh/mytopic

SSH不正/正規ログイン検知：PAM (pam_exec.so) と連携し、ログインの度に通知
アップタイム監視：Uptime Kuma、UptimeRobot、Gatus、Healthchecks.io などがntfyへの通知先として公式対応
Prometheus Alertmanager / Grafana のアラートをntfyへ中継するリレースクリプトも公開されている

2. CI/CD連携

GitHub Actionsのワークフロー完了時に、リポジトリ名・コミット・成否ステータスを通知
Woodpecker CI、Drone.io にはntfy向けプラグインが存在
?template=github のようなクエリでGitHub/Grafana/Alertmanagerの生JSONペイロードを自動整形して送れる機能もある

3. ホームオートメーション・IoT

Home Assistant、Node-REDと連携し、ドアベルの人感センサー、温湿度センサーの閾値超過、ペットの給餌センサーなどをトリガーに通知
Watchtower（Dockerコンテナの自動更新）がイメージ更新をntfy経由で通知
changedetection.io（Webサイト変更監視）とApprise経由で連携

4. 定期実行の死活監視（デッドマンズスイッチ）

At/In ヘッダーでの遅延送信を利用し、一定時間ごとに未来の警告メッセージを予約し続け、プロセスが正常に動いていれば都度上書き、止まったら予約通り警告が届く、という仕組みが組める。長時間バッチや監視スクリプト自体が異常終了・ハングした場合に気づけるのが利点（現状の「正常終了時だけ通知」を補完する形）。

while true; do
  curl -H "In: 5m" -d "Heartbeat stopped!" ntfy.sh/mytopic/check
  sleep 60
done

5. CLI通知を拡張する高度な機能

現状は本文だけのシンプルな通知と推測されるが、以下のヘッダーを足すだけで情報量を増やせる。

機能	ヘッダー	用途例
優先度	`Priority: 5`〜`1`	エラー時だけ最優先で振動させる
タイトル	`Title: ...`	「line-obsidian: レポート生成完了」等を明示
絵文字タグ	`Tags: white_check_mark` / `warning`	成功✅・失敗⚠️を視覚的に区別
クリック時URL	`Click: https://...`	通知タップでPages上のレポートを直接開く
アクションボタン	`Actions: view, レポートを開く, https://...`	ボタンから即座に遷移
Markdown	`Markdown: yes`	リンクや強調をリッチ表示

複合例（ドアベル通知だが構造は流用可能）：

curl \
  -H "Title: Door camera alert" \
  -H "Priority: 5" \
  -H "Tags: warning" \
  -H "Click: https://home.nest.com/" \
  -H "Actions: http, Open door, https://api.nest.com/open" \
  -d "Someone at the door. 🐶" \
  ntfy.sh/doorbell

これを watch.sh に当てはめると、成功時は Tags: white_check_mark + Click: <生成されたPages URL>、失敗時は Priority: high + Tags: warning として通知を出し分けられる。

注意点（セキュリティ）

ntfy公式ドキュメントは「トピック名はパスワードと同じ」と明記している。m1104m-cli-notify のようなトピック名を知っている第三者は誰でも購読・投稿が可能（ntfy.sh はレート制限とfail2banで一定の防御はしている）。個人利用・通知内容が非機密であれば実用上大きな問題にはなりにくいが、機密情報を流す場合はセルフホストまたは require-login などのアクセス制御が推奨されている。

参考リンク

次のアクション

watch.sh のntfy通知に Title / Tags / Click（生成されたPages URLへのリンク）を追加し、通知だけで内容と結果がわかるようにリッチ化する。
通知が届かない＝バッチが異常終了/ハングしたケースを検知したいなら、In ヘッダーを使ったデッドマンズスイッチ方式の導入を検討する。
m1104m-cli-notify は公開トピックなので、通知内容に個人情報や機微な内容を含めないか、含めるならセルフホストや require-login の導入を検討する。