Mailwake

收到第一則通知

這篇教學從已經開啟的哨站管理頁面開始，以“監聽工作信箱的 Clients 資料夾，透過 Bark 提醒”為例。完成後，你能用一封新郵件驗證整條鏈路。

1. 建立管理員

首次開啟時，從 docker compose logs --tail=50 core 找到設定碼，輸入頁面並建立至少 12 個字元的管理員密碼。已經完成初始化時，直接使用管理員密碼登入。

成功標誌：進入設定嚮導或概覽頁。信箱與通知可以分步設定。

2. 新增信箱

開啟「信箱」，點選「新增信箱」，填寫顯示名稱、IMAP 主機、埠、信箱使用者名稱和密碼或應用專用密碼：

  • 顯示名稱：例如“工作信箱”，用於頁面和通知標題。
  • IMAP 主機：從信箱服務商的 IMAP 設定頁面獲取。
  • 埠：通常是 993，使用 TLS。
  • 使用者名稱：通常是完整信箱地址。
  • 密碼：優先使用服務商提供的應用專用密碼或授權碼；163 等信箱使用授權碼。

測試連線並儲存。Gmail 使用 imap.gmail.com 和 993，應用密碼是否可用由帳號及組織策略決定，見 Google 說明。其他信箱以服務商提供的 IMAP 引數為準。

成功標誌：信箱出現在側欄，能夠進入信箱詳情並掃描資料夾。認證失敗時，先確認服務商已開啟 IMAP、使用者名稱完整且授權碼有效。

3. 選擇真正需要提醒的資料夾

在信箱詳情點選「掃描資料夾」→「開始掃描」，勾選需要監聽的資料夾。郵件規則將客戶郵件移動到 Clients 時，就選擇 Clients。

  • 實時：用於需要及時提醒的資料夾。
  • 每 5 分鐘 / 每 15 分鐘：用於收據、訂閱郵件等可以稍後檢視的資料夾。

點選「下一步」，確認後儲存。連線額度條會展示當前佔用；額度不足時，可以將部分資料夾改為定時檢查。

成功標誌：「監聽狀態」顯示選定資料夾正在監聽，並有上次檢查時間。首次訂閱從當前郵件位置建立起點，已有郵件不會一次性補發通知。

4. 設定 Bark 通知

在手機 Bark App 中啟用系統通知權限，並找到推播地址。假設地址是 https://api.day.app/你的设备Key，在哨站 的「通知設定」中選擇 Bark：

  • 「服務地址」填寫 https://api.day.app；自建 Bark 使用自己的 HTTPS 服務地址。
  • 「Bark 裝置 Key」只填寫裝置 Key 部分。
  • 選擇是否顯示郵件主旨。關閉預覽時使用通用的新郵件提示。

儲存後點選「傳送測試通知」，然後檢查手機。

成功標誌：哨站 顯示通知服務已接受測試，手機出現測試通知。哨站 的“已接受”代表服務端接收，手機展示還受系統通知權限、專注模式和通道狀態影響。

使用 Pushover 時填寫應用 Token 與 User Key；使用 Webhook 時填寫 HTTPS 接收地址與簽章金鑰。欄位和簽章規則見通知通道參考。

5. 用一封新郵件驗收

  1. 保持哨站執行，確認 Clients 正在監聽。
  2. 從另一個信箱傳送一封新的測試郵件，讓信箱服務端規則將它送進 Clients。
  3. 在信箱網頁或原來的郵件客戶端確認這封郵件確實位於 Clients。
  4. 在哨站「投遞記錄」找到這封郵件對應的記錄，再檢查手機通知。

成功標誌：手機通知顯示對應信箱和資料夾；開啟主旨預覽時，還能看到測試郵件主旨。閱讀和回覆繼續使用原來的郵件客戶端。

測試請使用新郵件。把接收時間早於 24 小時的舊郵件拖進資料夾會推進進度，但不會生成通知。同一封郵件進入兩個已訂閱資料夾時，可能收到兩條資料夾通知。

6. 按鏈路定位問題

  • 測試通知也收不到：先檢查通道憑據、哨站 到通知服務的網路，以及手機通知權限。
  • 測試通知正常，新郵件沒有記錄：確認訂閱的是規則的目標資料夾，再看監聽狀態與上次檢查時間；定時資料夾等待所選檢查週期。
  • 出現失敗投遞：檢視失敗原因，修正通道設定後手動重試。預設自動重試次數為 0，可在通知設定調整。
  • 信箱需要重新認證：在「信箱設定」更新應用密碼或授權碼。

設定完成後，按備份與恢復教學儲存第一次備份。管理頁面的歷史記錄是通知記錄，郵件原文仍由信箱儲存。

Markdown · AGPL-3.0-only · Mailwake 貢獻者