WHC系列：Mailman --- 自托管智能邮件管理系统

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.mailman


## 🎯 What —— 这是什么？
- 🏷️ **一句话定位**：自托管智能邮件管理系统。
- 🚀 **核心优势**  
  - ⚡ 触发器自动化：实时同步多账户，智能解析与规则触发。  
  - 🔒 多协议安全：OAuth2认证、数据加密，支持Gmail/Outlook/IMAP。
- 📊 **适用场景**：个人/小团队自建私有邮件中心、自动化处理高频邮件。


> 注意：
    - 对于 Gmail 和 Outlook（Exchange Online）：基础认证在大多数场景已被关闭或不可用；必须使用 OAuth2（页面已给出回调地址与配置步骤）。
    - 对于 通用 IMAP/SMTP 或自建邮箱：如果你的服务器仍允许基础认证，Mailman 可按“通用 IMAP/SMTP”方式使用账号密码；但建议使用“应用专用密码”或尽量迁移到更安全的现代认证。
    - 安全与合规层面：OAuth2 提供细粒度授权、令牌可撤销、权限最小化、配合 2FA/MFA 与审计，更符合企业与云服务的默认安全策略。

## 🛠️ How —— 怎么用？
1. 打开应用，首次登录的用户将自动注册为管理员
![file-20251128164451467.png](https://dl.playground.lazycat.cloud/guidelines/402/e2c09088-14eb-4d05-bc11-eafab2a2fa5c.png "file-20251128164451467.png")
2. 点击左侧**OAuth2配置**，进行相关配置，点击**添加配置**
![CleanShot 2025-12-07 at 20.59.57.png](https://dl.playground.lazycat.cloud/guidelines/402/8984a71d-a17b-4540-a46c-0ba8b6554476.png "CleanShot 2025-12-07 at 20.59.57.png")
3. 这里我们已Gmail为示例，首先转到 [Google 云控制台](https://console.cloud.google.com/)，点击创建新项目，项目名称可写**gamilcleaner**，点击**创建**，项目名称可填写**Mailman**
![CleanShot 2025-12-07 at 21.03.04.png](https://dl.playground.lazycat.cloud/guidelines/402/1e74a7d9-4372-4a6e-a820-ff772ca03745.png "CleanShot 2025-12-07 at 21.03.04.png")
4. 创建成功后，进入该项目，点击左侧**API和服务**，点击**已启用的API和服务**
![CleanShot 2025-12-07 at 21.04.40.png](https://dl.playground.lazycat.cloud/guidelines/402/5b0351a5-f2eb-426a-b1c1-7f6dae86de74.png "CleanShot 2025-12-07 at 21.04.40.png")
5. 对话框里搜索**gmail api**，选择第一个
![CleanShot 2025-12-07 at 21.05.21.png](https://dl.playground.lazycat.cloud/guidelines/402/bba55123-206b-40ab-ae23-7b3917690c63.png "CleanShot 2025-12-07 at 21.05.21.png")
6. 对应点击**启用**
![CleanShot 2025-12-06 at 22.28.46.png](https://dl.playground.lazycat.cloud/guidelines/402/8abdd9e2-b4f1-4b8b-b4d8-14a95a648b2e.png "CleanShot 2025-12-06 at 22.28.46.png")
7. 跳转后，在左侧导航菜单里找到**API和服务**，点击**OAuth 权限请求页面**。
![CleanShot 2025-12-06 at 22.30.09.png](https://dl.playground.lazycat.cloud/guidelines/402/b5c36db3-f15d-477d-9cb2-738b5a0b76b3.png "CleanShot 2025-12-06 at 22.30.09.png")
8. 跳转后，点击中间的**开始**
![CleanShot 2025-12-06 at 22.32.17 1.png](https://dl.playground.lazycat.cloud/guidelines/402/35d3508a-1971-41d9-93c0-ca5e5a45b343.png "CleanShot 2025-12-06 at 22.32.17 1.png")
9. **应用名称**可写**Mailman**，用户支持邮箱选择自己的gmail邮箱，点击**下一步**
![CleanShot 2025-12-07 at 21.07.15.png](https://dl.playground.lazycat.cloud/guidelines/402/b5315f42-8ca9-434b-8556-ed65b4a6ad64.png "CleanShot 2025-12-07 at 21.07.15.png")
10. **受众群体**选择**外部**，点击**下一步**
![CleanShot 2025-12-07 at 21.08.16.png](https://dl.playground.lazycat.cloud/guidelines/402/7eb66011-5d7b-4a9d-9d20-118b87bbb500.png "CleanShot 2025-12-07 at 21.08.16.png")
11. **联系信息**还是填写你上面的gmail邮箱，点击**下一步**
![CleanShot 2025-12-06 at 22.42.15.png](https://dl.playground.lazycat.cloud/guidelines/402/8fc6451b-e038-43e5-af98-86cca21b127d.png "CleanShot 2025-12-06 at 22.42.15.png")
12. 完成里方框内☑️，点击**创建**
![CleanShot 2025-12-06 at 22.43.01.png](https://dl.playground.lazycat.cloud/guidelines/402/13fc9424-2f71-4f25-8350-a2c2baa30822.png "CleanShot 2025-12-06 at 22.43.01.png")
13. 点击左侧**目标对象**，点击测试用户下的**Add user**，再右侧填写自己上面的gmail邮箱，点击**保存**
![CleanShot 2025-12-06 at 22.44.23.png](https://dl.playground.lazycat.cloud/guidelines/402/2e1242b5-dd57-418f-8e6f-b5c2b3226339.png "CleanShot 2025-12-06 at 22.44.23.png")
14. 点击左侧**客户端**，点击**创建客户端**
![CleanShot 2025-12-06 at 22.47.02 1.png](https://dl.playground.lazycat.cloud/guidelines/402/5e3ad007-2888-43b0-a7cf-376e4839e2df.png "CleanShot 2025-12-06 at 22.47.02 1.png")
15. 应用类型选择**Web应用**，名称可写**Gmail Cleaner**，已获授权的重定向URI写入** https://gmail-cleaner.你的盒子名.heiyu.space/api/oauth2/callback/gmail ** ，点击创建
![CleanShot 2025-12-07 at 21.10.23.png](https://dl.playground.lazycat.cloud/guidelines/402/592f8730-4119-4832-9c21-ac10b41514cd.png "CleanShot 2025-12-07 at 21.10.23.png")
16. 创建之后，建议直接下载JSON文件，或者也可以复制**客户端ID**和**客户端密钥**
![CleanShot 2025-12-07 at 21.12.08.png](https://dl.playground.lazycat.cloud/guidelines/402/c9d79a19-c839-4eba-b169-01ed29ffe2a9.png "CleanShot 2025-12-07 at 21.12.08.png")
17. 回到应用里，添加配置，建议直接选择**导入JSON**，把刚才下载的JSON文件内容粘贴进去，它会自动识别，然后点击**创建配置**
![CleanShot 2025-12-07 at 21.20.09.png](https://dl.playground.lazycat.cloud/guidelines/402/b640db37-f44c-4f53-8152-1ec63fa19a47.png "CleanShot 2025-12-07 at 21.20.09.png")
18. 创建之后不用管，点击左侧**邮箱账户管理**，点击右侧**添加账户**，选择**快送添加 Gmail**，接着会跳出一个授权窗口，选择你上面添加的gmail邮箱，一路继续下去授权即可。获取到信息之后，就点击**添加账户**
![CleanShot 2025-12-07 at 21.27.53.png](https://dl.playground.lazycat.cloud/guidelines/402/0f6da44b-5580-4479-9c3f-844bec0893e5.png "CleanShot 2025-12-07 at 21.27.53.png")
注意：如果授权不成功，请确保你的小猫咪或者小猪佩奇已打开，然后点击上图里**使用代理**，再点击一下**获取Gmail授权**即可。
19. 然后点击左侧**邮件管理**，选择添加的邮箱，点击一下**同步**即可。
![CleanShot 2025-12-07 at 21.28.33 1.png](https://dl.playground.lazycat.cloud/guidelines/402/a902239f-b51c-4f72-a9a2-82889977fde9.png "CleanShot 2025-12-07 at 21.28.33 1.png")

至此，你的Gmail邮箱就配置完成了。其他邮箱，如Outlook等配置，也可以在**OAuth2配置**页面里，点击**配置指南**查看操作。
![CleanShot 2025-12-07 at 21.37.46.png](https://dl.playground.lazycat.cloud/guidelines/402/cde5975c-79de-447e-9e81-58621540c6c7.png "CleanShot 2025-12-07 at 21.37.46.png")

## 🧩 Conclusion —— 一句话总结
Mailman适合隐私敏感开发者与小团队构建智能私有邮箱，而非追求开箱即用的大规模企业用户。