TeslaMate 完整部署教程五分钟搭建特斯拉数据监控中心【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate月底翻账单发现电费比上个月多了两百块却说不出到底哪一次充电最贵或者你想知道某次长途驾驶真实耗了多少电只能凭感觉回忆。TeslaMate 是一个自托管的特斯拉数据记录器它持续采集车辆的驾驶与充电数据存入 PostgreSQL再用 Grafana 可视化。一次 TeslaMate 部署在你家里的 NAS 或任何一台常开的 Linux 机器上只需要五分钟。① 架构一张图先看懂它怎么跑整条数据链路一句话能说清采集teslamate 容器Elixir 编写通过特斯拉官方 API 流式订阅 轮询秒级跟踪位置、电量、充电、车门等状态存储Postgres 把一切持久化drives、positions、charges 等表按时间累积展示Grafana 容器自带 20 多块预配置面板Overview、Drive Details、Charging Stats 开箱即用通知Mosquitto MQTT 代理实时发布车辆数据可接 Home Assistant、Node-RED 等。项目最低要求CPU2 核内存2GB1GB 能装官方建议 2GB存储约 20GB 可用长期数据积累系统常开设备 Docker Compose v2x86_64 / ARM64 均可网络可访问 tesla.com大陆车辆改用 tesla.cn见下文② 五分钟跑起来最小可用部署第一步生成两个密钥。一个是 API 令牌的加密密钥丢了旧令牌就解不开所以要用强随机值另一个是数据库密码openssl rand -base64 32 # 作为 ENCRYPTION_KEY openssl rand -base64 16 # 作为数据库密码第二步写docker-compose.yml。它定义了 teslamate、database、grafana、mosquitto 四个容器关键点是容器之间用服务名database、mosquitto而不是 IP 互联services: teslamate: image: teslamate/teslamate:latest environment: - ENCRYPTION_KEY${ENCRYPTION_KEY} - DATABASE_USERteslamate - DATABASE_PASS${DATABASE_PASSWORD} - DATABASE_NAMEteslamate - DATABASE_HOSTdatabase - MQTT_HOSTmosquitto ports: - 4000:4000 database: image: postgres:18-trixie environment: - POSTGRES_USERteslamate - POSTGRES_PASSWORD${DATABASE_PASSWORD} - POSTGRES_DBteslamate volumes: - teslamate-db:/var/lib/postgresql完整文件参考 website/docs/installation/docker.md里面还差 grafana对外 3000 端口、mosquitto 两个服务以及顶层 volumes 声明照抄即可。第三步启动并验证。这一步别急等个十秒再看日志docker compose up -d docker compose logs -f teslamate日志出现开始连接车辆的记录后打开http://你的IP:4000。TeslaMate 不能自己注册令牌特斯拉的授权流程变太快需要先用 tesla_auth 之类的第三方工具生成 access token 和 refresh token在登录页填入车辆数据流就接上了。Grafana 在:3000打开首次登录 admin/admin进手第一件事是改密码。③ 功能地图它到底能帮你算什么驾驶行为Drive Details 面板每次驾驶的轨迹、速度、海拔、功率回答那趟路我到底开多快、爬坡花了多少电Efficiency 面板净/毛能耗随时间变化回答冬天能耗是不是真的高了、高了多少Mileage 面板累计里程与按日统计方便盯保养周期。充电成本Charges 面板每次充进多少电、用了多少电回答这次充电值不值Charging Stats 面板单次充电成本统计支持按地点设置电价月底的账单疑问能定位到具体某一次Vampire Drain 面板停放时的电池流失回答车在家停两天白烧了多少电。远程监控States 面板车何时在线、何时睡着、何时在充电排查数据怎么断了就看它Geofences自定义家公司等地点既是按地点算充电成本的基础也方便触发自动化。④ 避坑清单部署后最常踩的 5 个坑坑一记录突然停了日志出现认证错误现象数据正常录了几天后突然断流。原因特斯拉令牌有有效期access 和 refresh token 都会过期。修复用 tesla_auth 重新生成一对令牌登录页重新填入即可已录数据不受影响。先确认原因docker compose logs -f teslamate坑二大陆用户拉不到数据现象日志里对 tesla.com 的请求超时。原因默认指向海外域名大陆车辆应走 tesla.cn 域名。修复给 teslamate 服务加一个环境变量- TESLA_API_HOSThttps://owner-api.vn.cloud.tesla.cn完整变量表见 website/docs/configuration/environment_variables.md。坑三容器反复重启内存不够现象database 或 teslamate 容器起不来、一直重启。原因官方最低要求 1GB 内存512MB 的小主机连 Postgres 迁移都跑不完。修复把主机或同机其他容器挪开腾出至少 2GB 后重新拉起docker compose up -d坑四停放期间数据缺了十几分钟现象States 面板显示白天停放有一段空白。原因轮询模式下车闲置 3 分钟后 TeslaMate 会挂起轮询、让车尽快睡觉这 15 分钟内的活动天然采不到——这是不额外唤醒车辆耗电和数据完整之间的取舍。修复确认流式连接是否稳定稳定时缺口的概率会小很多docker compose logs teslamate | grep -i stream坑五升级 latest 起不来了现象pull到最新版后服务起不来。原因大版本之间可能要求按顺序做数据库迁移跳版本会卡住。修复升级前先备份失败就把镜像 tag 改回之前可用的版本号再启动docker compose exec -T database pg_dump -U teslamate teslamate ./teslamate.bck docker compose pull docker compose up -d⑤ 玩出花样进阶玩法与二次开发玩法一Home Assistant 自动发现 到家提醒。新版支持 HA 的 MQTT 设备发现不用再手工维护几百行传感器 YAML两个环境变量就够environment: - MQTT_HOME_ASSISTANT_DISCOVERYtrue - MQTT_HOME_ASSISTANT_DISCOVERY_URLhttp://你的IP:4000/启用后电量、充电状态、门窗传感器会自己出现在 HA 里再串一个 Node-RED 流程充电完成 → 发一条消息到手机十分钟就能搭好官方文档带现成的 Telegram 示例流程。可用 topic 全量清单在 website/docs/integrations/mqtt.md。玩法二自己的年度能耗报告。内置的 20 多块面板 JSON 全部开放在 grafana/dashboards/ 目录可以直接改也可以绕过面板直接在 Postgres 里写查询SELECT date_trunc(month, start_date) AS month, round(sum(energy_used)::numeric, 1) AS used_kwh FROM charges WHERE start_date now() - interval 1 year GROUP BY 1 ORDER BY 1;把结果丢进自建 Grafana 面板就是你要的年度能耗报告。积累几个月后打开 Visited 面板一整年的驾驶轨迹会画成一张地图这大概是这套系统最有成就感的画面。⑥ 运维备忘更新、备份与数据安全每秒都在往 Postgres 里写数据这个卷是你唯一的硬资产升级前务必先备份# 备份可加 crontab-T 参数是必须的 docker compose exec -T database pg_dump -U teslamate teslamate ./teslamate.bck # 升级 docker compose pull docker compose up -d再提醒一句4000Web和 3000Grafana两个端口默认只绑内网。要远程访问就走 VPN / Tailscale 或加反代别把登录页直接暴露公网——那里面存着你的特斯拉令牌。⑦ 写在最后TeslaMate 把车变成了一份持续累积的数据资产驾驶、充电、休眠状态全都有据可查而部署成本只是一个 compose 文件。按第二节的五分钟流程先把数据接上一周后你的 Grafana 会开始回答那些凭感觉回答不了的问题。更多环境变量、导入历史数据、NixOS 安装的细节去官方文档 docs.teslamate.org 和开源社区里找。【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TeslaMate 完整部署教程：五分钟搭建特斯拉数据监控中心
TeslaMate 完整部署教程五分钟搭建特斯拉数据监控中心【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate月底翻账单发现电费比上个月多了两百块却说不出到底哪一次充电最贵或者你想知道某次长途驾驶真实耗了多少电只能凭感觉回忆。TeslaMate 是一个自托管的特斯拉数据记录器它持续采集车辆的驾驶与充电数据存入 PostgreSQL再用 Grafana 可视化。一次 TeslaMate 部署在你家里的 NAS 或任何一台常开的 Linux 机器上只需要五分钟。① 架构一张图先看懂它怎么跑整条数据链路一句话能说清采集teslamate 容器Elixir 编写通过特斯拉官方 API 流式订阅 轮询秒级跟踪位置、电量、充电、车门等状态存储Postgres 把一切持久化drives、positions、charges 等表按时间累积展示Grafana 容器自带 20 多块预配置面板Overview、Drive Details、Charging Stats 开箱即用通知Mosquitto MQTT 代理实时发布车辆数据可接 Home Assistant、Node-RED 等。项目最低要求CPU2 核内存2GB1GB 能装官方建议 2GB存储约 20GB 可用长期数据积累系统常开设备 Docker Compose v2x86_64 / ARM64 均可网络可访问 tesla.com大陆车辆改用 tesla.cn见下文② 五分钟跑起来最小可用部署第一步生成两个密钥。一个是 API 令牌的加密密钥丢了旧令牌就解不开所以要用强随机值另一个是数据库密码openssl rand -base64 32 # 作为 ENCRYPTION_KEY openssl rand -base64 16 # 作为数据库密码第二步写docker-compose.yml。它定义了 teslamate、database、grafana、mosquitto 四个容器关键点是容器之间用服务名database、mosquitto而不是 IP 互联services: teslamate: image: teslamate/teslamate:latest environment: - ENCRYPTION_KEY${ENCRYPTION_KEY} - DATABASE_USERteslamate - DATABASE_PASS${DATABASE_PASSWORD} - DATABASE_NAMEteslamate - DATABASE_HOSTdatabase - MQTT_HOSTmosquitto ports: - 4000:4000 database: image: postgres:18-trixie environment: - POSTGRES_USERteslamate - POSTGRES_PASSWORD${DATABASE_PASSWORD} - POSTGRES_DBteslamate volumes: - teslamate-db:/var/lib/postgresql完整文件参考 website/docs/installation/docker.md里面还差 grafana对外 3000 端口、mosquitto 两个服务以及顶层 volumes 声明照抄即可。第三步启动并验证。这一步别急等个十秒再看日志docker compose up -d docker compose logs -f teslamate日志出现开始连接车辆的记录后打开http://你的IP:4000。TeslaMate 不能自己注册令牌特斯拉的授权流程变太快需要先用 tesla_auth 之类的第三方工具生成 access token 和 refresh token在登录页填入车辆数据流就接上了。Grafana 在:3000打开首次登录 admin/admin进手第一件事是改密码。③ 功能地图它到底能帮你算什么驾驶行为Drive Details 面板每次驾驶的轨迹、速度、海拔、功率回答那趟路我到底开多快、爬坡花了多少电Efficiency 面板净/毛能耗随时间变化回答冬天能耗是不是真的高了、高了多少Mileage 面板累计里程与按日统计方便盯保养周期。充电成本Charges 面板每次充进多少电、用了多少电回答这次充电值不值Charging Stats 面板单次充电成本统计支持按地点设置电价月底的账单疑问能定位到具体某一次Vampire Drain 面板停放时的电池流失回答车在家停两天白烧了多少电。远程监控States 面板车何时在线、何时睡着、何时在充电排查数据怎么断了就看它Geofences自定义家公司等地点既是按地点算充电成本的基础也方便触发自动化。④ 避坑清单部署后最常踩的 5 个坑坑一记录突然停了日志出现认证错误现象数据正常录了几天后突然断流。原因特斯拉令牌有有效期access 和 refresh token 都会过期。修复用 tesla_auth 重新生成一对令牌登录页重新填入即可已录数据不受影响。先确认原因docker compose logs -f teslamate坑二大陆用户拉不到数据现象日志里对 tesla.com 的请求超时。原因默认指向海外域名大陆车辆应走 tesla.cn 域名。修复给 teslamate 服务加一个环境变量- TESLA_API_HOSThttps://owner-api.vn.cloud.tesla.cn完整变量表见 website/docs/configuration/environment_variables.md。坑三容器反复重启内存不够现象database 或 teslamate 容器起不来、一直重启。原因官方最低要求 1GB 内存512MB 的小主机连 Postgres 迁移都跑不完。修复把主机或同机其他容器挪开腾出至少 2GB 后重新拉起docker compose up -d坑四停放期间数据缺了十几分钟现象States 面板显示白天停放有一段空白。原因轮询模式下车闲置 3 分钟后 TeslaMate 会挂起轮询、让车尽快睡觉这 15 分钟内的活动天然采不到——这是不额外唤醒车辆耗电和数据完整之间的取舍。修复确认流式连接是否稳定稳定时缺口的概率会小很多docker compose logs teslamate | grep -i stream坑五升级 latest 起不来了现象pull到最新版后服务起不来。原因大版本之间可能要求按顺序做数据库迁移跳版本会卡住。修复升级前先备份失败就把镜像 tag 改回之前可用的版本号再启动docker compose exec -T database pg_dump -U teslamate teslamate ./teslamate.bck docker compose pull docker compose up -d⑤ 玩出花样进阶玩法与二次开发玩法一Home Assistant 自动发现 到家提醒。新版支持 HA 的 MQTT 设备发现不用再手工维护几百行传感器 YAML两个环境变量就够environment: - MQTT_HOME_ASSISTANT_DISCOVERYtrue - MQTT_HOME_ASSISTANT_DISCOVERY_URLhttp://你的IP:4000/启用后电量、充电状态、门窗传感器会自己出现在 HA 里再串一个 Node-RED 流程充电完成 → 发一条消息到手机十分钟就能搭好官方文档带现成的 Telegram 示例流程。可用 topic 全量清单在 website/docs/integrations/mqtt.md。玩法二自己的年度能耗报告。内置的 20 多块面板 JSON 全部开放在 grafana/dashboards/ 目录可以直接改也可以绕过面板直接在 Postgres 里写查询SELECT date_trunc(month, start_date) AS month, round(sum(energy_used)::numeric, 1) AS used_kwh FROM charges WHERE start_date now() - interval 1 year GROUP BY 1 ORDER BY 1;把结果丢进自建 Grafana 面板就是你要的年度能耗报告。积累几个月后打开 Visited 面板一整年的驾驶轨迹会画成一张地图这大概是这套系统最有成就感的画面。⑥ 运维备忘更新、备份与数据安全每秒都在往 Postgres 里写数据这个卷是你唯一的硬资产升级前务必先备份# 备份可加 crontab-T 参数是必须的 docker compose exec -T database pg_dump -U teslamate teslamate ./teslamate.bck # 升级 docker compose pull docker compose up -d再提醒一句4000Web和 3000Grafana两个端口默认只绑内网。要远程访问就走 VPN / Tailscale 或加反代别把登录页直接暴露公网——那里面存着你的特斯拉令牌。⑦ 写在最后TeslaMate 把车变成了一份持续累积的数据资产驾驶、充电、休眠状态全都有据可查而部署成本只是一个 compose 文件。按第二节的五分钟流程先把数据接上一周后你的 Grafana 会开始回答那些凭感觉回答不了的问题。更多环境变量、导入历史数据、NixOS 安装的细节去官方文档 docs.teslamate.org 和开源社区里找。【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考