ntfy 接入——輕量推播通知

這篇教學教你如何把 Hermes Agent 接到 ntfy——一個像「呼叫器」一樣簡單的訊息服務，讓你可以用手機就能跟 AI 助手聊天，隨時收到它的回覆。

---

ntfy 是什麼？為什麼選它？

想像一下，ntfy 就是一個公共信箱。你給某個信箱起個名字（比如 hermes-myname-2026），手機裝上 ntfy 應用程式並「訂閱」這個信箱，然後任何往這個信箱裡投遞的訊息，你的手機都會立刻收到推播。

對 Hermes 來說，這個信箱就是它的「電話線」：你發訊息到信箱 → Hermes 收到並處理 → 回覆再投回信箱 → 你手機彈出通知。整個過程不需要安裝額外軟體、不需要伺服器常駐，輕量又簡單。

---

第 1 步：準備一個「信箱名」

隨便起一個獨一無二的字串，就像給信箱貼標籤。例如：hermes-myname-2026。

建議起得長一點、難猜一點（比如 hermes-7d4f9c8b-2026），因為知道信箱名的人都能給你的 AI 發訊息，它相當於你的共享密碼。

第 2 步：手機安裝 ntfy 應用程式

• 在應用程式商店搜尋 ntfy 並安裝。
• 開啟應用程式，點 + 號，輸入你選好的信箱名，訂閱它。

第 3 步：設定 Hermes

在伺服器上開啟設定檔 ~/.hermes/.env，加入以下三行：

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

• NTFY_TOPIC：Hermes 要監聽的「信箱」（接收訊息）。
• NTFY_ALLOWED_USERS：身分白名單。ntfy 沒有真正的使用者系統，信箱名本身就是身分，所以這裡填同一個名字即可。
• NTFY_HOME_CHANNEL：預設投遞管道，定時任務的通知也會發到這裡。

儲存後重新啟動閘道器：

hermes gateway restart

第 4 步：開始對話！

在手機 ntfy 應用程式裡，往這個信箱發一則訊息（比如「你好」）。Hermes 會回覆你，手機立刻彈出推播通知——就像跟朋友傳 LINE 一樣。

---

進階玩法

• 定時任務推播：在 Hermes 的定時任務裡指定 deliver="ntfy"，它就會每小時把摘要推到你手機。
• 開啟 Markdown 排版：在 .env 裡加一行 NTFY_MARKDOWN=true，回覆就能顯示粗體、列表、程式碼區塊等格式。
• 只發不收：如果你只想要通知（比如伺服器警報），不想要 AI 回覆，那就不要設定 NTFY_ALLOWED_USERS，這樣訊息就是單向的。

注意幾個「坑」

• 訊息長度：ntfy 單則訊息上限 4096 字元，超過了 Hermes 會自動截斷。
• 沒有「正在輸入」提示：別等它，直接發訊息就行。
• 安全提醒：預設情況下，任何人知道信箱名就能給你的 AI 發指令。想要更安全，可以自建 ntfy 伺服器並開啟存取控制，或者使用 ntfy.sh 的付費保留主題。

遇到問題？

• 401 錯誤：NTFY_TOKEN 填錯了，檢查令牌權限後重新啟動閘道器。
• 404 錯誤：信箱在伺服器上不存在（自建伺服器需手動建立）。
• 能連上但沒反應：檢查 NTFY_ALLOWED_USERS 是否包含信箱名——沒寫白名單 = 拒絕一切訊息。

---

小結

ntfy 接入是 Hermes 最輕量的訊息方案：一個信箱名 + 一個手機 App，就能隨時隨地跟你的 AI 助手對話。它適合快速體驗、個人使用，或者作為定時通知的推播管道。

下篇預告：如果覺得 ntfy 太「輕」，下一篇我們聊聊更強大的 Telegram 接入——支援多媒體、群組聊天、按鈕互動，讓你的 AI 助手擁有完整的「聊天軟體」體驗。敬請期待！

---