teslamate-notify Docs
GitHub Repository

Interactive Guide

应用部署向导

按照步骤顺序推进。您可以利用底部的『下一步』或是侧边栏进行步骤跳转与回溯。

功能概览与服务阵列

teslamate-notify 提供了一套严密、高效的私有化后台感知组件，实时聚合您的车辆数据并跨渠道精准分发。

抵达设防坐标后启用，临近计费节点自动预警，避免高昂跨段停车费。

静默巡航驻车数据，全天候侦测唤醒失败与超阈值高耗电泄露。

旅途结束瞬间聚合数据库能效比、极速等核心参数反馈到达端点。

⚡

完整剖析补能周期动作序列，精确统计入仓电量与全压转换充实损耗率。

基于极短延迟探针技术，捕获离车未关实态的车门、车窗以及非设防箱盖。

↑

底层侦测官方静默下发的最新固件下载包与低压/低胎压预警雷达。

支持向 Telegram、飞书、Discord 以至原生轻快全端并发海量触达投送。

随时随地呈现高保真的传感器物理全貌与极其灵敏的哨兵模位实时红眼提示。

注意：如果你的服务器已经部署过 TeslaMate，并且 Grafana 页面可以正常打开、登录和访问数据源，请直接点击底部『下一步』跳过此步骤，进入 Notify 安装流。

部署 TeslaMate (服务端前置)

官方参阅：如欲深入各类进阶配置，请务必参阅 TeslaMate 官方 Docker 部署文档。

在安装 notify 服务之前，你的服务器上必须已经稳定运行着 TeslaMate 本体，并且 Grafana 必须可以正常访问。Notify 的 App 侧连接依赖 Grafana 数据源代理，因此只有 TeslaMate 本体可用还不够。

建库与配表方案

创建一个文件夹，并编写你的核心 docker-compose.yml 文件：

bash & yaml 
mkdir teslamate && cd teslamate
nano docker-compose.yml

# ------------- yaml 内容 -------------
services:
  teslamate:
    image: teslamate/teslamate:latest
    restart: always
    environment:
      - ENCRYPTION_KEY=secretkey #replace with a secure key to encrypt your Tesla API tokens
      - DATABASE_USER=teslamate
      - DATABASE_PASS=password #insert your secure database password!
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
      - MQTT_HOST=mosquitto
    ports:
      - 4000:4000
    volumes:
      - ./import:/opt/app/import
    cap_drop:
      - all

  database:
    image: postgres:18-trixie
    restart: always
    environment:
      - POSTGRES_USER=teslamate
      - POSTGRES_PASSWORD=password #insert your secure database password!
      - POSTGRES_DB=teslamate
    volumes:
      - teslamate-db:/var/lib/postgresql

  grafana:
    image: teslamate/grafana:latest
    restart: always
    environment:
      - DATABASE_USER=teslamate
      - DATABASE_PASS=password #insert your secure database password!
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
    ports:
      - 3000:3000
    volumes:
      - teslamate-grafana-data:/var/lib/grafana

  mosquitto:
    image: eclipse-mosquitto:2
    restart: always
    command: mosquitto -c /mosquitto-no-auth.conf
    # ports:
    #   - 1883:1883
    volumes:
      - mosquitto-conf:/mosquitto/config
      - mosquitto-data:/mosquitto/data

volumes:
  teslamate-db:
  teslamate-grafana-data:
  mosquitto-conf:
  mosquitto-data:

在存放 docker-compose.yml 的目录下执行拉取启动即可：docker compose up -d。

部署 Notify 服务

当你的 TeslaMate 正常连上爱车并拉起数据流后，下载脚手架并执行 install.sh 即可。

下载脚手架并安装

标准情况下只需要按顺序执行下面三行命令。

bash 
curl -fsSL https://raw.githubusercontent.com/cloakmere/teslamate-notify/main/scripts/setup.sh | bash
cd teslamate-notify
./install.sh

# 如果你给前面的组合服务设定了特殊的 docker 项目名，再改用：
# ./install.sh --project teslamate

安全卸载与维护

如果您希望移除此伴生实例，或者发生了任何不可逆的数据混淆需要重置，您随时可以调用脚本完全抹除它。

卸载过程极其安全收束，它只会把 Notify 相关卷组抛弃：**这一切过程都不会波及你原本的 TeslaMate 原生架构**。

bash 
# 标准卸载 (停止服务并删除 Notify 数据卷)
./uninstall.sh

# 卸载但保留 Notify 历史状态数据
./uninstall.sh --keep-volume