使用Docker部署TeslaMate车辆数据监控系统

使用Docker部署TeslaMate车辆数据监控系统

teslamate 项目地址: https://gitcode.com/gh_mirrors/tes/teslamate

项目概述

TeslaMate是一款开源的Tesla车辆数据监控系统，能够记录并可视化您的Tesla车辆的各种数据，包括行驶里程、充电记录、能耗统计等。通过Docker容器化部署，可以快速搭建完整的TeslaMate环境，包含数据库、Grafana可视化界面和MQTT服务。

系统要求

在开始部署前，请确保您的环境满足以下要求：

1. Docker环境：已安装Docker和Docker Compose
2. 硬件要求：
   • 至少1GB内存
   • 建议使用SSD存储以获得更好的数据库性能
3. 网络要求：
   • 稳定的互联网连接
   • 建议仅在家庭网络内部使用，避免直接暴露到公网

详细部署步骤

1. 准备Docker Compose文件

创建一个名为docker-compose.yml的文件，内容如下：

services:
  teslamate:
    image: teslamate/teslamate:latest
    restart: always
    environment:
      - ENCRYPTION_KEY=your_secure_encryption_key
      - DATABASE_USER=teslamate
      - DATABASE_PASS=your_secure_db_password
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
      - MQTT_HOST=mosquitto
    ports:
      - 4000:4000
    volumes:
      - ./import:/opt/app/import
    cap_drop:
      - all

  database:
    image: postgres:16
    restart: always
    environment:
      - POSTGRES_USER=teslamate
      - POSTGRES_PASSWORD=your_secure_db_password
      - POSTGRES_DB=teslamate
    volumes:
      - teslamate-db:/var/lib/postgresql/data

  grafana:
    image: teslamate/grafana:latest
    restart: always
    environment:
      - DATABASE_USER=teslamate
      - DATABASE_PASS=your_secure_db_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:

2. 配置安全参数

在部署前，必须修改以下安全参数：

1. 加密密钥(ENCRYPTION_KEY)：

   • 用于加密Tesla API令牌
   • 建议使用至少32个字符的随机字符串
   • 示例生成命令：openssl rand -base64 32

2. 数据库密码：

   • 修改所有出现的your_secure_db_password
   • 建议使用强密码，包含大小写字母、数字和特殊字符

3. 启动服务

执行以下命令启动所有容器：

docker compose up -d

参数说明：

• -d表示在后台运行容器
• 首次启动可能需要几分钟时间下载镜像和初始化数据库

系统访问与配置

1. TeslaMate Web界面

访问地址：http://服务器IP:4000

1. 使用您的Tesla账户登录
2. 授权TeslaMate访问您的车辆数据
3. 系统将开始自动收集车辆数据

2. Grafana仪表板

访问地址：http://服务器IP:3000

初始登录凭证：

• 用户名：admin
• 密码：admin

首次登录后，系统会要求您修改默认密码。

数据持久化说明

通过Docker卷(volumes)确保数据持久化：

1. teslamate-db：存储PostgreSQL数据库数据
2. teslamate-grafana-data：存储Grafana配置和仪表板
3. mosquitto-conf/data：存储MQTT配置和数据

安全建议

1. 网络隔离：

   • 建议将TeslaMate部署在内网环境
   • 如需远程访问，建议使用专用网络通道或反向代理

2. 定期备份：

   • 备份Docker卷数据
   • 特别是teslamate-db卷，包含所有车辆历史数据

3. 密码管理：

   • 定期更换数据库密码
   • 不要使用默认凭证

常见问题解答

Q: 为什么我的车辆数据没有更新？ A: 请检查：

1. 服务器是否能正常访问Tesla API
2. 车辆是否处于唤醒状态
3. Docker容器是否正常运行

Q: 如何扩展存储空间？ A: 可以修改Docker卷的存储驱动或迁移到更大容量的存储设备

Q: 系统资源占用高怎么办？ A: 可以调整PostgreSQL的配置参数，或限制容器的CPU/内存使用量

通过以上步骤，您已经成功部署了TeslaMate系统，可以开始监控和分析您的Tesla车辆数据了。系统会自动记录行驶数据、充电记录等信息，并通过Grafana提供丰富的可视化分析功能。

teslamate 项目地址: https://gitcode.com/gh_mirrors/tes/teslamate