Debian系统中Jenkins如何配置邮件通知

1. 安装Email Extension Plugin插件
登录Jenkins管理界面（通常为http://<服务器IP>:8080），点击左侧Manage Jenkins→Manage Plugins，切换至Available标签页，搜索“Email Extension Plugin”，勾选后点击Install without restart（无需重启即可安装）。

2. 配置全局SMTP邮件设置
进入Manage Jenkins→Configure System，向下滚动找到Extended E-mail Notification部分（部分Jenkins版本可能显示为“Email Extension”），填写以下信息：

SMTP Server：填写SMTP服务器地址（如Gmail为smtp.gmail.com，QQ邮箱为smtp.qq.com，企业邮箱替换为对应SMTP地址）；
SMTP Port：填写SMTP端口（常用587（TLS加密）、465（SSL加密）或25（非加密，部分服务商不支持））；
Use SMTP Authentication：勾选“Enable SMTP Authentication”（启用SMTP认证）；
Username：填写SMTP账号（如个人邮箱地址your-email@example.com）；
Password：填写SMTP授权码（而非邮箱登录密码，如Gmail需前往“设置→安全性→应用专用密码”生成，QQ邮箱需前往“设置→账户→POP3/IMAP/SMTP/SMTPS”开启并获取授权码）；
Default Subject：设置邮件主题模板（可使用变量，如${JOB_NAME} - Build #${BUILD_NUMBER} - ${BUILD_STATUS}，表示项目名称、构建编号、构建状态）；
Default Content Type：选择邮件内容类型（推荐HTML，支持格式化排版）；
Default Content：设置邮件正文模板（支持HTML和变量，如<!DOCTYPE html><html><body><h1>Build Notification</h1>Project: ${JOB_NAME}Build Number: ${BUILD_NUMBER}Status: ${BUILD_STATUS}Details: <a href="${BUILD_URL}">${BUILD_URL}</a></body></html>，包含项目名称、构建编号、状态及日志链接）。
填写完成后，点击Test configuration by sending test e-mail，输入测试邮箱地址（如个人常用邮箱），点击Test发送测试邮件，确认能否正常接收。

3. 配置Job的邮件通知
进入需要配置邮件通知的Jenkins Job，点击Configure进入Job配置页面，向下滚动至Post-build Actions（构建后操作）部分，点击Add post-build action→Editable Email Notification，配置以下内容：

Recipient List：填写邮件接收者地址（多个地址用逗号分隔，如dev1@example.com,dev2@example.com）；
Subject：设置邮件主题（可使用变量，如${JOB_NAME} - Build #${BUILD_NUMBER} - ${BUILD_STATUS} - ${RESULT}，其中${RESULT}表示构建结果（SUCCESS/FAILURE/UNSTABLE等））；
Content：设置邮件正文（支持HTML和变量，如<!DOCTYPE html><html><body><h2>Build Details</h2>Project: ${JOB_NAME}Build Number: ${BUILD_NUMBER}Status: ${BUILD_STATUS}Cause: ${CAUSE}Changes: ${CHANGES_SINCE_LAST_SUCCESS}<a href="${BUILD_URL}console">View Console Output</a></body></html>，包含项目信息、变更记录及日志链接）；
Triggers：点击Advanced Settings→Triggers，配置触发邮件通知的条件（如“Failure”表示构建失败时发送、“Success”表示构建成功时发送、“Unstable”表示构建不稳定时发送、“Always”表示总是发送），可根据需求勾选多个条件；
Content Type：确认内容类型为HTML（确保邮件格式正确）。
配置完成后，点击Save保存Job设置。

4. 测试邮件通知
回到Job配置页面，点击Save后，手动触发一次构建（点击Build Now），等待构建完成后，检查测试邮箱是否收到邮件。若未收到，可检查以下内容：

SMTP服务器设置是否正确（如端口、加密方式）；
SMTP授权码是否有效（部分邮箱需重新生成）；
Jenkins日志是否有错误（查看/var/log/jenkins/jenkins.log，定位具体问题）；
邮箱反垃圾机制是否拦截（可将Jenkins服务器IP加入邮箱白名单）。

最新问答

相关标签