jpenninkhof/tesla-apiscraper

Tesla API Scraper 镜像说明

镜像概述

这是一个自托管的API刮板工具，用于通过Tesla Owner API拉取车辆遥测数据（如驾驶状态、充电信息、续航里程等），存储至InfluxDB数据库，并通过Grafana仪表板实现数据可视化。支持Model S、X和3车型，无需将车辆密钥交给未知第三方，可部署在Linux服务器或树莓派等设备上。

核心功能

• 多车辆支持: 可处理单个Tesla账户下的多辆汽车数据
• 睡眠模式优化: 车辆停止充电和驾驶后自动进入睡眠状态，监测会在60秒内响应车辆使用
• 内置控制API: 提供API接口，可通过Android应用或自定义实现启动/停止/恢复数据抓取

使用场景

• 自托管监控Tesla车辆的实时状态与历史统计数据
• 通过Grafana仪表板直观展示驾驶、充电、续航等关键指标
• 集成到自定义应用或Android控制工具中管理数据抓取任务

配置说明

基础环境安装（非Docker方式）

1. 安装Python3依赖:

bash
sudo apt install python3 python3-pathlib python3-pip python3-influxdb

2. 部署InfluxDB: 参考官方文档安装InfluxDB v1.7后，创建数据库：

bash
influx
> create database tesla

3. 部署Grafana及插件:

bash
# 安装Grafana（参考官方文档）
apt install npm
cd /var/lib/grafana/plugins
git clone https://github.com/lephisto/grafana-trackmap-panel
cd grafana-trackmap-panel && git checkout v2.0.4-teslascraper && npm install && npm run build
grafana-cli plugins install natel-discrete-panel
systemctl restart grafana-server.service

4. 导入项目仓库中的Grafana仪表板JSON文件。

Docker部署（推荐）

独立运行（已弃用）

bash
mkdir -p /opt/apiscraper/influxdb
docker build ./ -t tesla-apiscraper
docker run -p 3000:3000 -p 8023:8023 -v /opt/apiscraper/influxdb:/var/lib/influxdb -e "TESLA_USERNAME=<你的Tesla邮箱>" -e "TESLA_PASSWORD=<你的Tesla密码>" tesla-apiscraper:latest

Docker Compose方式

1. 配置准备:

bash
cp config.py.compose config.py
nano config.py # 填写Tesla账户信息
touch apiscraper.log # 创建空日志文件

2. 创建持久化目录:

bash
sudo mkdir -p /opt/apiscraper/influxdb
sudo mkdir -p /opt/apiscraper/grafana
sudo chown 472 /opt/apiscraper/grafana

3. 启动服务:

bash
./dashboard2docker.sh
docker-compose up -d # 后台运行
# 停止服务
docker-compose down
# 更新重建
docker-compose pull
docker-compose build --build-arg CACHEBUST=$(date +%s) apiscraper
docker-compose up --force-recreate --build

访问Grafana：http://localhost:3000

API使用（Android应用或自定义集成）

在config.py中启用API：

python
a_enableapi = True
a_apikey = "足够长的随机字符串"
a_apiport = 8023

示例curl命令：

bash
# 获取抓取状态
curl --header "Content-type: application/json" --header "apikey: <你的API密钥>" http://127.0.0.1:8023/state
# 启动抓取
curl -X POST --header "Content-type: application/json" --header "apikey: <你的API密钥>" http://127.0.0.1:8023/switch --data '{"command":"scrape","value":""}'
# 停止抓取
curl -X POST --header "Content-type: application/json" --header "apikey: <你的API密钥>" http://127.0.0.1:8023/switch --data '{"command":"scrape","value":"False"}'

注意事项

• 美国用户可在Grafana仪表板设置中调整单位（英里/公里）
• 树莓派用户需安装最新版Docker（参考官方脚本）
• 使用本工具需自行承担风险，Tesla未官方支持该API的第三方使用
• 建议对InfluxDB和API接口配置认证或防火墙规则以保障安全