TeslaMate 开源特斯拉监控方案：安装与数据可视化指南

在终端中执行以下命令启动服务：

docker compose up -d

2.2 高级安装：使用 Traefik 实现 HTTPS 和 Basic Auth

如果你需要将 TeslaMate 暴露到公网，建议使用 Traefik 作为反向代理，实现 HTTPS 加密和 Basic Auth 认证。

主要步骤包括：

1. 创建 docker-compose.yml、.env 和 .htpasswd 文件
2. 配置 Traefik 反向代理
3. 设置 HTTPS 证书自动续期
4. 配置 Basic Auth 认证

三、数据导入

如果你之前使用过其他特斯拉数据记录工具，如 TeslaFi，可以将历史数据导入到 TeslaMate 中。

3.1 从 TeslaFi 导入数据

1. 首先创建数据备份：

docker compose exec -T database pg_dump -U teslamate teslamate > ./teslamate.bck

2. 从 TeslaFi 导出 CSV 数据：Settings -> Advanced -> Download TeslaFi Data
3. 将导出的 CSV 文件复制到 import 目录：

.
├── docker-compose.yml
└── import
    ├── TeslaFi82019.csv
    ├── TeslaFi92019.csv
    └── ...

4. 重启 TeslaMate 服务，在管理界面中选择时区并开始导入：

docker compose restart teslamate

5. 导入完成后，清空 import 目录并重启服务：

rm -rf import/*
docker compose restart teslamate

3.2 数据备份与恢复

定期备份数据是一个好习惯，可以使用以下命令创建备份：

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，提供了丰富的可视化仪表盘，帮助用户直观了解车辆数据。

4.1 访问 Grafana 仪表盘

启动服务后，通过 http://your-ip-address:3000 访问 Grafana，默认用户名和密码均为 admin。首次登录后，系统会提示你修改密码。

Grafana 中提供了多个预设的仪表盘，包括：

• 总览：grafana/dashboards/overview.json
• 电池健康：grafana/dashboards/battery-health.json
• 充电统计：grafana/dashboards/charging-stats.json
• 行驶统计：grafana/dashboards/drive-stats.json
• 能耗分析：grafana/dashboards/efficiency.json

4.2 自定义仪表盘

如果你对默认仪表盘不满意，可以根据自己的需求进行自定义。Grafana 提供了强大的图表编辑功能，可以添加、删除或修改图表，调整时间范围，设置告警等。

五、高级配置

5.1 环境变量配置

TeslaMate 支持通过环境变量进行配置，常见的配置项包括：

• TZ：时区设置，如 Asia/Shanghai
• LOG_LEVEL：日志级别，如 info、debug
• CHECK_ORIGIN：是否检查请求来源，默认为 true
• IMPORT_DIR：数据导入目录，默认为 ./import

完整的环境变量列表可以参考官方文档。

5.2 与 Home Assistant 集成

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"

六、更新与维护

6.1 更新 TeslaMate

使用 Docker Compose 可以轻松更新 TeslaMate 到最新版本：

docker compose pull
docker compose up -d

6.2 常见问题解答

6.2.1 车辆无法进入睡眠模式

如果你的车辆是 MCU1（2018 年 3 月之前生产的 Model S 和 Model X），需要进行以下设置：

• 显示 -> 节能 -> 开启
• 显示 -> 始终连接 -> 关闭
• 安全与保障 -> 座舱过热保护 -> 关闭

6.2.2 数据缺失

如果未使用 Streaming API，可能会导致数据缺失。这是因为车辆在进入睡眠模式前有 15 分钟的不活动时间，TeslaMate 会在 3 分钟后暂停轮询，期间的活动无法被检测到。

6.2.3 为什么没有显示能耗数据？

Tesla API 本身不返回行程的能耗数据，TeslaMate 通过充电数据估算能耗。需要至少两次充电会话才能生成第一次估算，每次充电会话应超过 10 分钟且充电至低于 95% 的电量。

七、总结

通过本文的介绍，你已经了解了 TeslaMate 的安装部署、数据导入、可视化分析和高级配置等方面的内容。TeslaMate 作为一款强大的开源特斯拉数据监控工具，能够帮助你全面掌握车辆状态，优化驾驶体验。如果你有任何问题或建议，可以通过 GitHub Issues 与开发团队交流。