企业官网建设流程全解析

TeslaMate 入门指南：自托管特斯拉数据记录仪如何把每一次充电和驾驶都算清楚

【免费下载链接】teslamateA self-hosted data logger for your Tesla 🚘 [main maintainer=@JakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate

早上出门前，你想确认两件事：电池夜里充到几了，这次充电花了多少钱。官方 App 只能告诉你前者，而后者得自己去查电费单。TeslaMate 是一个自托管的特斯拉数据记录仪：它常驻在你的局域网里，持续从特斯拉 API 拉取位置、电量、能耗等数据存进 Postgres 数据库，再用 Grafana 仪表盘把电池健康、充电成本、单次驾驶能耗这些平时看不到的东西变成图表，让你随时知道自己这辆车的数据账。

它是什么：一句话定位

TeslaMate 用 Elixir 编写，数据存在 Postgres 中，可视化交给 Grafana，并会把车辆状态发布到本地 MQTT Broker 供智能家居消费。它面向所有想要长期沉淀车辆数据的特斯拉车主，包括一辆车的个人车主和管着多辆车的车队。官方 App 只提供"此刻"的信息，TeslaMate 补上的正是"过去到现在"的全部记录——里程、能耗、衰减趋势、充电花费，以及每次数据点背后的地址和地理围栏。

核心能力拆解

1. 高精度行车数据记录：先有全量数据，才谈得上分析

它能做什么：持续记录位置、速度、电池电量、里程、温度、软件版本等行车数据，自动反查每个坐标对应的地址，并支持同一特斯拉账户下的多辆车。

它怎么做到：内置智能轮询机制——车辆睡着时尽量少打扰它，官方文档明确强调"不额外制造 vampire drain（后台偷电）"，车能尽快进入睡眠就让它睡；车辆在线时则提高采集精度。核心调度逻辑在 vehicles 模块，落库逻辑在 log 模块。

实际带来什么：车辆每次在线产生的原始帧都被留下，这意味着电池健康、能耗、成本这些分析能力都建立在同一份全量数据上，而不是事后估算。

2. 电池健康追踪：衰减曲线替你回答"电池还行吗"

它能做什么：从长期充电数据推算电池容量变化，内置 Battery Health 与 Projected Range 仪表盘，直接画出电池容量衰减曲线和可用续航趋势。

它怎么做到：以充满时的实际充电量和额定容量做对比，随时间累积成序列，Grafana 仪表盘 grafana/dashboards/battery-health.json 负责呈现。

实际带来什么：不用再去论坛对别人的案例，你自己的衰减曲线就在眼前——容量是正常波动还是异常下滑，看图即可判断，换车、质保索赔都有据可依。

3. 充电成本记账：按地点、按时段算清每一度电

它能做什么：为每次充电记录充入电量与耗时，支持两种计价方式——按每度电单价（per kWh）和按每分钟单价（per minute，适合按分钟计费的超充），还能结合地理围栏区分"家充"和"超充"的单价。

它怎么做到：充电事件在 charge_live 里可手动补录费用，也可按单价自动换算；地理围栏功能让你把"公司楼下""小区充电桩"圈成自定义地点，围栏本身也支持绑定电价。

实际带来什么：月底你可以直接回答"这个月充电花了多少钱、家充和超充各占多少"，这是官方 App 从不告诉你的数据。

4. 单次驾驶分析：把每次行程变成一份能耗报告

它能做什么：识别"一次开车"的开始与结束，记录起止位置、里程、净耗电、效率，并提供 Trip、Drive Details、Efficiency 等仪表盘做单程复盘。

它怎么做到：结合换挡状态（挂 P 且熄火）与行驶数据切分行程，位置落库后自动关联地址与围栏，行程数据由 drive 模块 维护。

实际带来什么：同样 30 公里的通勤，哪次能耗偏高、当时温度多少、空调是否开着，一目了然。长期看下来，能耗波动和驾驶习惯之间的关系不再靠感觉。

落地场景：谁在用，怎么用

个人车主 + Home Assistant 玩家：通过 MQTT 集成，TeslaMate 把车辆状态以标准 MQTT 主题（电量、门锁、哨兵模式、胎压等 90 多个 topic）发布出来，开启MQTT_HOME_ASSISTANT_DISCOVERY后实体自动出现在 Home Assistant 里。结果是可以做"到家前 10 分钟远程预热座舱""哨兵模式告警推手机"这类自动化，且因为 TeslaMate 的轮询策略更省电，车辆比用官方组件轮询更快进入睡眠。

长期记录者 / 数据迁移用户：如果你之前在用 TeslaFi 或 tesla-apiscraper，官方提供 CSV 导入流程，把历史数据按月导出后导入 TeslaMate，历史里程和能耗不用从零积累。

多车家庭或小型车队：一个特斯拉账户下多辆车全部纳入记录，每辆车独立生成行程、充电、健康数据，谁开得费、哪辆车衰减更快，对比一目了然。

快速上手：两条部署路径

零基础快速体验（约 30 分钟）

目标：用 Docker 在局域网内跑起 TeslaMate + Postgres + Grafana，看到第一份车辆状态。

关键命令：

git clone https://gitcode.com/GitHub_Trending/te/teslamate docker compose up -d

按 Docker 安装文档 准备docker-compose.yml（官方文档含完整示例，需填入加密密钥与数据库密码），然后生成特斯拉 API 的 Access / Refresh Token（文档见 tokens 指南）。

验证标准：浏览器打开http://<你的IP>:4000填入 Token 登录成功，页面显示车辆当前状态、位置与续航；http://<你的IP>:3000能打开 Grafana 并看到 Overview 仪表盘。要求：一台常开设备（建议 2GB 内存以上）、Docker、可访问特斯拉服务器。

进阶配置（智能家居联动）

目标：让 Home Assistant 自动发现特斯拉实体，实现自动化。

关键步骤：

docker compose config # 确认 MQTT 环境变量后重启容器

在docker-compose.yml的 teslamate 服务中加入MQTT_HOME_ASSISTANT_DISCOVERY=true与MQTT_HOST=mosquitto，详见 Home Assistant 集成文档 与 MQTT 主题清单。

验证标准：Home Assistant 设备列表中出现teslamate_car_<id>设备，电量、门锁、哨兵模式等实体无需手工建 YAML 即可读取，且车辆状态变化时实体秒级更新。

写在最后

TeslaMate 做的事情不复杂：把特斯拉官方 App 里"用完即走"的数据变成一份可查询、可对比、可回溯的私有数据库，再让分析图表替你回答"电池、电费、能耗"这三个问题。如果你受够了只看当下的续航数字，不妨从一次 30 分钟的 Docker 部署开始，让数据替你记着每一公里。

【免费下载链接】teslamateA self-hosted data logger for your Tesla 🚘 [main maintainer=@JakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate