TeslaMate完整指南免费自托管特斯拉数据记录仪20个仪表盘讲清你的车【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate你的特斯拉已经跑了三万公里但你上一次确切知道电池到底衰减了几个百分点是什么时候官方App只回答现在还有多少电从不做纵向比较——新电池 78.9 kWh 和现在的 75.5 kWh 之间的差距它永远不会主动告诉你。TeslaMate 就是补上这一块的一款免费、开源AGPLv3 许可的自托管特斯拉数据记录仪。它通过特斯拉官方 API 持续采集车辆状态写入自己的 Postgres 数据库再用 20 多个 Grafana 仪表盘把电池健康、充电成本、驾驶效率呈现出来。所有数据存在你自己的机器上不经过任何第三方服务器。装之前先确认它值不值先看三组对照判断自己是不是目标用户。对比项特斯拉官方 AppTeslaFiSaaSTeslaMate历史数据只有当前值不积累积累在对方服务器积累在你自己的 Postgres部署成本零零需要一台能跑 Docker 的常开设备1GB 内存起步建议 2GB睡眠友好度—持续轮询会让车难以入睡内置休眠策略闲置 3 分钟暂停采集、15 分钟后才试探车辆是否睡着不额外制造吸血鬼功耗可玩性固定界面固定界面仪表盘、MQTT、API 全开放可自由扩展费用免费免费免费AGPLv3闭源衍生版本不可行一句话判断你手里有一台常开的树莓派或旧笔记本、希望数据完全自己掌握、并且不排斥折腾一点配置——那就对路了。反过来如果你只想要零维护看一眼电量官方App 足够不必装它。另一个常见疑问它和 Home Assistant 的官方 Tesla 组件是什么关系HA 官方组件长期未更新默认轮询参数会让车保持唤醒、消耗电池TeslaMate 的 MQTT 数据可以替代组件的绝大部分只读功能。这个差异后面进阶部分再展开。4 个最值得打开的仪表盘实时状态浏览器里的车况面板Web 界面左侧地图显示车辆位置与围栏右侧是电量、续航、内外温与充电状态车辆信息栏含软件版本打开http://你的IP:4000看到的就是这个地图上车辆的实时位置加上电量百分比、可用续航、车内车外温度、充电进度。它的意义不是看个位置而是给你一张随开随查的底牌——出门前确认还剩多少真实续航充电时盯着预计完成时间都不需要解锁车机。电池健康把衰减量化成数字Battery Health 仪表盘环形图对比新电池与当前电池容量kWh及最大续航柱状图按充电类型拆分已充电能量这是 TeslaMate 最被低估的一页。它把电池还行不行拆成可以直接引用的数字初始容量与当前容量的差值例如 78.9 → 75.5 kWh衰减约 3.5 kWh、折算后的续航损失329 英里 → 315 英里、以及能量来源拆分DC 快充 23% / AC 慢充 77%。怎么读这些数据衰减本身不可怕可怕的是你不知道它在以什么速度发生。每月截一次这张图容量差值的变化率就是你的衰减速率能量来源拆分则回答快充占得越多衰减是否越快这个悬了很久的问题。充电成本把电费从糊涂账算成明细Charging Stats 仪表盘热力图展示各月各时段的充电次数分布表格按地点汇总充电量与费用TeslaMate 支持在地理围栏里设置不同电价家充、超充站、公共桩分别定价之后每次充电都会计入成本。这张图的价值在于对比热力图暴露你什么时候在充电地点表格告诉你哪里的电最便宜。如果你家充电峰谷电价差 0.5 元/度、月充电 100 度把充电挪到谷段一个月就是 25 元——数字不大但全年 300 元而且顺带对电池更友好低温时段少用快充。能耗效率钱花在哪一公里上Efficiency 仪表盘按时间粒度展示净/毛能耗kWh/100km可对比不同季节与驾驶场景注意一个前提特斯拉 API 不直接返回每次行程的能耗值TeslaMate 是根据记录的充电数据反推估算的所以这个仪表盘至少需要两次有效充电会话单次时长 10 分钟、SoC 未超过 95%才开始出数之后每次充电都会让估算更准、并回溯修正历史。出数之后它能回答这类问题冬天油耗是不是比夏天高出一截高速巡航和市区通勤差多少有了这条基线你调整驾驶习惯前后是否有变化就能用同一把尺子量出来。30 分钟跑起来Docker 最短部署路径前置条件来自 Docker 部署文档一台常开、能跑 Docker 的设备树莓派 3/4 及以上、任意 Linux、装了 Docker Desktop 的 Windows/Mac 均可x86-64 与 ARM64 官方镜像都提供armv7 已不支持至少 1GB 内存建议 2GB能访问特斯拉服务器的外网一个安全加密密钥和一个数据库密码写进配置文件最少命令准备一个docker-compose.yml完整版见官方文档最小骨架长这样database与mosquitto两个服务照文档补齐services: teslamate: image: teslamate/teslamate:latest ports: [4000:4000] grafana: image: teslamate/grafana:latest ports: [3000:3000]然后后台启动docker compose up -d首次打开能看到什么http://你的IP:4000—— TeslaMate 登录页。它不能替你生成特斯拉账号的 access/refresh token这部分需要单独工具完成流程见 Token 生成指南把两个 token 填进去即可完成绑定同一账号下的多辆车都会被自动纳管。http://你的IP:3000—— Grafana默认账号admin/ 初始密码admin进去先改密码。20 多个仪表盘已预装好源码在 grafana/dashboards/从 Overview 开始逛即可。回到 TeslaMate 的 Settings → URLs把 Web 与 Dashboard 的 URL 互相填上两边跳转就通了。跑起来之后3 个进阶玩法一条环境变量接入 Home AssistantTeslaMate接入Home Assistant后的仪表盘Home Assistant 中的 TeslaMate 设备电量、续航、胎压等实体自动出现在集成界面把MQTT_HOME_ASSISTANT_DISCOVERY设为true重启TeslaMate 会通过 MQTT 自动发布 HA 设备发现配置电量、续航、充电状态等实体直接出现在 Home Assistant 里不用手工维护传感器 YAML。之后的玩法很直接车回家自动开灯、SoC 低于 20% 推送手机通知。细节见 Home Assistant 集成指南。用 Node-RED 把数据变成动作TeslaMate 把车辆数据持续发布到本地 MQTT broker所以任何订阅 MQTT 的系统都能吃到它。社区文档里给了现成的 Node-RED 流程示例——比如充电完成 → 推送 Telegram 消息拖几个节点就能搭出来不需要写代码。补历史数据 一键备份补数据如果你之前用 TeslaFi 记录过可以把它的 CSV 按月导出放进导入目录由 TeslaMate 的 TeslaFi 导入 流程写回数据库同机制还支持 tesla-apiscraper 的数据。导入前一定先做备份。备份所有数据就在 Postgres 里一条命令全量导出docker compose exec -T database pg_dump -U teslamate teslamate teslamate.bck挂进 crontab定期把.bck文件拷到宿主机之外的地方见 备份与恢复文档。三个高频问题的直接回答Grafana 里为什么看不到能耗数值正常现象。如前所述能耗是估算值前两次有效充电10 分钟、SoC95%之前无数据之后每次充电都会让精度提升并回溯修正。另外如果面板变量显示null是因为你没给车起名字——在车机上命名后等待同步即可。车为什么睡不下去两个方向排查一是检查车机设置 Controls Charging Keep Accessory Power Off 是否开启二是 2018 年 3 月前生产的 Model S/XMCU1软件信息页显示 Infotainment processor 为 NVIDIA Tegra需要手动打开节能显示、关掉常连与座舱过热保护三项。完整清单在 官方 FAQ。还有一个隐蔽原因如果你同时跑着 TeslaFi 等其他记录器双份轮询会不断重置车辆的闲置计时器。某段时间的数据丢了能找回吗特斯拉 API 不提供历史行程与充电数据所以记录中断期间的数据 TeslaMate 自己补不回来但如果那段时间有别的记录器如 TeslaFi存了数据可以按上面的导入流程补进库。日常建议发现停止记录先查日志——网络、数据库连接、token 过期三类原因日志里都能直接分辨token 过期时重新生成并登录即可已录数据不受影响。三步走你的开始时间表今天约 30 分钟完成 Docker 部署、生成并填入 token、在 Grafana 改好默认密码。验收标准4000 端口登录页能看到你的车。第一周每天 0 分钟什么都别调让它静默积累。周末花 10 分钟看一遍 Overview 与 Battery Health建立你电池的出厂参照系。一个月后约 30 分钟此时至少已有数次完整充电能耗估算已可用。打开 Efficiency 与 Charging Stats 各截一张图对比你的实际用电习惯然后才谈得上调整充电时段或驾驶方式。一句话总结TeslaMate 把特斯拉官方App 里那些用完即弃的状态数据变成了一份逐年可查、归因到每次充电每段行程的私人车况档案——免费、自托管且你随时能用一条pg_dump把它完整带走。【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考