logo
icon

TeslaMate

强大的自托管 Tesla 数据记录器 —— 跟踪行程、充电、效率等数据,并通过 Grafana 仪表板进行可视化。

template cover
部署次数9
发布者zeaburZeabur
创建于2026-05-05
标签
VehicleTeslaMonitoringDashboardDatabase

TeslaMate

TeslaMate 是一个强大的自托管 Tesla 数据记录器。它会记录你的行程、充电、能效、休眠状态、固件升级等详细数据,并通过精心设计的 Grafana 仪表板进行可视化。

功能特性

  • 行程与充电日志 —— 距离、时长、能耗、费用
  • 能效分析 —— 按温度、路线、驾驶风格分析能耗
  • 充电统计 —— 在哪里、什么时候、充了多少、花了多少
  • 固件升级跟踪 —— 完整的固件版本历史
  • 地理围栏 —— 用命名位置(家、公司等)自动标记行程
  • MQTT 推流 —— 实时车辆状态,方便接入家庭自动化
  • 预置 Grafana 仪表板 —— 15+ 个开箱即用的可视化面板

部署内容

此模板会部署经过安全加固的完整 TeslaMate 技术栈:

  1. Caddy —— TeslaMate 前置反向代理,强制 HTTP Basic Auth(公网上唯一可访问的入口,绑定 PUBLIC_DOMAIN
  2. TeslaMate —— 主 Web 应用,仅内网访问,必须通过 Caddy 访问
  3. PostgreSQL 18 —— 仅内网访问,存储所有车辆数据
  4. Grafana —— 预装 TeslaMate 官方仪表板,对外暴露在 GRAFANA_DOMAIN,自带独立登录
  5. Mosquitto MQTT —— 仅内网访问的实时状态消息代理

快速开始

  1. 部署 —— 点击部署,填写所有变量(含 Web UI 用户名和密码),并绑定两个域名
  2. 访问 TeslaMate —— 打开 PUBLIC_DOMAIN,浏览器会弹窗要求输入你设置的 Basic Auth 账号密码,然后再走 TeslaMate 自己的 Tesla token 配置流程
  3. 打开 Grafana —— 访问 GRAFANA_DOMAIN(默认 admin / admin,请立即修改)
  4. 开车 —— TeslaMate 会自动开始记录数据

安全说明

  • TeslaMate Web UI 自身没有登录功能,因此本模板在它前面挂了一层带 HTTP Basic Auth 的 Caddy 反代。TeslaMate 容器不直接对外暴露,只有 Caddy 对外。
  • Postgres 和 Mosquitto 默认仅内网访问请勿在 Zeabur 控制台为这两个服务启用 Port Forwarding,除非你清楚后果 —— 特别是 Mosquitto 是无密码的,开了 1883 公网端口等于把车辆的实时 GPS 位置直接公开。
  • 请把 ENCRYPTION_KEY 保存到 Zeabur 之外,恢复数据库备份时必须使用同一把密钥。
  • Grafana 自带独立登录(首次 admin / admin,登录后会要求立即修改)。
  • Basic Auth 密码在容器启动时由 caddy hash-password 自动 bcrypt 加密,明文只存于 Zeabur 的环境变量,不会落到容器文件系统。

相关链接