ntfy — 軽量プッシュ通知

ntfy — 軽量プッシュ通知

---

スクリプトが終わった瞬間、スマホが震えてくれたら——しかもアプリを1つもインストールせずに——と思ったことはありませんか？それがntfyの日常的な魔法です。ntfyはあらゆるトピックをpub-subチャンネルに変え、シンプルなHTTPリクエストでpingを送れます。

Hermes Agentユーザーにとって、ntfyはAIエージェントをポケットに入れて持ち歩く最も簡単な方法です。SDKもデーモンもNode.jsも不要。トピック名と無料のntfyモバイルアプリだけあればOK。ここではその設定方法を紹介します。

ntfyがHermesにぴったりな理由

Hermesは軽量自動化が身上です。ntfyはその哲学に完璧にマッチします：

• 依存関係ゼロ — アダプターはHermesに同梱済みのhttpxを使用。
• あらゆるHTTPクライアントで動作 — curl、Python、スマートウォッチでもOK。
• セルフホスト可能 — プライベートなトピック用に独自のntfyサーバーを運用するか、無料の公開ntfy.shを利用。

スマホでトピックを購読し、Hermesからそのトピックにメッセージを送信すれば、通知として返信を受け取れます。余計な機能なしのプッシュメッセージです。

クイックスタート：セットアップウィザード

最速の方法はガイド付きセットアップです：

hermes gateway setup

メニューからntfyを選び、トピック名（例：hermes-myname-2026）を入力すれば完了です。ウィザードが設定を~/.hermes/.envに書き込みます。

環境変数による手動設定

ファイルを直接編集したいですか？~/.hermes/.envに以下を追加してください：

NTFY_TOPIC=hermes-myname-2026
NTFY_ALLOWED_USERS=hermes-myname-2026
NTFY_HOME_CHANNEL=hermes-myname-2026

これが最小構成です。各変数の意味は以下の通り：

変数	必須	目的
NTFY_TOPIC	はい	購読するトピック（受信メッセージ用）
NTFY_SERVER_URL	いいえ	デフォルトはhttps://ntfy.sh。プライバシー重視ならセルフホスト先を指定
NTFY_TOKEN	いいえ	認証用のベアラートークン（tk_xyz）またはuser:pass
NTFY_PUBLISH_TOPIC	いいえ	返信用の別トピック（デフォルトはNTFY_TOPIC）
NTFY_MARKDOWN	いいえ	trueにするとX-Markdown: true付きで返信を送信
NTFY_ALLOWED_USERS	推奨	ユーザーIDとして扱うトピック名のカンマ区切りリスト
NTFY_ALLOW_ALL_USERS	いいえ	すべてのパブリッシャーを許可 — プライベートトピックでのみ安全
NTFY_HOME_CHANNEL	いいえ	cron / 通知用のデフォルトトピック
NTFY_HOME_CHANNEL_NAME	いいえ	ホームチャンネルの表示名

アイデンティティモデル：デプロイ前に必読

ntfyの落とし穴はここです：ntfyには本物のユーザーアカウントがありません。メッセージのtitleフィールドはパブリッシャーが制御するため、誰でも偽装できます。そこでHermesは認証にtitleを使用しません。

代わりに、トピック名そのものがアイデンティティです。トピック上のすべてのメッセージは、同じ論理ユーザーからのものとして扱われます。NTFY_ALLOWED_USERSは通常、トピック名そのもの——単一エントリの許可リストです。

セキュリティ上の影響： トピックを知っている人は誰でもあなたのエージェントに話しかけられます。これを本当の信頼境界にするには：

• ntfyをセルフホストし、アクセス制御でトピックをロックダウン。
• 許可されたクライアントのみがパブリッシュまたはサブスクライブ可能に。

日常使いの実用的なヒント

ntfyアプリで整形された返信（太字、リスト、コードブロック）を綺麗に表示したいなら、NTFY_MARKDOWN=trueを設定しましょう。長いエージェント応答がスマホ画面でずっと読みやすくなります。

まとめ

ntfyはHermesに極めてシンプルなプッシュチャンネルを提供します：スマホで購読し、環境変数を3つ設定すれば、すぐに使えます。クラウドアカウントも追加サービスも学習コストも不要です。

最後のヒント： hermes-<あなたの名前>-<年>のようなユニークなトピックから始めましょう——公開サーバー上では実質的に衝突しません。そして、ワークフローに慣れてきたら、ntfyをセルフホストしてアクセス制御を追加し、本当にプライベートなチャンネルを構築しましょう。あなたのエージェントは、もうワンブザーで呼び出せます。