轻量级自托管邮件管理器,支持多服务商IMAP/SMTP、高级搜索过滤、文件夹管理及附件检测,零外部依赖运行。
说明:
## 核心用法
Portable Email Manager 是一款基于 Node.js 的独立邮件管理工具,通过命令行提供完整的邮件收发与管理功能。核心操作包括:
– **发送邮件**:`./scripts/email.js send `,支持标准 SMTP 发送
– **读取邮件**:`read [数量]` 命令获取近期邮件,含发件人、主题、日期、附件信息及正文预览
– **高级搜索**:支持 `–from`(发件人)、`–subject`(主题关键词)、`–since`/`–before`(日期范围)、`–seen`/`–unseen`(已读状态)、`–body`(正文内容,较慢)等多维度过滤
– **文件夹管理**:`folders` 列出所有 IMAP 文件夹树,`move ` 实现邮件归档与分类
### 显著优点
1. **完全自包含**:依赖仅 nodemailer、imap-simple、mailparser 三个 npm 包,无外部云服务或 API
2. **多服务商兼容**:默认支持 Zoho,通过简单配置即可适配 Gmail、Outlook、iCloud 及任意 IMAP/SMTP 服务器
3. **服务器端过滤**:发件人、主题、日期等搜索由 IMAP 服务器执行,本地仅接收匹配结果,性能高效
4. **隐私优先**:凭证仅通过环境变量传入,不落地存储;全链路 TLS/SSL 加密
### 潜在缺点与局限性
– **正文搜索性能差**:`–body` 需下载邮件内容逐行匹配,大邮箱操作缓慢
– **无图形界面**:纯 CLI 工具,对非技术用户门槛较高
– **附件仅检测不下载**:可显示文件名、MIME 类型、大小,但不提供下载功能
– **单次操作单封移动**:批量归档需脚本循环调用,无原生批量操作
– **无本地缓存**:每次查询重新连接 IMAP,高频使用可能触发服务商限流
### 适合人群
– 隐私敏感、倾向自托管方案的技术用户
– 需自动化邮件处理(筛选、归档、触发工作流)的开发者
– 多邮箱统一管理需求的运维或自由职业者
– 避免使用第三方邮件客户端的开源偏好者
### 常规风险
1. **凭证泄露**:环境变量若被进程导出或日志记录可能暴露;建议配合专用 App Password 而非主密码
2. **误操作数据丢失**:`move` 命令不可逆,错误 UID 或文件夹名将导致邮件位置混乱(虽不会删除)
3. **服务商封禁**:高频 IMAP 连接或大量搜索可能触发 Gmail/Outlook 的安全限制
4. **依赖维护风险**:imap-simple 等包更新缓慢,未来 Node 版本兼容性需关注









