TeslaMate 本地部署实操把特斯拉的每一度电和每一公里都记下来【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate特斯拉 App 里的充电记录只保留最近几次电池容量、历史能耗曲线这些数据你根本翻不到。TeslaMate 解决的就是这个问题它是一个自部署的数据记录器持续从特斯拉官方 API 拉取车辆状态把每次充电、每段驾驶都写进本地 PostgreSQL 数据库数据库装在你自己机器上不经过任何第三方服务器再配合 Grafana 仪表盘做可视化。核心能力一览高精度记录每段驾驶的能耗与路线每次充电的成本与电量变化电池容量衰减曲线通过 MQTT 协议向本地推送车辆状态支持同一账号下多辆车 从零到一部署与首次连接用 Docker 部署最省事要求机器常驻在线、内存至少 1 GB建议 2 GB并且能访问 tesla.com 的 API。官方 Docker 安装文档见 website/docs/installation/docker.md。按文档创建一个docker-compose.yml里面包含 teslamate、databasePostgreSQL、grafana、mosquittoMQTT 消息 broker四个服务记得把ENCRYPTION_KEY和数据库密码换成自己的随机字符串启动所有容器docker compose up -d按 生成令牌文档 为特斯拉账号生成一对 access token 和 refresh tokenTeslaMate 本身不提供生成入口需要按文档脚本操作浏览器打开http://服务器IP:4000在登录页粘贴两个 token登录 Grafana访问http://服务器IP:3000默认账号密码均为admin首次登录后立即改掉密码提示token 过期或车型不被 owners API 支持时登录会卡住先确认 token 能用再排查网络问题。 场景实战这三个仪表盘最值得先看日常通勤看什么打开 Overview 仪表盘你会看到当前电量、续航里程、车辆状态在线/休眠/充电和最近的充电、驾驶摘要。它的作用是快速确认车现在什么状态不用打开特斯拉 App 唤醒车辆。Drives 仪表盘则按次列出每段驾驶的距离、净能耗和平均速度通勤能耗异常偏高的某一天会直接显形通常对应暴力驾驶或长时间开暖风。长途前的电池体检Battery Health 仪表盘画出两条关键曲线电池可用容量随时间的变化以及 Projected Range基于容量推算的续航衰减横轴按时间走纵轴是容量或里程。如果曲线长期平稳说明衰减在正常范围如果某段时间斜率突然变陡回想一下那段时间是否长期把电量放在 100% 停放。长途出行前用它确认当前实际可用电量比 App 里的估算值更可靠因为它基于你自己记录的完整数据。充电习惯复盘Charge Details 和 Charging Stats 仪表盘回答两类问题单次充电充了多少电、花了多少钱、耗时多久以及一段时间内家充和超充的比例、总成本和充电速率分布。数据在本地数据库里按charges表存储成本计算支持按地点设置不同电价通过地理围栏 Geofence 关联在 Web 界面的 Settings 页面维护。复盘一个月后你大概率能发现超充占比比想象中高把超充目标电量调低一点就能省下不少。 进阶方向与生态联动数据备份数据库是唯一的数据源官方给的备份命令是docker compose exec -T database pg_dump -U teslamate teslamate ./teslamate.bck配一条 crontab 每周执行即可注意备份文件要同步到另一台机器或异地存储。详见 website/docs/maintenance/backup.mdx。智能家居联动TeslaMate 把所有车辆状态发布到teslamate/cars/$car_id/...这类 MQTT topicHome Assistant 可以直接订阅实现到家自动开门库低电量推送提醒这类联动没有 Home Assistant 也能通过 Node-RED 接 Telegram 收通知两种接法的完整说明在 website/docs/integrations/mqtt.md。⚠️ 容易踩的坑端口冲突Web 界面默认 4000 端口Grafana 默认 3000被占用时在 docker-compose.yml 中改映射即可环境变量清单见 website/docs/configuration/environment_variables.mdENCRYPTION_KEY 必须固定这个密钥用于加密 API token容器重建时换了密钥会导致已保存的 token 全部失效公网暴露风险官方明确不建议把实例直接暴露到互联网token 泄露风险很高远程访问请用 Tailscale、Cloudflare Tunnel 这类安全通道只认官方版本README 里安全警告提到存在冒名 TeslaMate 的恶意 fork 和假 App会窃取特斯拉账号凭据只从官方仓库获取Grafana 默认密码admin/admin只是初始值第一次登录后必须修改先按部署章节把四个容器跑起来等 Overview 里出现第一条驾驶记录再回来按自己的习惯调 Grafana 仪表盘和成本设置。【免费下载链接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]项目地址: https://gitcode.com/GitHub_Trending/te/teslamate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考