黑海洋 - IT技术知识库

搭建特斯拉Tesla可视化数据记录器Grafana

发布时间: 2023-12-31 分类: Web开发/Code 热度: 3338

今天就来分享一个和特斯拉相关的 Docker 项目，一个强大的、自托管的特斯拉数据记录器 ——TeslaMate，可以全面分析特斯拉充电、续航、行驶里程等等的情况。

  • 使用 Elixir 编写
  • 数据存储在 Postgres 数据库中
  • 使用 Grafana 进行可视化和数据分析
  • 车辆数据发布到本地 MQTT 代理

网页端：

829a1f5b75e0e82e026a2c5f67c0ec49.png

驾驶数据详情：

5763c0bf79922a36bc005dfbf49d1690.png

b246c9cdef53da8a152a56b5a3e779ba.png

充电统计数据

01f7953f0f87c7707b8fb2aa6540ba90.png

驾驶统计数据

94cc31922b5ce267811e2c29fcb394a1.png

驾驶情况

b08f4a75afa2477735c2b2094f32ec62.png

能耗

2491b944d6328bace746966bf947ea3f.png

车辆状态

afb3ba85c86df96f8f6b8ebc67e18ec2.png

充电情况

53e9d099e54c3f6c4a1f9af89f692c77.png

充电记录

dd4a3f3c1f04524e66a86da58789f8cb.png

电池静置耗电（Vampire Drain）情况

8cff260d1b63f81f866d5f05965d4832.png

预计续航里程

ab38a6b4d2eec42ada288fbf913efd01.png

概览

df297890234e1dca75abc76117fe123b.png

更新情况

6cdee47954d7a8002d2014b2ae2caf20.png

终身驾驶地图

ec1e70e1bf6b7f438b24463a08a937b9.png

开过的地方

7a2578721cf04147b1cf0e84510553e5.png

2. 功能

仪表板

  • 驾驶和充电报告
  • 驾驶效率报告
  • 消耗（净 / 毛）
  • 充电能量增加与能量使用
  • 电池静置耗电
  • 预测的 100% 电量范围（电池退化）
  • 充电统计
  • 驾驶统计
  • 已安装更新的历史记录
  • 查看您的汽车何时在线或休眠
  • 终身驾驶地图
  • 访问过的地址

通用

  • 高精度驾驶数据记录
  • 无额外的电池静置耗电：汽车会尽快进入休眠状态
  • 自动地址查找
  • 易于集成到家庭助手（通过 MQTT）
  • 易于集成到 Node-Red 和 Telegram（通过 MQTT）
  • 地理围栏功能，可创建自定义位置
  • 支持每个特斯拉账户多辆车
  • 充电成本跟踪
  • 从 TeslaFi 和 tesla-apiscraper 导入

3. 相关地址

官方 GitHub 地址：https://github.com/teslamate-org/teslamate

官方文档：https://docs.teslamate.org/docs/installation/docker

4. 搭建环境

  • 服务器：咕咕这边用的腾讯轻量应用服务器 ，（最好选 非大陆的，而且线路还不错的机器）如果是小白刚开始玩的话，也可以选择 Racknerd 的高性价比服务器（注意地区选美国西部城市的）或者 莱卡云的香港或者美国 CN2 GIA

  • 系统：Debian 11 （DD 脚本 非必需 DD，用原来的系统也 OK，之后教程都是用 Debian 或者 Ubuntu 搭建～）

  • 安装好 Docker、Docker-compose（相关脚本）

  • 【非必需但建议】域名一枚，并做好解析到服务器上（域名购买、域名解析 视频教程）

  • 【非必需】提前安装好宝塔面板海外版本 aapanel，并安装好 Nginx（安装地址）

  • 【非必需本教程选用】安装好 Nginx Proxy Manager（相关教程）

服务器建议：1 核 1G 即可

5. 搭建视频

5.1 YouTube

视频地址：https://youtu.be/epjibyUPw3A

5.2 哔哩哔哩

哔哩哔哩：https://www.bilibili.com/video/BV1Fc411C7K7/

6. 搭建方式

如果你不是用的腾讯云的轻量应用服务器，可以直接跳到 6.1 部分。

安装系统（腾讯云轻量应用服务器）

e59713fba8726d3cb55ae11bca83fe3c.png

腾讯云轻量服务器最大的特点就是 “轻量”，相比 CVM，更适合小白上手，这边我们之间选择 Docker 基础镜像，就可以省去后面安装 Docker 的步骤（如果你非要用国内的服务器，这边装的 Docker 镜像还会帮你配置好国内镜像源，让你加速访问 docker 镜像资源）不建议用国内的 。

登陆（腾讯云轻量应用服务器）

2722040ee311eb4a9ebf2a4945bf38f4.pngc0b5d360053746c4095d592967ee401f.pnge0ba858f021b846ad0abc27acf5008c2.png

6.1 安装 Docker 与 Nginx Proxy Manager

可以直接参考这篇内容：

https://blog.laoda.de/archives/nginxproxymanager/

6.2 创建安装目录

创建一下安装的目录：

BASH
 
sudo -i

mkdir -p /root/data/docker_data/teslamate

cd /root/data/docker_data/teslamate

vim docker-compose.yml

英文输入法下，按 i

YAML
 
version: "3"

services:
 teslamate:
 image: teslamate/teslamate:latest
 restart: always
 environment:
 - ENCRYPTION_KEY=G1BgNWsb2B9U5owHrntD7g7S8hrAnTf #用一个安全的密钥来加密你的特斯拉API令牌
 - DATABASE_USER=teslamate
 - DATABASE_PASS=Zej19BtTE3Ydw12sgr1pdLQA9c #请输入您的安全数据库密码！
 - DATABASE_NAME=teslamate
 - DATABASE_HOST=database
 - MQTT_HOST=mosquitto
 - TZ=Asia/Shanghai
 ports:
 - 4000:4000
 volumes:
 - ./import:/opt/app/import
 cap_drop:
 - all

 database:
 image: postgres:15
 restart: always
 environment:
 - POSTGRES_USER=teslamate
 - POSTGRES_PASSWORD=Zej19BtTE3Ydw12sgr1pdLQA9c #请输入您的安全数据库密码！
 - POSTGRES_DB=teslamate
 volumes:
 - ./teslamate-db:/var/lib/postgresql/data

 grafana:
 image: teslamate/grafana:latest
 restart: always
 environment:
 - DATABASE_USER=teslamate
 - DATABASE_PASS=Zej19BtTE3Ydw12sgr1pdLQA9c #请输入您的安全数据库密码！
 - 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
 # ports:
 # - 1883:1883
 volumes:
 - ./mosquitto-conf:/mosquitto/config
 - ./mosquitto-data:/mosquitto/data

volumes:
 teslamate-grafana-data:

简单说一下：

  • ENCRYPTION_KEY 和 DATABASE_PASS 以及 POSTGRES_PASSWORD 大家记得自己更改密码（可以用之前分享过的 Vaultwarden 来生成，更方便一些～）

d4be206fbee7cbfa6cfdf83e922eaee6.png

推荐阅读：【好玩儿的 Docker 项目】2023 重制版本！10 分钟搭建一个专属的密码管理工具 ——Vaultwarden

注意，密码的 = 后面不要有空格！

切换成英文输入法，修改好之后，按一下 esc，然后 :wq 保存退出。

6.3 打开服务器防火墙（非必需）并访问网页

打开防火墙的端口 4000

举例，腾讯云打开方法如下（部分服务商没有自带的面板防火墙，就不用这步操作了）：

image-20220630215240864image-20220630220546335

类似图中的，这边我们填 4000，示例填 teslamate ，确定即可（如果你在 docker-compose 文件里换了 9009，这边就需要填 9009，以此类推）

3ab1cbc57794569ca3ad61cb983871a1.png

此外，我们还要添加 3000，因为要用 Grafana 可视化我们的数据

1da0f0c0253f4dec31f492e38be10dcd.png

查看端口是否被占用（以 4000 为例），输入：

BASH
 
lsof -i:4000 #查看 4000 端口是否被占用，如果被占用，重新自定义一个端口

如果啥也没出现，表示端口未被占用，我们可以继续下面的操作了～

如果出现：

BASH
 
-bash: lsof: command not found

运行：

BASH
 
apt install lsof #安装 lsof

如果端口没有被占用（被占用了就修改一下端口，比如改成 4001，注意 docker 命令行里和防火墙都要改）

理论上我们就可以输入 http://ip:4000 和 http://ip:3000 访问了。

其中 http://ip:3000 默认的登陆账号和密码均为 admin，首次登陆之后会要求你重新设置一个密码。

如果你是部署在内网环境中（比如家里的 NAS 或者树莓派上），那就可以看是玩耍了！

不过这边我们是部署在服务器上的，所以我们需要再搞一个域名，给俩网页都做 https，并且要给 http://ip:4000 做一个简单的 web 验证，让我们的访问更加安全！

这边我们就用到了反向代理这个概念！（不知道的可以看一下这篇文章：【Docker 系列】一个反向代理神器 ——Nginx Proxy Manager）

做反向代理前，你需要一个域名！

namesilo 上面 xyz 后缀的域名一年就 7 块钱，可以年抛。（冷知识，namesilo 上 6 位数字的 xyz 续费永远都是 0.99 美元 = =）

如果想要长期使用，还是建议买 com 后缀的域名，更加正规一些，可以输入 laodade 来获得 1 美元的优惠（不知道现在还有没有）

namesilo 自带隐私保护，咕咕一直在用这家，价格也是这些注册商里面比较低的，关键是他家不像其他家域名注册商，没有七七八八的套路！（就是后台界面有些丑古老 = =）

【域名购买】Namesilo 优惠码和域名解析教程（附带服务器购买推荐和注意事项）

我们接着往下看！

7. 反向代理

7.1 利用 Nginx Proxy Manager

在添加反向代理之前，确保你已经完成了域名解析，不会的可以看这个：域名一枚，并做好解析到服务器上（域名购买、域名解析 视频教程）

image-20221016140213282

之后，登陆 Nginx Proxy Manager（不会的看这个：安装 Nginx Proxy Manager（相关教程））

注意：

Nginx Proxy Manager（以下简称 NPM）会用到 80、443 端口，所以本机不能占用（比如原来就有 Nginx）

直接丢几张图（这边以 4000 这个端口为例子，3000 也是一样做一遍）：

c8d15ba5227c2308a0518b99afb9663d.pngfae45bafe2e8deb8cdec4d0581b1bd9d.png2c42648f904d6a6bb84a5f25c2e463c0.png354981f64863e9c5804a3e3a6f2e1df0.png

注意填写对应的 域名、IP 和 端口，按文章来的话，应该是 4000

IP 填写：

如果 Nginx Proxy Manager 和 teslamate 在同一台服务器上，可以在终端输入：

BASH
 
ip addr show docker0

查看对应的 Docker 容器内部 IP。

否则直接填 teslamate 所在的服务器 IP 就行。

然后你就可以用诸如：tesla.gugu.ovh 和 grafana.gugu.ovh 来访问了。

58a2d70da026d666d396316b36f85612.pngcdb79be54f9eaf3772589cfe539c075c.png

7.2 利用宝塔面板

发现还是有不少小伙伴习惯用宝塔面板，这边也贴一个宝塔面板的反代配置：

直接新建一个站点，不要数据库，不要 php，纯静态即可。

然后打开下面的配置，修改 Nginx 的配置。

image-20220819150345725image-20220819150542867

代码如下：

NGINX
 
location / {
 proxy_pass http://127.0.0.1:4000/; # 注意改成你实际使用的端口
 rewrite ^/(.*)$ /$1 break;
 proxy_redirect off;
 proxy_set_header Host $host;
 proxy_set_header X-Forwarded-Proto $scheme;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header Upgrade-Insecure-Requests 1;
 proxy_set_header X-Forwarded-Proto https;
}

此方法对 90% 的反向代理都能生效，然后就可以用域名来安装访问了。

有同学可能会问，为什么不直接用宝塔自带的反向代理功能。

image-20220819150730128

也可以，不过咕咕自己之前遇到过当有多个网站需要反代的时候，在这边设置会报错的情况 = =

所以后来就不用了，直接用上面的方法来操作了。

8. 使用教程

建议参考视频，或者自己尝试一下。

后台：

444d43635106faa01c51e9798dc17932.png

如果发现右上角没有控制台，可以在设置里面填上 Grafana 的地址

image-20231214154120730

设置总览：

f4fd8b65732646d43714cf7d4fbc8428.png

89527d819701cc5574a2403da8a051e6.png

进入休眠模式，可以省电，就是那个电池静置耗电（Vampire Drain）情况。

8.1 更新 teslamate

项目最近更新比较频繁，建议大家及时跟着更新。

YAML
 
cd /root/data/docker_data/teslamate

docker-compose pull

docker-compose up -d # 请不要使用 docker-compose stop 来停止容器，因为这么做需要额外的时间等待容器停止；docker-compose up -d 直接升级容器时会自动停止并立刻重建新的容器，完全没有必要浪费那些时间。

docker image prune # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

提示：

BASH
 
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]

输入 y

利用 Docker 搭建的应用，更新非常容易～

8.2 卸载 teslamate

同样进入安装页面，先停止所有容器。

BASH
 
cd /root/data/docker_data/teslamate

docker-compose down

cd ..

rm -rf /root/data/docker_data/teslamate # 完全删除

可以卸载得很干净。

8.3 获取 Tesla 的令牌

第一次登陆之后，你会发现需要一个令牌和刷新令牌。

58a2d70da026d666d396316b36f85612.png

这个需要你下载对应的 app 然后登陆你的特斯拉账号来获取。

1a87add0ac09869864559cdcb5d2f1e2.png

文档地址：https://docs.teslamate.org/docs/faq/#how-to-generate-your-own-tokens

这边我是 Mac，可以在 App Store 下载：

2cc34ccdeb04ad1c13d8fc8ef062d1d1.png

如果你是 Windows 或者 Linux 的用户，可以在这边下载：https://github.com/adriankumpf/tesla_auth/releases

对应的 app

2751172e021774828a8715dc42d16639.png

9. 常见问题及注意点

9.1 添加简单的网页验证

当你第一次成功用令牌登陆网页之后，你会发现之后你再次输入这个域名，默认是直接登陆的状态，这个时候就需要我们来给这个网页做一个 HTTP Basic Auth，就是一个简单的登陆验证了。

这边我们还是用 NPM 来举例子。

7d66c06ae2c10ef0cea579d4ec171a1c.png5d828982235c0ccbeba1c4080f2c84e2.png

这一步的名字可以随便取，这边我以 tesla 为例子：

9b36a3d40aadf524ed3442724b7f5aed.png

这一步先点一下 add，再来设置一个用户和密码：

b5cf8e0149ec6068a4c5139535dd631a.png

然后点击保存即可

81b5c217be3a8da09786dd36cac8b799.png

这个时候会出现这个：

0f83a01af85c046d2752444c22af5185.png

回到这边：

7f305b2f763f8ad3ba867f38c57fe9ad.png

再这边下拉选项中选择 tesla

725ac81d79df7ec87356d1dd1a4d27e6.png

再点击保存即可！

418d84873f34728e9ebb9c196069bef9.png

这样当你登陆的时候就会出现一个登陆提示框：

be69fc171ea27285ad92189cc3c30657.png

只有输入了正确的账号和密码才能登陆了。

如果输错，会提示：

12f3129ebe1c040002988cc83a6bfaea.png

10. FAQ（常见问题解答）

会不会频繁的唤醒车机呢？导致耗电增多？

答：用的官方 streaming API，不会无故唤醒和耗电，放心使用

为什么 Grafana 中没有显示消耗值？

特斯拉 API 没有返回行程的消耗值。为了能够显示值，TeslaMate 会根据记录的（充电）数据估算消耗。在首次估算可以显示之前至少需要两次充电会话。充电会话必须超过 10 分钟且电量状态少于 95%。每次未来的充电会话都会轻微提高估算的准确性，这会追溯应用到所有数据。

车辆没有进入睡眠模式

带有媒体控制单元版本 1（MCU1）的汽车需要某些设置才能入睡。在 2018 年 3 月之前生产的 Model S 和 Model X 配备了 MCU1 单元，这也可以从软件 -> 额外车辆信息中查看。如果 “娱乐处理器” 是 “NVIDIA Tegra”，则车辆配备了 MCU1。

启用 MCU1 的睡眠模式所需的设置是：

‘显示’ -> ‘节能’ -> 开启
‘显示’ -> ‘始终连接’ -> 未勾选
‘安全与保安’ -> ‘车舱过热保护’ -> 关闭
通过这些设置，MCU1 车辆应在不活动约 15 分钟后入睡。

注意！如果您同时使用其他数据记录器，如 TeslaFi，睡眠尝试可能会失败，因为其他数据记录器将使汽车保持唤醒状态。特别是调用车辆数据 API 将重置汽车的不活动计时器。

11. 其他项目

基于这个 TeslaMate，还有其他很多有意思的项目，有兴趣的小伙伴可以自行研究一下：https://docs.teslamate.org/docs/projects

其中一个 TeslaMate_Telegram_Bot 应该是结合 telegram 的机器人推送特斯拉系统更新的一个项目，有机会打算试试看。

12. 结尾

祝大家用得开心，有问题可以去 GitHub 提 Issues，也可以在评论区互相交流探讨。

同时，有能力给项目做贡献的同学，也欢迎积极加入到 项目 中来，贡献自己的一份力量！

最后，感谢开发人员们的辛苦付出，让我们能用到这么优秀的项目！

参考资料

官方 GitHub 地址：https://github.com/teslamate-org/teslamate

官方文档：https://docs.teslamate.org/docs/installation/docker

请在下方留下您的评论.加入TG吹水群