Debian Jenkins邮件怎么配置

在 Debian 上配置 Jenkins 邮件通知，通常分为 系统级邮件配置（Jenkins 管理员邮件） 和 项目级邮件配置（构建结果通知） 两部分。下面以 最常见方案：使用 SMTP（如 QQ、163、Gmail、企业邮箱） 为例说明。

一、前置条件

已安装 Jenkins（Debian）
有可用的 SMTP 邮箱账号（推荐专用邮箱）
已开启 SMTP 服务并获取 授权码（不是登录密码）

二、安装邮件插件（推荐）

登录 Jenkins
系统管理 → 插件管理
安装：
- Email Extension Plugin（强烈推荐）
- Mailer Plugin（默认已装）

三、系统邮件配置（全局）

1. 配置 SMTP

路径：

系统管理 → 系统配置 → 邮件通知（或 Extended E-mail Notification）

2. 以 QQ 邮箱为例

SMTP 服务器

smtp.qq.com

SMTP 端口

465（SSL）或 587（TLS）

使用 SMTP 认证

用户名：123456@qq.com
密码：授权码

使用 SSL

勾选 SSL（465）

系统管理员邮件地址

123456@qq.com

测试

勾选“通过发送测试邮件测试配置”
填写接收邮箱 → Test

✅ 收到邮件即成功

四、使用 Email Extension 插件（更灵活）

1. 全局配置

路径：

系统管理 → 系统配置 → Extended E-mail Notification

示例：

SMTP server：smtp.qq.com
Default user e-mail suffix：@qq.com
SMTP Port：465
勾选 Use SSL
凭据：邮箱 + 授权码

2. 默认邮件内容（可选）

构建项目：$PROJECT_NAME
构建结果：$BUILD_STATUS
构建编号：$BUILD_NUMBER
详情：<a href="$BUILD_URL">$BUILD_URL</a>

五、在 Jenkins 任务中配置邮件

1. 打开 Job 配置

配置 → 构建后操作 → Editable Email Notification

2. 基本设置

Project Recipient List：

user1@qq.com,user2@qq.com

Trigger：
- Always
- Failure
- Success
- Unstable

3. 高级设置（重要）

确保 SMTP 使用全局配置
设置发送人 = 管理员邮箱

六、Debian 本地邮件（可选）

如果你只是想让 Jenkins 发本地邮件（不推荐生产）：

sudo apt install mailutils

配置 /etc/ssmtp/ssmtp.conf 或 postfix

⚠️ 云服务器通常封 25 端口，不推荐

七、常见问题

1. 535 认证失败

用的是登录密码 ❌
应使用 邮箱授权码

2. 连接超时

检查防火墙
云厂商是否放行 465/587

3. 收不到邮件

查看 Jenkins 系统日志
检查垃圾邮件箱

八、示例（163 邮箱）

SMTP: smtp.163.com
端口: 465
用户: xxx@163.com
密码: 授权码

如果你愿意，可以告诉我：

使用的邮箱类型（QQ / 163 / 企业微信 / Gmail）
Jenkins 版本
是否 Docker 安装

我可以直接给你 完整可复制配置。