TeslaMate 四步实操指南为你的特斯拉搭一套私有数据监控看板【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamateTeslaMate 是一款自托管的特斯拉数据监控工具它会持续记录车辆的驾驶、充电和电池状态并把它们变成可回看的仪表盘。这篇文章面向不想依赖第三方云端、又想把爱车的能耗和电池健康长期看清的车主。读完之后你可以用几条命令把自己的监控服务搭起来。 项目速览它是什么适合谁主要有这几点自托管记录仪用 Elixir 编写的数据记录服务跑在你的 NAS 或树莓派上数据全部落在自己的 Postgres 数据库里。解决什么问题官方 App 只显示当前状态TeslaMate 把每一次行驶、每一度电都持久化保存事后可以任意回看。适合谁用想统计能耗、充电费用、电池健康或者要把车辆接入 Home Assistant 的车主全程不需要会写代码。对车辆零负担它会让车尽快进入休眠不额外增加停车时的待机耗电。从哪看起核心逻辑在 lib/teslamate/安装说明在 website/docs/installation/docker.md。 核心能力详解从行车记录到充电花费的三条数据线驾驶与充电记录的自动落库第一条线是原始数据采集车一开车门、一插上枪TeslaMate 就开始写记录全程不用你操作。每次行程自动开一条新记录存下距离、能耗和平均车速充电时记录补入的能量、功率和时长配合按地点设置的电价自动算出这次充电花了多少钱每个位置点都会自动反解成地址你看到的是街道门牌而不是经纬度支持自己画地理围栏把家公司圈出来路边停车换位置也不会认错地点Drives 仪表盘按行程列出距离与净能耗不同路线的用电水平一眼可比。电池健康与衰减趋势估算第二条线是长期趋势数据攒得越久这部分越值钱。追踪电池可用容量随时间的变化画出衰减曲线基于衰减情况预估当前还能跑多少真实续航Vampire Drain 面板展示车辆停放时的待机耗电方便排查异常能耗效率面板区分净/毛消耗看清空调和取暖吃了多少电电池健康面板对比可用容量与出厂容量电池逐年衰减的幅度直接可见。Grafana 仪表盘数据可视化开箱即用第三条线是看数据的方式。数据库里的表格不好翻TeslaMate 出厂就配好了一整套 Grafana 仪表盘。内置 20 多块预配置仪表盘涵盖总览、时间线、能耗、充电花费等主题Web 应用与 Grafana 双向互链点一下就能从这边跳过去车辆状态时间线告诉你车在哪些时刻在线、休眠、行驶或充电一个账号绑定多辆特斯拉时仪表盘按车辆拆分互不干扰总览仪表盘把电池电量、续航里程、行驶里程等关键指标聚合在一屏是部署完成后第一眼该看的页面。 Docker 一键部署与首次连接步骤最省事的部署方式是 Docker一套容器把 teslamate、postgres、grafana 和 mosquitto 四个服务全部拉起来。官方文档里给了现成的 compose 文件你复制下来后只需要改两处一个用来加密特斯拉令牌的密钥ENCRYPTION_KEY以及数据库密码。主机需要 7×24 开机内存建议至少 2GB装好后一条命令启动docker compose up -d容器跑起来后按顺序做完这几件事即可生成令牌TeslaMate 自己不发令牌用第三方特斯拉授权工具获取 access token 和 refresh token流程见 Token 生成文档。登录并连接车辆浏览器打开http://你的IP:4000在登录页填入两个令牌TeslaMate 就会开始拉取车辆数据。配置 Grafana访问 3000 端口默认账号admin/admin登录后改掉密码仪表盘即可浏览。设置互链地址在 Web 界面的 Settings → URLs 里填上 Web App 与 Dashboards 的地址两边链接才能互相跳转。 进阶用法智能家居联动与历史数据导入通过 MQTT 接入 Home Assistant。所有车辆数据都会发布到本地 MQTT 代理Home Assistant 能自动发现这些实体。你可以做成车一回家自动开灯充电完成推送到手机。参考 Home Assistant 集成文档。想玩更复杂的推送自动化比如 Node-RED 转发 Telegram文档目录里也有现成示例见 website/docs/integrations/Node-RED.md。导入历史数据。特斯拉官方 API 不返回历史数据漏记的时段在仪表盘上是空白。如果你之前用 TeslaFi 记录过可以把那段时间的 CSV 整体导进来把时间线补齐步骤见 website/docs/import/teslafi.md。❓ 常见问题排查停止记录、空值与无法休眠记录停了仪表盘没数据先看 teslamate 容器的日志常见原因就三类连不上特斯拉 API、连不上数据库、令牌过期。认证报错时重新生成令牌并在登录页补登即可注意漏记期间的数据 API 拿不回来无法补录。Grafana 里出现 null 或能耗是空白null 多半是车没命名在车机屏幕上给车起个名字等它同步过来即可。能耗为空则属正常现象——它是基于充电数据的估算值至少要有两次有效充电时长超过 10 分钟且结束电量低于 95%才会出第一个估计值充电次数越多越准。车迟迟不休眠日志里一直在轮询MCU1 老车需要在车机上打开能量节省模式、取消保持连接、关闭座舱过热防护同时确认充电设置里 Keep Accessory Power Off 是开启的。详细判断方法见 官方 FAQ。看板搭好之后你不用再靠官方 App 每天惦记车的能耗所有数据都在自己的数据库里想备份随时可以导出来。现在就可以打开终端跑起来了。提示特斯拉的 API 接口变动较频繁注意保持版本更新升级步骤见 升级指南。【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考