在 Ubuntu 上配置 Jenkins 邮件通知
一 准备与前提
- 安装并运行 Jenkins（Ubuntu 上常见方式为系统服务或容器部署），确保能访问 Jenkins Web 管理界面。
- 准备发件邮箱并开启 SMTP 服务，获取用于登录的授权码（常见如 QQ 邮箱 16 位授权码；公司邮箱请咨询管理员）。
- 常见邮箱的 SMTP 端口与加密：SSL 使用 465，STARTTLS/TLS 使用 587；部分环境也使用 25（常被运营商限制）。如用 QQ 邮箱，推荐 smtp.qq.com:465/SSL。
二 全局系统设置
- 设置发件人地址：进入 Manage Jenkins → Configure System → Jenkins Location，填写 System Admin e-mail address（需与后续发件邮箱一致）。
- 配置内置邮件（Mailer Plugin）：在 E-mail Notification 填写 SMTP server，勾选 Use SMTP Authentication，输入邮箱与授权码（非登录密码）；按需勾选 Use SSL 并设置端口（SSL 常用 465），或使用 587/TLS。点击 Test configuration by sending test e-mail 发送测试邮件验证。
- 配置扩展邮件（Email Extension Plugin）：在 Extended E-mail Notification 填写相同的 SMTP 参数；建议开启 Enable Debug Mode 以便排错。该插件支持更灵活的收件人、主题、内容与触发条件。
三 在任务中启用邮件通知
- 进入项目的 配置 → 构建后操作：
- 使用内置方式：选择 E-mail Notification，在 Recipients 填写收件人（多个用英文逗号分隔）。该方式常用于构建失败时通知。
- 使用扩展方式：选择 Editable Email Notification，在 Project Recipient List 填写收件人；可在 Advanced Settings → Triggers 中添加触发条件（如 Always、Failure、Unstable 等），并可配置主题、内容、附件（如构建日志）。
四 常见邮箱示例与排错要点
- QQ 邮箱示例
- 开启 POP3/SMTP，获取 16 位授权码；SMTP 服务器：smtp.qq.com。
- 端口与加密：推荐 465/SSL 或 587/STARTTLS；用户名填完整邮箱（如 123456@qq.com），密码填授权码。
- 故障排查
- 未设置 System Admin e-mail address 可能导致连接或发送异常。
- 测试失败优先检查：SMTP 地址、端口、加密方式、授权码是否正确、网络与防火墙策略（云服务器需放行 465/587）。
- 开启 Email Extension 的调试日志，查看具体报错；必要时更换端口或加密方式重试。