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

🎯 What —— 这是什么？

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

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

🛠️ How —— 怎么用？

1. 打开应用，首次登录的用户将自动注册为管理员
   
2. 点击左侧OAuth2配置，进行相关配置，点击添加配置
   
3. 这里我们已Gmail为示例，首先转到 Google 云控制台，点击创建新项目，项目名称可写gamilcleaner，点击创建，项目名称可填写Mailman
   
4. 创建成功后，进入该项目，点击左侧API和服务，点击已启用的API和服务
   
5. 对话框里搜索gmail api，选择第一个
   
6. 对应点击启用
   
7. 跳转后，在左侧导航菜单里找到API和服务，点击OAuth 权限请求页面。
   
8. 跳转后，点击中间的开始
   
9. 应用名称可写Mailman，用户支持邮箱选择自己的gmail邮箱，点击下一步
   
10. 受众群体选择外部，点击下一步
    
11. 联系信息还是填写你上面的gmail邮箱，点击下一步
    
12. 完成里方框内☑️，点击创建
    
13. 点击左侧目标对象，点击测试用户下的Add user，再右侧填写自己上面的gmail邮箱，点击保存
    
14. 点击左侧客户端，点击创建客户端
    
15. 应用类型选择Web应用，名称可写Gmail Cleaner，已获授权的重定向URI写入** https://gmail-cleaner.你的盒子名.heiyu.space/api/oauth2/callback/gmail ** ，点击创建
    
16. 创建之后，建议直接下载JSON文件，或者也可以复制客户端ID和客户端密钥
    
17. 回到应用里，添加配置，建议直接选择导入JSON，把刚才下载的JSON文件内容粘贴进去，它会自动识别，然后点击创建配置
    
18. 创建之后不用管，点击左侧邮箱账户管理，点击右侧添加账户，选择快送添加 Gmail，接着会跳出一个授权窗口，选择你上面添加的gmail邮箱，一路继续下去授权即可。获取到信息之后，就点击添加账户
    
    注意：如果授权不成功，请确保你的小猫咪或者小猪佩奇已打开，然后点击上图里使用代理，再点击一下获取Gmail授权即可。
19. 然后点击左侧邮件管理，选择添加的邮箱，点击一下同步即可。
    

至此，你的Gmail邮箱就配置完成了。其他邮箱，如Outlook等配置，也可以在OAuth2配置页面里，点击配置指南查看操作。

🧩 Conclusion —— 一句话总结

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