TeslaMate 是一款开源的特斯拉电动汽车数据监控工具，支持实时数据收集、存储与可视化。基于 Docker 的安装部署流程，包括数据库、MQTT 及 Grafana 配置。内容涵盖历史数据导入（如 TeslaFi）、Grafana 仪表盘访问与自定义、环境变量高级配置以及与 Home Assistant 的集成方法。此外还包含常见问题解答与维护更新指南，帮助用户全面掌握车辆状态并优化驾驶体验。
TeslaMate 是一个开源项目，用于收集特斯拉电动汽车的实时数据，并存储在数据库中以便进一步分析和可视化。该项目支持监控车辆状态、行驶里程、充电详情等信息，帮助车主更好地了解车辆使用情况，优化充电策略，延长电池寿命。
TeslaMate 的核心功能包括：
项目结构主要包括以下几个部分：
Docker 安装是最简单快捷的方式，适用于大多数用户。首先确保你的系统已经安装了 Docker 和 Docker Compose。
创建一个 docker-compose.yml 文件，内容如下：
services:
teslamate:
image: teslamate/teslamate:latest
restart: always
environment:
- ENCRYPTION_KEY=secretkey # 替换为安全的加密密钥
- DATABASE_USER=teslamate
- DATABASE_PASS=password # 替换为安全的数据库密码
- DATABASE_NAME=teslamate
- DATABASE_HOST=database
- MQTT_HOST=mosquitto
ports:
- 4000:4000
volumes:
- ./import:/opt/app/import
cap_drop:
- all
database:
image: postgres:17
restart: always
environment:
- POSTGRES_USER=teslamate
- POSTGRES_PASSWORD=password # 替换为安全的数据库密码
- POSTGRES_DB=teslamate
volumes:
- teslamate-db:/var/lib/postgresql/data
grafana:
image: teslamate/grafana:latest
restart: always
environment:
- DATABASE_USER=teslamate
- DATABASE_PASS=password # 替换为安全的数据库密码
- DATABASE_NAME=teslamate
- DATABASE_HOST=database
ports:
- 3000:3000
volumes:
- teslamate-grafana-data:/var/lib/grafana
mosquitto:
image: eclipse-mosquitto:2
restart: always
command: mosquitto -c /mosquitto-no-auth.conf
volumes:
- mosquitto-conf:/mosquitto/config
- mosquitto-data:/mosquitto/data
volumes:
teslamate-db:
teslamate-grafana-data:
mosquitto-conf:
mosquitto-data:
在终端中执行以下命令启动服务：
docker compose up -d
如果你需要将 TeslaMate 暴露到公网，建议使用 Traefik 作为反向代理，实现 HTTPS 加密和 Basic Auth 认证。
主要步骤包括：
docker-compose.yml、.env 和 .htpasswd 文件如果你之前使用过其他特斯拉数据记录工具，如 TeslaFi，可以将历史数据导入到 TeslaMate 中。
docker compose exec -T database pg_dump -U teslamate teslamate > ./teslamate.bck
import 目录：.
├── docker-compose.yml
└── import
├── TeslaFi82019.csv
├── TeslaFi92019.csv
└── ...
docker compose restart teslamate
import 目录并重启服务：rm -rf import/*
docker compose restart teslamate
定期备份数据是一个好习惯，可以使用以下命令创建备份：
docker compose exec -T database pg_dump -U teslamate teslamate > ./teslamate.bck
恢复数据的命令如下：
# 停止 teslamate 容器
docker compose stop teslamate
# 清空现有数据
docker compose exec -T database psql -U teslamate teslamate << 'EOF'
DROP SCHEMA public CASCADE;
CREATE SCHEMA public;
CREATE EXTENSION cube WITH SCHEMA public;
CREATE EXTENSION earthdistance WITH SCHEMA public;
EOF
# 恢复数据
docker compose exec -T database psql -U teslamate -d teslamate < teslamate.bck
# 重启 teslamate 容器
docker compose start teslamate
TeslaMate 集成了 Grafana，提供了丰富的可视化仪表盘，帮助用户直观了解车辆数据。
启动服务后，通过 http://your-ip-address:3000 访问 Grafana，默认用户名和密码均为 admin。首次登录后，系统会提示你修改密码。
Grafana 中提供了多个预设的仪表盘，包括：
如果你对默认仪表盘不满意，可以根据自己的需求进行自定义。Grafana 提供了强大的图表编辑功能，可以添加、删除或修改图表，调整时间范围，设置告警等。
TeslaMate 支持通过环境变量进行配置，常见的配置项包括：
TZ：时区设置，如 Asia/ShanghaiLOG_LEVEL：日志级别，如 info、debugCHECK_ORIGIN：是否检查请求来源，默认为 trueIMPORT_DIR：数据导入目录，默认为 ./import完整的环境变量列表可以参考官方文档。
TeslaMate 可以通过 MQTT 与 Home Assistant 集成，实现更强大的自动化控制。首先需要在 Home Assistant 中配置 MQTT 传感器，然后创建自动化规则。
配置示例：
# configuration.yaml
mqtt:
sensor:
- name: "Tesla Battery Level"
state_topic: "teslamate/cars/1/battery_level"
unit_of_measurement: "%"
device_class: "battery"
- name: "Tesla Charging Status"
state_topic: "teslamate/cars/1/plugged_in"
device_class: "plug"
binary_sensor:
- name: "Tesla Locked"
state_topic: "teslamate/cars/1/locked"
device_class: "lock"
使用 Docker Compose 可以轻松更新 TeslaMate 到最新版本：
docker compose pull
docker compose up -d
如果你的车辆是 MCU1（2018 年 3 月之前生产的 Model S 和 Model X），需要进行以下设置：
如果未使用 Streaming API，可能会导致数据缺失。这是因为车辆在进入睡眠模式前有 15 分钟的不活动时间，TeslaMate 会在 3 分钟后暂停轮询，期间的活动无法被检测到。
Tesla API 本身不返回行程的能耗数据，TeslaMate 通过充电数据估算能耗。需要至少两次充电会话才能生成第一次估算，每次充电会话应超过 10 分钟且充电至低于 95% 的电量。
通过本文的介绍，你已经了解了 TeslaMate 的安装部署、数据导入、可视化分析和高级配置等方面的内容。TeslaMate 作为一款强大的开源特斯拉数据监控工具，能够帮助你全面掌握车辆状态，优化驾驶体验。如果你有任何问题或建议，可以通过 GitHub Issues 与开发团队交流。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online