核心用法
smtp-sender 是一个命令行邮件发送工具,通过读取本地 JSON 配置文件实现 SMTP 身份验证。支持纯文本、Markdown(自动转 HTML)及 HTML 三种邮件格式,可附加单个或多个文件。基础调用需指定收件人、主题和正文,通过 --html 标志启用富文本渲染,通过 --attachments 参数绑定本地文件路径。
显著优点
1. 配置复用:单次配置 smtp-config.json 后可多次调用,避免重复输入凭据
2. 格式灵活:内置 Markdown→HTML 转换,降低富文本邮件编写门槛
3. 容错设计:3 次自动重试机制应对临时网络抖动
4. 审计追踪:本地日志记录发送状态与错误详情
潜在局限
- 无交互式配置向导:新手需手动创建 JSON 文件并设置 600 权限
- 无密文存储:密码以明文形式存放于配置文件,依赖文件系统权限保护
- 功能边界:当前版本不支持 CC/BCC、邮件模板及定时发送(规划中)
- 单点依赖:硬编码配置文件路径,多账户切换需手动替换文件
适合人群
- 开发者/运维人员需要将邮件通知集成至脚本或 CI/CD 流水线
- 个人用户希望通过 Markdown 快速编写格式化邮件
- 轻量级场景:自动化报告发送、告警通知、日常通信
常规风险
- 凭据泄露风险:配置文件若权限设置不当(非 600)可能导致密码暴露
- SMTP 滥用:未限制的发送频率可能触发服务商反垃圾机制
- 附件路径注入:需确保
--attachments参数指向预期文件,防止路径遍历 - TLS 配置错误:
useTLS与端口 465/587 不匹配时可能导致连接失败或明文传输