bassmaster187/teslalogger

Teslalogger 镜像文档

1. 镜像概述与主要用途

Teslalogger是一款开源的数据记录与分析工具，专注于特斯拉车辆数据的采集、存储与可视化。通过对接特斯拉官方API，实时获取车辆状态（位置、速度、电池SOC等）、充电信息（充电时长、能耗、充电量）、行驶数据（里程、能耗曲线）等关键指标，并提供Web界面进行数据展示与统计分析。其核心用途是帮助特斯拉车主全面掌握车辆使用情况，跟踪电池健康状态，优化充电策略，以及记录行驶历史数据。

2. 核心功能与特性

• 多维度数据采集：通过特斯拉API实时获取车辆实时状态（位置、速度、电池SOC、续航里程等）及历史数据（充电记录、行驶轨迹、能耗曲线）。
• 数据存储与查询：支持本地数据库存储（默认SQLite，可配置MySQL），提供历史数据按时间范围（日/周/月/年）查询功能。
• 可视化统计分析：Web界面展示关键指标图表，包括电池健康趋势、充电次数/时长统计、行驶里程分布、能耗效率分析等。
• 电池健康监控：长期跟踪电池容量变化、充电循环次数，生成电池健康报告，辅助评估电池衰减情况。
• 多车辆支持：支持添加多辆特斯拉车辆，统一管理不同车辆的数据。
• 数据导出：支持将历史数据导出为CSV格式，便于二次分析。
• 轻量化部署：基于Docker容器化设计，部署简单，占用资源低，支持Linux/Windows/macOS多平台。

3. 使用场景与适用范围

适用场景

• 个人车主日常监控：跟踪每日行驶里程、能耗情况，记录充电历史，优化充电时间与地点。
• 电池健康长期跟踪：通过长期数据采集，分析电池容量变化趋势，评估电池衰减速度。
• 车队管理：企业或个人多辆特斯拉车辆的统一数据监控，统计每辆车的使用频率、能耗成本。
• 行驶习惯分析：通过行驶轨迹、速度分布等数据，优化驾驶习惯以降低能耗。

适用范围

• 拥有特斯拉车辆（支持Model S/X/3/Y等全系车型）的个人或企业用户。
• 具备基础Docker部署能力的用户（需了解容器启动、端口映射、数据卷挂载等基础操作）。
• 需开启特斯拉账户API访问权限（部分功能可能依赖特斯拉开发者账户或第三方API服务）。

4. 使用方法与配置说明

4.1 前置条件

• 安装Docker Engine（20.10+版本）及Docker Compose（可选）。
• 拥有特斯拉账户（建议开启双因素认证，部分版本需配置API访问令牌）。
• 确保网络环境可访问特斯拉API服务（需注意地区网络限制）。

4.2 Docker部署示例

4.2.1 基于docker run部署

bash
docker run -d \
  --name teslalogger \
  -p 8888:8888 \  # Web界面端口映射
  -v /path/to/teslalogger/data:/app/data \  # 数据持久化目录（替换为本地路径）
  -e TESLA_EMAIL="your_tesla_email@example.com" \  # 特斯拉账户邮箱
  -e TESLA_PASSWORD="your_tesla_password" \  # 特斯拉账户密码
  -e REGION="eu" \  # 地区代码（na=北美, eu=欧洲, cn=中国, jp=日本等）
  -e DB_TYPE="sqlite" \  # 数据库类型（默认sqlite，可选mysql）
  teslalogger/teslalogger:latest

4.2.2 基于Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  teslalogger:
    image: docker.xuanyuan.run/teslalogger/teslalogger:latest
    container_name: teslalogger
    restart: always
    ports:
      - "8888:8888"  # Web界面访问端口
    volumes:
      - ./data:/app/data  # 本地数据持久化目录（当前目录下data文件夹）
    environment:
      - TESLA_EMAIL=your_tesla_email@example.com  # 特斯拉账户邮箱
      - TESLA_PASSWORD=your_tesla_password  # 特斯拉账户密码
      - REGION=cn  # 地区代码
      - DB_TYPE=sqlite  # 数据库类型
      - WEB_PORT=8888  # Web服务端口（需与ports映射一致）

启动容器：

bash
docker-compose up -d

4.3 配置说明

核心环境变量

数据持久化

• 容器内数据默认存储于/app/data目录（含数据库文件、日志、配置文件），需通过-v /local/path:/app/data挂载本地目录实现持久化，避免容器重启后数据丢失。

4.4 访问与使用

1. 容器启动后，通过浏览器访问 http://<主机IP>:8888 进入Web界面。
2. 首次登录需完成特斯拉账户授权（若开启双因素认证，需在页面输入验证码）。
3. 授权成功后，系统自动开始采集车辆数据，可在Web界面查看实时状态、历史统计、电池报告等模块。

5. 注意事项

• 特斯拉API存在调用频率限制，建议避免高频次手动刷新数据。
• 若使用免费特斯拉账户，部分高级数据（如实时能耗曲线）可能无法获取，需升级为特斯拉开发者账户。
• 数据存储目录需确保有足够磁盘空间（长期使用建议预留10GB以上）。
• 容器重启后，需重新验证特斯拉账户（部分版本支持自动重连，具体以镜像版本为准）。

如需更多配置细节或故障排查，建议参考 https://github.com/bassmaster187/TeslaLogger%E3%80%82