# 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 与官方服务使用专有许可。

本站提供与官网一致的九种语言完整教程，可通过语言选择器切换。