TeslaMate 车辆数据记录

TeslaMate 官方镜像。teslamate/teslamate 记录 Tesla 车辆数据，teslamate/grafana 提供预置数据源和仪表盘的 Grafana。完整部署还需要 PostgreSQL 和 MQTT。 https://docs.teslamate.org/

TeslaMate 是自托管的 Tesla 车辆数据记录工具，持续从 Tesla 接口拉取行程、充电和车辆状态，写入 PostgreSQL，并通过 Grafana 展示。Docker Hub 上 teslamate 组织有两个镜像：teslamate/teslamate 拉取量约 2900 万，teslamate/grafana 约 2400 万。后者是预置了数据源和仪表盘的 Grafana，不是通用 Grafana 发行版。官方 Docker 安装由四个服务组成：teslamate/teslamate、PostgreSQL、teslamate/grafana 和 Eclipse Mosquitto。TeslaMate 与 Grafana 属于本组织，数据库和 MQTT 使用各自的上游镜像。文档要求使用常开的主机、至少 1 GB 内存（建议 2 GB），并需要访问 tesla.com。镜像提供 amd64 与 aarch64。文档建议把 TeslaMate 放在家庭网络内。Tesla API 令牌由 ENCRYPTION_KEY 加密保存，数据库口令需要自行设置。若要从公网访问，应使用 VPN、隧道或带认证的反向代理，而不是直接暴露端口。Web 界面默认端口 4000，Grafana 默认端口 3000。

特色镜像推荐

TeslaMate（teslamate/teslamate）

Tesla 车辆数据记录服务。通过环境变量连接 PostgreSQL 和 MQTT，并用 ENCRYPTION_KEY 加密保存 API 令牌。官方安装将其 Web 端口发布为 4000。

记录行程与充电车辆状态历史家庭自托管导出车辆数据

TeslaMate Grafana（teslamate/grafana）

专用于 TeslaMate 的 Grafana 镜像，启动时自动配置数据源和仪表盘。需要与 TeslaMate 使用同一套数据库账号。官方安装将界面发布在 3000 端口，首次登录后应修改默认管理员口令。

车辆仪表盘充电与能耗图表历史行程查看

TeslaMate 车辆数据记录集合

TeslaMate 车辆数据记录

特斯拉的自托管数据记录器，可帮助用户本地存储和管理车辆数据，实现数据隐私保护与自主控制。

117 次收藏29357817 次下载

TeslaMate 车辆数据记录

一个自定义Grafana镜像，可自动配置数据源和仪表板，简化监控系统的部署与配置流程。

25 次收藏23726717 次下载

推荐技术栈

本组织镜像

teslamate/teslamateteslamate/grafana

配套服务

PostgreSQLEclipse Mosquitto

典型使用场景

家庭网络中的车辆日志

按官方 Compose 同时运行 TeslaMate、PostgreSQL、预置 Grafana 和 Mosquitto，在局域网查看车辆数据。

teslamate/teslamateteslamate/grafanaPostgreSQLMosquitto

升级现有实例

拉取新的 teslamate 与 grafana 标签后按文档升级。数据库卷需要保留，ENCRYPTION_KEY 必须与初次部署时一致。

teslamate/teslamateteslamate/grafana

相关文章推荐

Docker 部署 TeslaMate：轻松搭建特斯拉车辆数据记录平台

TeslaMate 是特斯拉车辆的自托管数据记录器，把行程、充电和车辆状态写进自己的 PostgreSQL，并用 Grafana 看仪表板。本文用 Docker Compose 部署 teslamate/teslamate 之后，可以在浏览器里提交访问令牌，再打开里程与充电仪表板。适合想把车辆数据留在家里、又不想把账号交给第三方记录站的车主。

Docker部署教程2026年10月8日

常见问题 (FAQ)

Q1:只有 teslamate 这两个镜像就够了吗？

不够。teslamate/teslamate 负责采集，teslamate/grafana 负责展示。数据存在 PostgreSQL 中，服务之间通过 MQTT（官方示例使用 eclipse-mosquitto）通信。这两个依赖镜像不在 teslamate 组织里，官方 Compose 会一并写上。

Q2:可以直接把端口暴露到公网吗？

官方文档建议只在家庭网络中使用，否则 Tesla API 令牌面临风险。需要远程访问时，使用 VPN、Cloudflare Tunnel、Tailscale，或带 TLS 与认证的反向代理。ENCRYPTION_KEY 和数据库口令应设成随机值，不要保留文档里的示例字符串。

Q3:teslamate/grafana 可以换成官方 grafana/grafana 吗？

teslamate/grafana 在官方 Grafana 之上预置了 TeslaMate 的数据源和仪表盘。换成通用 Grafana 镜像会失去这些自动配置，需要自行导入仪表盘并配置数据源。正常安装应使用 teslamate/grafana。