# Mailwake 文件

Mailwake 監聽你選定的 IMAP 資料夾，在新郵件到達時傳送通知。哨站是部署在你的伺服器或 NAS 上的 Mailwake 服務，負責信箱監聽與通知投遞；iOS App 提供手機上的通知、閱讀與管理入口。按你的使用方式選擇下面的教學。

## 使用哨站

在伺服器或 NAS 上部署哨站，透過網頁管理信箱，用 Bark、Pushover 或 Webhook 接收通知。哨站網頁控制台和指令碼 API 免費使用，閱讀和回覆繼續使用你習慣的信箱客戶端。

1. [部署哨站](deploy.md)，建立管理員帳號；需要遠端存取時設定 [HTTPS](https.md)。
2. [連線信箱](mailboxes.md)，再[選擇監聽資料夾](folders.md)。
3. [設定通知管道](notifications.md)，傳送一條測試通知。
4. 向資料夾投遞一封**新郵件**，按[第一條通知教學](first-notification.md)檢查完整鏈路。

訂閱時已有的郵件作為初始基線，監聽從此後的新郵件開始。設定完成後，按[備份、恢復與升級](backup.md)儲存資料；自動化接入見 [HTTP API 參考](api.md)。

## 使用 App

將 App 連線到你自己的哨站，或連線站主邀請你使用的哨站。準備好哨站後，從連線教學開始；自行搭建可先閱讀[部署哨站](deploy.md)。

1. [連接 App](connect-app.md)：獲取邀請、掃碼連線並按需授予權限。
2. 按連線教學[開啟原生通知](connect-app.md#開啟原生通知)，選定接收手機、儲存併傳送測試。
3. 閱讀 [App 使用教學](app.md)，檢視通知、閱讀郵件和管理已授權的信箱。

普通原生郵件推播和 App 內的資料夾發現、管理修改需要 Pro。內文閱讀免費，由站主單獨授予內文存取權限。

## 遇到問題

從[排查問題](troubleshooting.md)檢查信箱監聽、通知投遞、App 連線和權限。哨站與 App 的連線狀態、通知目標分別檢查。

## 開源與貢獻

哨站使用 AGPL-3.0-only 許可。[開源倉庫](https://github.com/mingzaily/mailwake)提供原始碼、釋出包和英文貢獻者文件。開發前先讀[貢獻指南](https://github.com/mingzaily/mailwake/blob/main/CONTRIBUTING.md)，實現細節見[技術文件索引](https://github.com/mingzaily/mailwake/blob/main/docs/README.md)。iOS App 與官方服務使用專有許可。

本站提供與官網一致的九種語言完整教學，可透過語言選擇器切換。
