Home Assistant.io与邮件服务集成：发送系统通知与报告

Home Assistant.io与邮件服务集成：发送系统通知与报告

【免费下载链接】home-assistant.io :blue_book: Home Assistant User documentation 项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

你是否还在为错过智能家居系统的重要状态变化而烦恼？是否希望能随时收到家庭安防警报、能源使用报告或设备故障通知？通过Home Assistant.io的邮件服务集成，你可以轻松实现这些需求，让智能家居真正为你"主动发声"。本文将详细介绍如何配置SMTP服务，创建自定义通知，以及实现自动化报告功能，让你在5分钟内完成从配置到接收第一封系统邮件的全过程。

为什么选择邮件通知？

在众多通知方式中，邮件通知具有独特优势：持久存档（便于后续分析）、支持富文本与附件（可包含图片、数据报表）、跨平台同步（手机/电脑/平板均可接收）。特别是在家庭安防场景中，结合摄像头截图的邮件警报能提供直观证据，如Z-Wave Long Range协议下的 mailbox传感器就能通过邮件即时推送信箱开关状态。

快速开始：SMTP服务配置

基础配置步骤

SMTP（Simple Mail Transfer Protocol，简单邮件传输协议）是Home Assistant实现邮件通知的核心。首先需要在configuration.yaml中添加基础配置，官方文档source/_integrations/smtp.markdown提供了完整参数说明：

# 基础SMTP配置示例 [source/_integrations/smtp.markdown]
notify:
  - name: "home_alerts"  # 通知器名称，后续通过notify.home_alerts调用
    platform: smtp
    sender: "home-assistant@example.com"  # 发件人邮箱（必填）
    recipient: "user@example.com"  # 收件人邮箱（必填，支持多邮箱列表）
    server: "smtp.example.com"  # SMTP服务器地址
    port: 587  # 端口（默认587）
    encryption: starttls  # 加密方式：starttls/tls/none（默认starttls）
    username: "your_username"  # SMTP账号
    password: "your_password"  # SMTP密码

⚠️ 安全提示：密码等敏感信息建议使用!secret引用存储在secrets.yaml中的凭证，如2017年6月版本更新中强调的安全最佳实践。

主流邮箱服务商配置示例

不同邮箱服务商的SMTP参数存在差异，以下是经过社区验证的配置模板：

Gmail配置

Gmail需要开启"应用专用密码"（需先启用两步验证），配置示例：

# Gmail配置示例 [source/_integrations/smtp.markdown]
notify:
  - name: "gmail_alerts"
    platform: smtp
    server: "smtp.gmail.com"
    port: 587
    timeout: 15
    sender: "your_account@gmail.com"
    encryption: starttls
    username: "your_account@gmail.com"
    password: "your_app_password"  # 应用专用密码，非普通登录密码
    recipient: ["user1@example.com", "user2@example.com"]  # 多收件人
    sender_name: "Home Assistant"  # 自定义发件人名称

ℹ️ 注意：2022年5月后，Gmail不再支持第三方应用使用普通密码登录，必须使用应用专用密码或OAuth2认证。

其他服务商通用配置

服务商	SMTP服务器	端口	加密方式
Outlook/Hotmail	smtp.office365.com	587	starttls
Yahoo	smtp.mail.yahoo.com	587	starttls
阿里云邮箱	smtp.aliyun.com	465	tls

创建实用的邮件通知自动化

配置完成后，即可通过自动化或脚本触发邮件通知。Home Assistant支持丰富的通知内容定制，包括标题、正文、附件和HTML格式。

基础文本通知

最简单的定时提醒示例，每天早上8点发送问候邮件：

# 定时邮件通知示例 [source/_integrations/smtp.markdown]
- alias: "每日早安提醒"
  trigger:
    platform: time
    at: "08:00:00"
  action:
    service: notify.home_alerts
    data:
      title: "早安！今日家庭报告"
      message: "当前室内温度：{{ states('sensor.temperature') }}°C，湿度：{{ states('sensor.humidity') }}%"

带图片附件的安防警报

当安防系统检测到异常时，自动发送带摄像头截图的邮件：

# 带图片附件的安防警报 [source/_integrations/smtp.markdown]
- alias: "入侵检测邮件警报"
  trigger:
    platform: state
    entity_id: binary_sensor.motion_sensor
    to: "on"
  action:
    - service: shell_command.take_snapshot  # 调用shell命令拍摄截图
    - delay: "00:00:01"  # 等待截图完成
    - service: notify.home_alerts
      data:
        title: "【紧急】检测到异常活动"
        message: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }} 前门将廊检测到运动"
        data:
          images:
            - "/config/www/snapshots/front_door.jpg"  # 本地图片路径

⚠️ 重要：图片路径需添加到allowlist_external_dirs配置项，否则Home Assistant无法访问，详见系统安全配置文档。

HTML格式的能源报告

利用HTML支持创建富文本报告，展示能源使用趋势：

# HTML格式能源报告 [source/_integrations/smtp.markdown]
- alias: "每周能源报告"
  trigger:
    platform: time
    at: "09:00:00"
    weekday:
      - mon
  action:
    service: notify.home_alerts
    data:
      title: "家庭能源周报 {{ now().strftime('%Y-%m-%d') }}"
      message: "本周总用电量：{{ states('sensor.weekly_energy') }} kWh"
      data:
        html: >
          <h2>家庭能源使用报告</h2>
          <p>本周平均用电量：{{ states('sensor.daily_avg_energy') }} kWh/天</p>
          <img src="cid:energy_chart.png" alt="能源趋势图" width="600">
        images:
          - "/config/www/charts/energy_chart.png"  # 图表图片

💡 技巧：通过cid:filename语法可将图片嵌入HTML内容，实现图文混排效果。

高级功能与最佳实践

动态收件人与条件通知

通过target参数可在自动化中动态指定收件人，实现基于场景的灵活通知：

# 动态收件人示例 [source/_integrations/smtp.markdown]
- alias: "离家模式邮件通知"
  trigger:
    platform: state
    entity_id: input_boolean.away_mode
    to: "on"
  action:
    service: notify.home_alerts
    data:
      title: "离家模式已激活"
      message: "系统已启用节能模式，所有非必要设备已关闭"
      target: 
        - "{{ states('input_text.main_email') }}"  # 从输入文本获取主邮箱
        - "{{ states('input_text.spouse_email') if is_state('person.spouse', 'not_home') else '' }}"  # 条件收件人

错误处理与调试

SMTP集成提供了调试功能，开启后可在日志中查看详细通信过程：

# 启用调试模式 [source/_integrations/smtp.markdown]
notify:
  - name: "home_alerts"
    platform: smtp
    # ...其他配置...
    debug: true  # 启用调试日志

常见问题排查：

• 连接超时：检查服务器地址/端口是否正确，网络是否允许出站连接
• 认证失败：验证用户名密码，确认邮箱服务商是否支持SMTP访问
• 附件无法发送：检查文件路径权限和allowlist_external_dirs配置

性能优化建议

• 批处理通知：避免短时间内发送大量邮件，可使用delay和condition控制频率
• 模板复用：将常用HTML模板保存为文件，通过!include引用
• 状态过滤：使用trigger.to_state等条件避免重复通知，如2020年5月版本中优化的状态变化检测逻辑

总结与进阶方向

通过SMTP集成，Home Assistant实现了强大的邮件通知能力，从简单的状态提醒到复杂的报告生成，满足多样化场景需求。随着版本迭代，该集成不断完善，如2021年7月版本新增的动态收件人覆盖功能，以及2023年12月版本中增强的安全检查机制。

进阶探索方向：

1. 与IMAP集成：结合imap_email_content组件实现邮件指令控制
2. 语音通知结合：在邮件通知的同时，通过语音助手播报关键信息
3. 数据可视化：使用Python脚本生成动态图表，嵌入HTML报告

希望本文能帮助你构建更智能的家庭通知系统。如果觉得有用，请收藏本文并关注后续关于高级自动化的教程！

【免费下载链接】home-assistant.io :blue_book: Home Assistant User documentation 项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io