IMAP Email Reader

📧 IMAP 邮件自动化管家

通过 IMAP 协议管理邮件,支持 ProtonMail Bridge、Gmail 等主流服务,实现自动化邮件检查、搜索、读取与状态标记,适合构建个人邮件工作流。

收藏
25.7k
安装
5.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

IMAP Email Reader 是一个基于 Node.js 的邮件管理工具,通过标准 IMAP 协议与邮件服务器通信,支持多种主流邮箱服务(ProtonMail via Bridge、Gmail、企业邮箱等)。核心功能包括:检查未读邮件、按条件搜索、获取完整邮件内容、标记已读/未读状态,以及列出邮箱文件夹。

显著优势

协议通用性强:不依赖特定服务商 API,任何支持 IMAP 的邮箱均可接入,避免 OAuth 繁琐授权流程。对隐私优先用户友好,特别支持 ProtonMail Bridge 本地代理模式。

命令行友好:纯 CLI 设计,输出结构化 JSON,便于脚本集成和自动化流程。配合 cron 可实现定时邮件摘要、重要邮件提醒等场景。

搜索能力完善:支持按发件人、主题、时间范围、阅读状态等多维度过滤,时间语法简洁(30m/2h/7d)。

安全隔离设计:凭证通过环境变量或 .env 文件管理,与代码分离;ProtonMail Bridge 模式下,真实账户密码永不暴露给第三方工具。

局限与风险

配置门槛较高:需手动设置 IMAP 服务器参数(host/port/TLS),普通用户可能混淆 SSL/TLS/STARTTLS 区别。Gmail 需开启"不够安全的应用访问"或使用应用专用密码。

依赖外部 Bridge:ProtonMail 用户必须保持 Bridge 桌面应用常驻运行,无法在纯服务器环境使用。

功能边界明确:仅支持读取和基础标记操作,无法发送邮件、管理标签/文件夹、处理附件下载后的复杂操作。

TLS 配置陷阱REJECT_UNAUTHORIZED=false 虽为自签名证书所需,但若误用于公网服务器将禁用证书验证,存在中间人攻击风险。

适用人群

  • 技术用户、开发者,需将邮件检查集成到自动化工作流
  • ProtonMail 重度用户,希望脚本化本地邮件访问
  • 隐私敏感者,倾向 IMAP 而非云端 API 授权模式
  • 需要邮件摘要、定时提醒等轻度自动化场景

安全建议

1. 严格区分 IMAP_PASS 与账户主密码,启用邮箱提供的应用专用密码功能
2. ProtonMail Bridge 密码为一次性生成,妥善保管不泄露

3. 生产环境避免设置 REJECT_UNAUTHORIZED=false,确需使用时应限定在本地回环地址

4. .env 文件加入 .gitignore,考虑使用密钥管理服务替代明文存储

IMAP Email Reader 内容

scripts文件夹
手动下载zip · 8.3 kB
imap.jstext/javascript
请选择文件