零基础实战用163邮箱配置DolphinScheduler邮件告警全流程解析刚接触DolphinScheduler的开发者常会遇到一个棘手问题如何让系统在任务失败时自动发送邮件通知邮件告警功能看似简单但实际配置过程中授权码获取、SMTP设置等环节往往暗藏玄机。本文将用最直观的方式带你一步步完成163邮箱与DolphinScheduler的告警集成特别针对那些容易出错的细节提供避坑指南。1. 163邮箱服务端配置邮件告警功能的核心在于邮箱服务器的正确配置。不同于普通登录程序调用邮箱服务需要特殊授权。以163邮箱为例我们需要先开启SMTP服务并获取专用授权码。1.1 开启SMTP服务首先登录163邮箱网页版点击右上角设置图标选择POP3/SMTP/IMAP选项。这里需要特别注意勾选开启POP3服务和开启SMTP服务两个选项部分新注册邮箱可能需要先设置客户端专用密码才能看到这些选项开启服务后建议同时启用SMTP服务需要身份验证选项提升安全性1.2 获取授权密码在同一个设置页面找到授权密码管理区域点击新增授权密码。系统会要求验证身份通常通过短信验证码完成。验证通过后为这个授权密码设置一个易识别的名称如DolphinScheduler_Alert点击生成密码按钮获取16位随机字符串立即复制保存这个密码到安全位置关键提示163邮箱的授权密码生成后仅显示一次关闭页面后将无法再次查看。如果丢失必须重新生成新密码并更新所有使用该密码的应用配置。1.3 记录SMTP服务器信息在设置页面底部可以找到服务器地址信息服务类型服务器地址端口号SMTPsmtp.163.com25或465IMAPimap.163.com143POP3pop.163.com110邮件告警主要使用SMTP服务标准端口25或加密端口465均可。考虑到安全性建议优先选择465端口配合SSL加密。2. DolphinScheduler告警实例配置完成邮箱服务端准备后我们需要在DolphinScheduler中创建对应的告警实例。登录系统后按以下步骤操作2.1 创建Email告警实例导航至安全中心→告警实例管理点击创建告警实例按钮在弹出窗口中选择Email类型2.2 填写SMTP连接参数在实例创建表单中需要准确填写以下关键字段收件人告警邮件的主要接收邮箱多个地址用逗号分隔抄送人可选字段用于设置需要知悉告警的次要联系人邮件服务器主机输入smtp.163.com邮件服务器端口根据之前选择填写25或465发件人必须与获取授权码的163邮箱地址完全一致是否开启认证选择是用户名称自定义一个易识别的实例名称密码粘贴之前保存的16位授权密码# 示例配置参数 mail.server.hostsmtp.163.com mail.server.port465 mail.senderyourname163.com mail.useryourname163.com mail.passwdAB12CD34EF56GH78 mail.smtp.authtrue mail.smtp.starttls.enablefalse mail.smtp.ssl.enabletrue2.3 高级参数设置在表单底部还有一些可选的高级配置STARTTLS使用25端口时可考虑开启实现加密升级SSL使用465端口时必须开启SSL证书信任测试环境可设为是生产环境建议严格验证内容类型选择HTML可支持更丰富的告警内容格式配置完成后点击测试连接验证参数是否正确。如果收到测试邮件说明配置成功。3. 告警组管理与应用单个告警实例可以服务于多个告警组实现不同场景的分级通知。3.1 创建告警组进入安全中心→告警组管理点击创建告警组按钮输入组名称和描述信息在告警实例选项中添加刚创建的Email实例设置告警级别如P0、P1等和通知策略3.2 工作流关联告警在创建工作流定义时可以在高级设置中找到告警配置选项失败策略选择任务失败时是否触发告警告警组绑定之前创建的告警组告警时机可设置为任务失败或任务成功失败{ alertGroup: DS_Production_Alert, alertTypes: [EMAIL], alertThreshold: FAILURE, alertReceivers: [primarydomain.com, secondarydomain.com] }3.3 告警模板定制DolphinScheduler支持自定义邮件内容模板。在资源中心上传HTML文件然后在告警实例配置中引用。典型告警邮件应包含任务名称和ID工作流执行时间失败原因摘要相关日志片段负责人联系方式系统运维团队签名4. 常见问题排查即使按照步骤操作实际部署中仍可能遇到各种问题。以下是几个典型场景的解决方案4.1 授权密码失效症状测试连接失败日志显示535 Error: authentication failed可能原因授权密码输入错误注意区分大小写密码被重置后未更新配置邮箱账户开启了二次验证但未在客户端配置解决方法重新生成授权密码并更新配置检查邮箱安全设置中是否限制了第三方应用登录确认发件人地址与授权邮箱完全一致4.2 连接超时症状连接测试长时间无响应最终报超时错误可能原因服务器地址或端口填写错误网络防火墙阻止了SMTP连接邮箱服务商限制了客户端IP解决方法# 测试网络连通性 telnet smtp.163.com 465 # 如果失败尝试更换端口 telnet smtp.163.com 25 # 检查本地防火墙规则 iptables -L -n | grep 4654.3 邮件被识别为垃圾邮件症状收件箱无法找到告警邮件可能在垃圾邮件文件夹优化建议在发件人邮箱设置SPF记录避免使用过于简单的邮件内容为告警邮件添加合适的主题前缀如[DS-Alert]联系收件方邮件管理员将发件地址加入白名单4.4 性能优化建议当告警量较大时可考虑以下调整配置邮件发送线程池参数启用邮件队列缓存避免瞬时高峰对非紧急告警采用摘要发送模式设置告警级别分流如P0级立即发送P1级每小时汇总!-- dolphinscheduler-alert-server配置示例 -- property namealert.mail.smtp.connection.timeout/name value30000/value /property property namealert.mail.smtp.thread.count/name value5/value /property
保姆级教程：手把手教你用163邮箱搞定海豚调度DolphinScheduler的邮件告警（含授权码避坑指南）
发布时间：2026/6/3 14:55:15
零基础实战用163邮箱配置DolphinScheduler邮件告警全流程解析刚接触DolphinScheduler的开发者常会遇到一个棘手问题如何让系统在任务失败时自动发送邮件通知邮件告警功能看似简单但实际配置过程中授权码获取、SMTP设置等环节往往暗藏玄机。本文将用最直观的方式带你一步步完成163邮箱与DolphinScheduler的告警集成特别针对那些容易出错的细节提供避坑指南。1. 163邮箱服务端配置邮件告警功能的核心在于邮箱服务器的正确配置。不同于普通登录程序调用邮箱服务需要特殊授权。以163邮箱为例我们需要先开启SMTP服务并获取专用授权码。1.1 开启SMTP服务首先登录163邮箱网页版点击右上角设置图标选择POP3/SMTP/IMAP选项。这里需要特别注意勾选开启POP3服务和开启SMTP服务两个选项部分新注册邮箱可能需要先设置客户端专用密码才能看到这些选项开启服务后建议同时启用SMTP服务需要身份验证选项提升安全性1.2 获取授权密码在同一个设置页面找到授权密码管理区域点击新增授权密码。系统会要求验证身份通常通过短信验证码完成。验证通过后为这个授权密码设置一个易识别的名称如DolphinScheduler_Alert点击生成密码按钮获取16位随机字符串立即复制保存这个密码到安全位置关键提示163邮箱的授权密码生成后仅显示一次关闭页面后将无法再次查看。如果丢失必须重新生成新密码并更新所有使用该密码的应用配置。1.3 记录SMTP服务器信息在设置页面底部可以找到服务器地址信息服务类型服务器地址端口号SMTPsmtp.163.com25或465IMAPimap.163.com143POP3pop.163.com110邮件告警主要使用SMTP服务标准端口25或加密端口465均可。考虑到安全性建议优先选择465端口配合SSL加密。2. DolphinScheduler告警实例配置完成邮箱服务端准备后我们需要在DolphinScheduler中创建对应的告警实例。登录系统后按以下步骤操作2.1 创建Email告警实例导航至安全中心→告警实例管理点击创建告警实例按钮在弹出窗口中选择Email类型2.2 填写SMTP连接参数在实例创建表单中需要准确填写以下关键字段收件人告警邮件的主要接收邮箱多个地址用逗号分隔抄送人可选字段用于设置需要知悉告警的次要联系人邮件服务器主机输入smtp.163.com邮件服务器端口根据之前选择填写25或465发件人必须与获取授权码的163邮箱地址完全一致是否开启认证选择是用户名称自定义一个易识别的实例名称密码粘贴之前保存的16位授权密码# 示例配置参数 mail.server.hostsmtp.163.com mail.server.port465 mail.senderyourname163.com mail.useryourname163.com mail.passwdAB12CD34EF56GH78 mail.smtp.authtrue mail.smtp.starttls.enablefalse mail.smtp.ssl.enabletrue2.3 高级参数设置在表单底部还有一些可选的高级配置STARTTLS使用25端口时可考虑开启实现加密升级SSL使用465端口时必须开启SSL证书信任测试环境可设为是生产环境建议严格验证内容类型选择HTML可支持更丰富的告警内容格式配置完成后点击测试连接验证参数是否正确。如果收到测试邮件说明配置成功。3. 告警组管理与应用单个告警实例可以服务于多个告警组实现不同场景的分级通知。3.1 创建告警组进入安全中心→告警组管理点击创建告警组按钮输入组名称和描述信息在告警实例选项中添加刚创建的Email实例设置告警级别如P0、P1等和通知策略3.2 工作流关联告警在创建工作流定义时可以在高级设置中找到告警配置选项失败策略选择任务失败时是否触发告警告警组绑定之前创建的告警组告警时机可设置为任务失败或任务成功失败{ alertGroup: DS_Production_Alert, alertTypes: [EMAIL], alertThreshold: FAILURE, alertReceivers: [primarydomain.com, secondarydomain.com] }3.3 告警模板定制DolphinScheduler支持自定义邮件内容模板。在资源中心上传HTML文件然后在告警实例配置中引用。典型告警邮件应包含任务名称和ID工作流执行时间失败原因摘要相关日志片段负责人联系方式系统运维团队签名4. 常见问题排查即使按照步骤操作实际部署中仍可能遇到各种问题。以下是几个典型场景的解决方案4.1 授权密码失效症状测试连接失败日志显示535 Error: authentication failed可能原因授权密码输入错误注意区分大小写密码被重置后未更新配置邮箱账户开启了二次验证但未在客户端配置解决方法重新生成授权密码并更新配置检查邮箱安全设置中是否限制了第三方应用登录确认发件人地址与授权邮箱完全一致4.2 连接超时症状连接测试长时间无响应最终报超时错误可能原因服务器地址或端口填写错误网络防火墙阻止了SMTP连接邮箱服务商限制了客户端IP解决方法# 测试网络连通性 telnet smtp.163.com 465 # 如果失败尝试更换端口 telnet smtp.163.com 25 # 检查本地防火墙规则 iptables -L -n | grep 4654.3 邮件被识别为垃圾邮件症状收件箱无法找到告警邮件可能在垃圾邮件文件夹优化建议在发件人邮箱设置SPF记录避免使用过于简单的邮件内容为告警邮件添加合适的主题前缀如[DS-Alert]联系收件方邮件管理员将发件地址加入白名单4.4 性能优化建议当告警量较大时可考虑以下调整配置邮件发送线程池参数启用邮件队列缓存避免瞬时高峰对非紧急告警采用摘要发送模式设置告警级别分流如P0级立即发送P1级每小时汇总!-- dolphinscheduler-alert-server配置示例 -- property namealert.mail.smtp.connection.timeout/name value30000/value /property property namealert.mail.smtp.thread.count/name value5/value /property
