TeslaMate 5分钟上手自建特斯拉数据记录器充电、驾驶、能耗一屏看清【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate每次出门前都想看一眼车停在哪儿、电量还剩多少、这趟开了几公里、花了多少钱特斯拉 App 能答个大概但想长期追踪能耗、充电成本和电池衰减它就力不从心了。TeslaMate 就是冲着这个痛点来的自托管数据记录器用 Elixir 编写数据存进 PostgreSQL再借 Grafana 做可视化还能通过 MQTT 把车况推给智能家居。一句话你花几分钟装好就能拿到一份持续更新的车辆使用说明书。它适合手上有台常开设备、想自己掌握数据的特斯拉车主。5分钟跑通最短路径装之前只要确认两件事机器装好了Docker Docker Compose这台机器要常开至少 1GB 内存建议 2GB并且能访问特斯拉服务器数据才能持续采集。核心其实只有一个文件在项目目录里新建docker-compose.yml写清四个服务。下面是必须填对的骨架细节用注释省略了。services: teslamate: image: teslamate/teslamate:latest restart: always environment: - ENCRYPTION_KEY一段强随机密钥 # 加密你的特斯拉令牌必填 - DATABASE_USERteslamate - DATABASE_PASS你的数据库密码 - DATABASE_NAMEteslamate - DATABASE_HOSTdatabase - MQTT_HOSTmosquitto ports: - 4000:4000 database: # PostgreSQL image: postgres restart: always environment: - POSTGRES_USERteslamate - POSTGRES_PASSWORD你的数据库密码 # 与上面保持一致 - POSTGRES_DBteslamate volumes: - teslamate-db:/var/lib/postgresql grafana: # 可视化 image: teslamate/grafana:latest restart: always ports: - 3000:3000 # ... 数据库变量同上 mosquitto: # MQTT 代理 image: eclipse-mosquitto:2 restart: always command: mosquitto -c /mosquitto-no-auth.conf volumes: teslamate-db:重点就两个变量ENCRYPTION_KEY换成一段强随机字符串DATABASE_PASS在 teslamate 和 database 两处保持一致。文件写好后这一条命令把四个服务全拉起来docker compose up -d跑完执行docker compose ps看到 teslamate、database、grafana、mosquitto 四个服务都是Up状态就说明部署成功了。官方镜像已经把 Elixir 应用打包好直接跑即可不必从源码构建。如果你想顺便通读源码和文档可以再git clone https://gitcode.com/GitHub_Trending/te/teslamate到本地看看但不影响上面的部署。启动后怎么确认它在跑服务起来不等于在录数据得登录进去看一眼。打开浏览器访问http://本机IP:4000会看到 TeslaMate 的登录页。它不会用特斯拉账号密码登录而是填一对access token 和 refresh token——这两个令牌要用第三方 Tesla 认证工具先生成TeslaMate 本身不内置建令牌的功能。把生成的两串令牌粘进去提交即可。看到上图这种车辆卡片状态显示为online/charging/asleep就说明它已经连上你的车、开始记录了。再访问http://本机IP:3000打开 Grafana用默认的admin/admin登录它会强制你改一个强密码。登录成功、左侧能看到一批预置仪表盘整个平台就算真正跑通了。记得回 TeslaMate 的Settings → URLs把 Web App 和 Dashboards 两个地址填上这样两边的跳转链接才能互相打通。三个最有感知度的功能驾驶每趟都留痕它能帮你把每一次行程拆开看走了哪条路、平均和最高时速、耗了多少电、效率如何。平时它自动把位置、速度、海拔记进数据库你事后在 Grafana 的 Drives / Drive 面板里按趟回看就行。充电成本与效率都算给你它能帮你算清每度电花在哪充了多快、充了多少、用了多少电、花了多少钱。支持按地理位置设置不同电价所以家用桩和超充桩的成本能分开统计适合想盯着这周充电花了多少的人。电池衰减看得清它能帮你长期跟踪电池容量变化画出衰减趋势并据此预估可用续航。这块数据不是一天能看出名堂的但装好放着几个月后你会有一份很直观的电池健康档案。接入智能家居与更多面板数据进了库别只自己看。TeslaMate 会把大量车况实时推到 MQTT这让它很自然地接进别的系统Home Assistant开启 MQTT 发现设MQTT_HOME_ASSISTANT_DISCOVERYtrue车的位置、电量、车门、哨兵模式等会自动变成 HA 里的实体不用手写一堆传感器配置再拿它做到家自动开车库门车窗没关就提醒这类自动化。Node-RED适合想玩点花样的人把车况接到 Telegram、邮箱或自绘面板上实现电量低于 20% 推一条消息到我手机。这两个方向都建立在同一个 MQTT 主题上teslamate/cars/id/...更多可用主题和字段可查 website/docs/integrations/mqtt.md。启动失败、数据断流怎么排查现象多半原因动作页面打不开、容器起不来端口 4000/3000 被占用或ENCRYPTION_KEY为空docker compose ps看状态换端口或补上强随机密钥能登录却一直没数据access / refresh token 过期用认证工具重新生成回登录页重填Grafana 面板一片null没给车命名car_id变量为空在车机屏幕给车起名等 TeslaMate 同步能耗/充电面板没数值API 不直接给能耗靠充电数据估算需至少两次 10 分钟且 95% 电量的充电先充两次再看数据会逐步补齐日志时间和本地对不上容器默认 UTC 时区在 compose 里加TZ环境变量重启回到开头那个场景——现在你再也不用凭记忆猜车在哪、电够不够。下一步很简单把车开出去跑一趟、再插枪充一次电然后回 Grafana 的 Drives 和 Charging 面板看看你的第一份真实数据接着去把 Home Assistant 的 MQTT 发现打开让车真正进家门。【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考