邮件接收器是什么
邮件接收器（email_configs）配置收件人、发件人与 smarthost（含端口），认证信息建议放在独立文件里而不是写进主配置。587 端口通常走 STARTTLS，465 端口是隐式 TLS，两者配置行为不同。邮件适合做低优先级通知与留档手段：可达性好、便于抄送与归档，但实时性不如电话与即时消息，不适合作为严重故障的唯一通道。
基本信息
| 配置位置 | receivers[].email_configs |
|---|---|
| 关键字段 | to、from、smarthost、auth_username、auth_password_file、require_tls、send_resolved |
| 常见端口 | 25 明文、587 STARTTLS、465 隐式 TLS |
| 适用版本 | Alertmanager 0.2x 及以上 |
| 权限要求 | 发件账号可用且出站端口放通 |
典型使用场景
- 低优先级通知：巡检类与提醒类告警走邮件，避免打扰值班
- 留档抄送：抄送相关方，形成可追溯的书面记录
- 汇总日报：定时汇总告警发送给团队，减少实时打扰
- 兜底通道：作为即时消息之外的补充通道，降低单通道失效风险
- 变更通知：计划变更与维护窗口的提前告知
使用要点
- 密码放在独立文件并限制文件权限，不要写进主配置
- 先与邮件服务商确认可用端口，云主机出站 25 端口常被限制
- 发件域名要做 SPF 与 DKIM，否则邮件容易进垃圾箱
- 主题模板带上状态与告警名，便于邮件客户端自动分类
- 定期用真实邮箱核对投递结果，不能只看发送记录
邮件接收器示例
邮件接收器示例
receivers:
- name: mail-ops
email_configs:
- to: ops@example.com
from: alertmanager@example.com
smarthost: smtp.example.com:587
auth_username: alertmanager@example.com
auth_password_file: /etc/alertmanager/smtp.pass
require_tls: true
send_resolved: true
headers:
Subject: "[{{ .Status | toUpper }}] {{ .CommonLabels.alertname }}"端口与行为
| 端口 | 加密方式 | 注意 |
|---|---|---|
| 25 | 明文或 STARTTLS | 云主机出站常被限制 |
| 587 | STARTTLS | 需配置认证与 TLS 要求 |
| 465 | 隐式 TLS | 部分老式实现不支持 |
| 认证 | 独立密码文件 | 不要写进主配置 |
| 主题模板 | 可自定义 | 带状态与告警名便于分类 |
国内云主机出站 25 端口常被限制，先与邮件服务商确认可用端口再配置，否则会出现连接超时且没有任何投递记录。