主要功能

• 支持新评论通知，将前台新评论发送到后台配置的收件箱
• 支持后台回复通知，管理员回复后自动通知原评论者
• 支持独立 SMTP 配置，可单独设置 Host、Port(特别是一些idc封禁了常见端口时)、加密方式、用户名、密码或 API Key、发件人信息
• 支持智能 SMTP 默认行为，用户名留空时默认跟随发件人邮箱，Resend 主机可自动使用 resend
• 支持测试发送，可直接基于当前表单配置测试发信链路
• 支持错误诊断，失败时可返回认证失败、超时、TLS/SSL、连接失败、主机策略拦截、频率限制等提示
• 支持邮件日志，记录 comment、reply、test 三类事件，并区分 success、failed、blocked 状态
• 支持日志筛选、分页、详情查看，以及清理成功日志或全部日志
• 支持日志脱敏，自动隐藏邮箱、SMTP 用户名、发件人信息和密码/API Key 等敏感内容
• 支持三套邮件模板：Classic Notice、Modern Brand、Editorial Clean
• 支持品牌主色设置，让评论通知邮件更贴合站点视觉风格
• 支持 SMTP 安全策略，默认仅允许公网主机，并可通过 trusted_smtp_hosts allowlist 显式放行域名、IP 或 CIDR
• 支持新评论“仅审核通过后发送”策略
• 支持发送频率限制，结合 IP、UA、Session 等维度降低滥发风险
• 支持评论通知去重，避免评论保存与审核发布阶段重复发信
• 支持中英文后台与邮件文案显示

设置入口

插件启用后，可在 Emlog 后台插件管理中进入 Comment Mail 设置页进行配置。

• 后台入口：插件 > 评论邮件通知

提醒：启用本插件后，建议先关闭 Emlog 系统原有的评论通知，避免重复发送邮件。

配置概览

插件后台按模块划分配置区域，便于快速检查当前状态。

• 配置概览
• 通知策略
• 邮件模板
• SMTP 配置
• 安全与策略
• 当前配置摘要
• 测试发送
• 邮件日志

通知策略

插件支持两条核心通知链路：

• 新评论通知：前台有新评论时，发送到后台配置的收件箱
• 回复通知：管理员在后台回复评论后，发送给原评论者邮箱

同时支持“仅审核通过后发送新评论通知”，适合开启评论审核的站点。

SMTP 配置

Comment Mail 支持完整的独立 SMTP 配置，适合对默认邮件能力不满意、或需要接入第三方邮件服务的站点。

可配置内容包括：

• SMTP Host
• SMTP Port
• Encryption
• SMTP Username
• Password / API Key
• Sender Email
• Sender Name

插件支持 auto 加密识别，可按端口自动匹配 SMTPS / STARTTLS，降低配置门槛。

测试发送与错误诊断

插件提供测试发送功能，可直接使用当前表单中的 SMTP 参数进行测试，不必先保存配置，更适合边调边试。

当测试失败时，可辅助定位以下常见问题：

• SMTP 用户名或密码/API Key 错误
• 端口与加密方式不匹配
• DNS 无法解析 SMTP 主机
• 服务器无法连接目标 SMTP
• SMTP 主机被安全策略拦截
• 当前请求触发发送频率限制

邮件模板

插件内置三套邮件模板，评论通知与回复通知共用同一套模板风格：

• Classic Notice：稳重通用，兼容优先
• Modern Brand：更偏产品通知风格，品牌感更强
• Editorial Clean：更适合博客与内容站，强调阅读体验

此外还支持品牌主色设置，让通知邮件风格与站点整体视觉保持一致。

邮件日志

插件会记录邮件发送日志，便于站长在生产环境中排查问题和回看发送状态。

日志能力包括：

• 查看发送总量、成功数、失败数、拦截数
• 按事件类型筛选 comment / reply / test
• 按状态筛选 success / failed / blocked
• 查看单条日志详情，包括时间、耗时、SMTP 主机、端口、模板、收件人掩码、错误码、诊断信息与排查建议
• 清理成功日志或全部日志

安全与策略

Comment Mail 在邮件发送之外，还补充了适合线上站点使用的安全控制：

• 默认拦截内网、回环、链路本地、保留地址等非公网 SMTP 目标
• 通过 trusted_smtp_hosts allowlist 放行明确可信的域名、IP 或 CIDR
• 对发送行为做频率限制，降低滥发与资源消耗风险
• 对日志中的敏感字段做脱敏处理，减少信息泄露风险

适用场景

个人博客

有新评论时及时收到提醒，方便站长快速参与互动。

内容站

后台统一处理评论，并在回复后自动通知用户，提升互动效率。

品牌官网 / 工作室站点

通过独立 SMTP、模板风格和品牌主色，发送更专业的评论通知邮件。

私有部署环境

可通过 allowlist 精细控制内部 SMTP 的使用范围。

推荐使用流程

1. 安装并启用插件
2. 关闭系统原有评论通知，避免重复发信
3. 配置独立 SMTP 参数
4. 使用测试发送验证发信链路
5. 设置模板风格与品牌主色
6. 根据站点需要调整审核发送与频率限制策略
7. 上线后结合邮件日志持续观察发送状态