hedgiemate/notifier

HedgieMate Notifier

HedgieMate Notifier是一个轻量级Go sidecar工具，用于监控TeslaMate的MQTT主题，并将车辆状态变化事件发送到HedgieMate中继服务器，从而向iOS设备推送通知。该工具设计用于与TeslaMate Docker栈协同运行。

工作原理

1. 连接到TeslaMate的MQTT broker
2. 监控车辆状态主题（驾驶、充电、电池、地理围栏等）
3. 检测状态转换（如充电开始、驾驶结束）
4. 将事件发送到HedgieMate中继服务器，由其向iOS设备推送通知

前置条件

• 运行中的TeslaMate实例及MQTT broker（如Mosquitto）
• HedgieMate用户令牌（在HedgieMate iOS应用的设置>推送通知中生成）

快速开始

Docker Compose（推荐）

将notifier添加到现有TeslaMate的docker-compose.yml中：

yaml
services:
  hedgiemate-notifier:
    image: docker.xuanyuan.run/hedgiemate/notifier:latest
    restart: unless-stopped
    depends_on:
      - mosquitto
    environment:
      HEDGIEMATE_USER_TOKEN: "hm_your_token_here"
      MQTT_HOST: "mosquitto"
      MQTT_PORT: "1883"
      CAR_IDS: "1"
      LOG_LEVEL: "info"

然后运行：

bash
docker compose up -d hedgiemate-notifier

Docker Run

bash
docker run -d \
  --name hedgiemate-notifier \
  --restart unless-stopped \
  -e HEDGIEMATE_USER_TOKEN="hm_your_token_here" \
  -e MQTT_HOST="your-mqtt-host" \
  -e MQTT_PORT="1883" \
  -e CAR_IDS="1" \
  docker.xuanyuan.run/hedgiemate/notifier:latest

从源码构建

bash
go build -o hedgiemate-notifier .
HEDGIEMATE_USER_TOKEN=hm_xxx MQTT_HOST=localhost ./hedgiemate-notifier

配置说明

所有配置通过环境变量实现：

支持的事件

多车辆监控

通过将CAR_IDS设置为逗号分隔的列表来监控多辆车：

CAR_IDS=1,2,3

每辆车拥有独立的状态机。

架构

MQTT Broker ──> MQTT客户端 ──> 状态机 ──> 事件发射器 ──> 中继服务器 ──> APNs ──> iOS
                                （每辆车）    （5秒防抖）     （HMAC签名）

• MQTT客户端：订阅TeslaMate主题，连接丢失时自动重连
• 状态机：跟踪每辆车的状态，检测转换，管理电池阈值标记
• 事件发射器：5秒防抖窗口，防止重复事件
• 中继客户端：HMAC-SHA256签名请求，3次重试并采用指数退避策略

更新日志

请查看https://github.com/LukStankovic/hedgiemate-notifier/releases页面获取发布说明，或仓库中的https://github.com/LukStankovic/hedgiemate-notifier/blob/master/CHANGELOG.md。

---

免责声明：本项目是一个非官方社区工具，与官方TeslaMate项目无关联、未获其认可或支持。

---

更新日志

v1.5.0 — 2026-06-25

新增：Sentry模式录制通知

完整更新日志：https://github.com/LukStankovic/hedgiemate-notifier/compare/v1.4.7...v1.5.0